source.txt

一个java编的用来管理卡片信息的小程序

SOURCE CODE
-----------
Source code is only included in the JCardsX.X-src.zip download.

As JCards is distributed under the GPL, source code can be downloaded, modified
and exchanged with no restrictions as long as modifications are also made
available for free.

LIBRARIES
---------
To overcome some of the limitations in the AWT I have used a few classes from
Sitraka's JClass BWT* which is free software (although not GPL'd). File storage
is taken care of by using NanoXML. Encryption is provided by libraries from the
Legion of the Bouncy Castle. See the README file for URL's.

The CSVParser and PostfixCalculator are part of the NRSUtils package and can be
obtained from http://www.nsydenham.net/

* JClass BWT is no longer supported by Sitraka and is not available for
  download.

CONSTRAINTS
-----------
The code has been optimised to run on handheld devices with limited memory and
processing power; I have therefore tried to minimise the number of Objects in
use (particularly event listeners) and coded to the PersonalJava 1.2
specification.

Because JCards is intended to be used on a Zaurus I have decided to pack all
the required JCards source files and external libraries into the one jar file
to make installation as easy as possible. Therefore, when compiling the source
code there is no reference to external jar files as the required classes have
already been extracted to the classes directory.

COMPILING
---------
Download and install a copy of ant (http://ant.apache.org/) to your development
machine.
Unzip the JCards/bin/jcards.jar file to JCards/classes.
At a shell prompt type:
    'ant' or 'ant compile' to compile the source
    'ant jar' to update the jar file in the bin directory

ICONS
-----
I would have preferred to use PNG icons due to the Unisys patent on the LZW
compression algorithm used by GIF, but there seems to be a JDK1.1 display
problem with PNG graphics when they are obscured by another window and then
redisplayed.