58 lines
2.6 KiB
Plaintext
58 lines
2.6 KiB
Plaintext
|
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 arenn@urbanophile.com. The more detailed a bug report the better.
|
||
|
|
Bug fixes are also welcome at the same address. Please reference
|
||
|
|
release number "1.0.13". 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.
|
||
|
|
arenn@urbanophile.com
|
||
|
|
http://www.urbanophile.com/arenn/
|
||
|
|
|