Installation:

Copy libfreegetopt.a SDK:Local/newlib/lib/
Copy getopt.h SDK:Local/newlib/include/

Usage:

gcc -o blah.exe blah1.o blah2.o -lfreegetopt

--- original readme ---

******************************************************************************
Please read the file LICENSE for the terms of use and distribution of this
software.
******************************************************************************

"getopt" is a library that allows a parsing of arguments passed
to a program.  This is a useful library used in many software.
There are many versions of the getopt library available, two
popular versions being the BSD getopt and the GNU getopt.

BSD getopt is somewhat old, dated, and isn't very user-friendly.
The GNU getopt is great, except the user license doesn't let you
statically link the library to a proprietary software.  This
is usually not a problem on modern operating systems that allow
dynamic links to libraries, but sometimes you just gotta link
the library statically for one reason or another.  That's where
Free Getopt steps in.

Functionally, this getopt library is equivalent to GNU's getopt
library (the short option version, not the long one) in almost
every aspect.  The only exception is how the "optind" variable
increments.  Apparently due to different algorithms used by my
program and the GNU getopt, the "optind" changes quite differently
between our two software.  I personally find my algorithm to be
quite elegant; I couldn't tell you about the GNU version since
I never looked at its source.

GNU's getopt_long support is in progress.

This library was deliberately left in non-library (not in
*.lib, *.so, or *.a) form because it's most likely to be
statically-linked in various platforms, and linking it
directly from source is probably the most straight-forward
way to use the software in any platform.

I hope you find this software useful.

Mark K. Kim

$Header: /cvsroot/freegetopt/freegetopt/README,v 1.2 2003/10/26 03:10:19 vindaci
Exp $

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                  477    1036  46.0% -lh5- cc57 Oct 26  2003 freegetopt-0.11/ChangeLog
[generic]                 1079    2206  48.9% -lh5- 3a22 Apr  9 13:15 freegetopt-0.11/freegetopt.readme
[generic]                 2529    6463  39.1% -lh5- 145e Oct 26  2003 freegetopt-0.11/getopt.c
[generic]                 1044    2075  50.3% -lh5- 002c Oct 26  2003 freegetopt-0.11/getopt.h
[generic]                 2108    6136  34.4% -lh5- f487 Apr  9 13:08 freegetopt-0.11/libfreegetopt.a
[generic]                  805    1528  52.7% -lh5- 0770 Oct 26  2003 freegetopt-0.11/LICENSE
[generic]                  261     671  38.9% -lh5- 4311 Apr  9 13:08 freegetopt-0.11/Makefile
[generic]                  890    1840  48.4% -lh5- 228a Oct 26  2003 freegetopt-0.11/README
[generic]                 5503   13736  40.1% -lh5- 90f7 Apr  9 13:05 freegetopt-0.11/test
[generic]                 2097    5393  38.9% -lh5- b124 Oct 26  2003 freegetopt-0.11/test.c
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        10 files   16793   41084  40.9%            Apr  9 06:59