readme

用java实现的通用解释器

This is a Java port of the GNU getopt functions based on the versions 
contained in glibc 2.0.6.  I have attempted to keep the functionality 
and programmer's interface as faithful to the original as possible.
However, due to differences between Java and C, some minor changes
has to me made.  (Given the obtuse interface in the clib version, 
perhaps some major changes should have been made).  This should not 
affect the way options appear to be parsed to the end user of program 
that uses this Java getopt.  The use of these classes are completely 
documented in the javadoc comments, so I will not repeat that info here. 

Note that since these objects are part of a package called "gnu.getopt", 
they need to be in a subdirectory called gnu/getopt somewhere in your 
CLASSPATH.  This includes the "MessagesBundle" files.

I am not aware of any bugs.  If you find one though, please send email 
to me at [e-mail].  The more detailed a bug report the better. 
Bug fixes are also welcome at the same address.  Please reference
release number "1.0.8".  If you use this code, it would be helpful
if you let me know so that I can let you know if anything changes or
if any major bugs have been found/fixed.

I have included a Makefile for compiling the code. If you do not have
access to make, then you can simply do a "javac *.java" at the OS 
command line (or follow your vendor's instructions for compiling a
Java class).  To build the documentation, do a "make docs" 
or "javadoc -public *.java".  Note that the images needed by the html
generated by javadoc are not included.  You will need to get those
from some other Java documentation package.

Note that the Makefile is not compliant with the GNU makefile
standards as I anticipate that at some point a master makefile will
be created for various GNU Java packages.  And it is serious overkill
to create a megabloat makefile (kinda like this megabloat README) for 
such a simple package.

There is sample code showing how to use getopt available in the
GetoptDemo.java file.

NEW: A support file for the "ant" build process was contributed.  Here are
some brief things you can do with it.  Note that I have not ever used this
so it is doubly AS IS.

Get ant from jakarta project (see jakarta.apache.org/ant), and run it with
one of these target (all is default target):
ant prepare: create the needed directories
ant classes: compile the java classes
ant jar: create the jar archive
ant javadoc: create the javadoc
ant all: create jar and javadoc
ant clean: clean everything

Happy hacking,

Aaron.
[e-mail]
http://www.urbanophile.com/arenn/