Aaron Turner 1bb6d0e15f Import upstream version 3.4.1 15 years ago
..
autoopts 1bb6d0e15f Import upstream version 3.4.1 15 years ago
compat 1bb6d0e15f Import upstream version 3.4.1 15 years ago
m4 1bb6d0e15f Import upstream version 3.4.1 15 years ago
COPYING.gplv3 5a34550a3b Import upstream version 3.2.0 17 years ago
COPYING.lgplv3 5a34550a3b Import upstream version 3.2.0 17 years ago
COPYING.mbsd f6a2e4df1d Import upstream version 2.99+3.0.beta6 19 years ago
MakeDefs.inc 99c4958664 Import upstream version 2.99+3.0.rc1 17 years ago
Makefile.am 1bb6d0e15f Import upstream version 3.4.1 15 years ago
Makefile.in 1bb6d0e15f Import upstream version 3.4.1 15 years ago
README 20feef3563 Import upstream version 3.1.1 17 years ago
ag-char-map.h 1bb6d0e15f Import upstream version 3.4.1 15 years ago
autoopts.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
autoopts.h 1bb6d0e15f Import upstream version 3.4.1 15 years ago
boolean.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
configfile.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
cook.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
enumeration.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
environment.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
file.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
genshell.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
genshell.h 1bb6d0e15f Import upstream version 3.4.1 15 years ago
libopts.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
load.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
makeshell.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
nested.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
numeric.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
parse-duration.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
parse-duration.h 1bb6d0e15f Import upstream version 3.4.1 15 years ago
pgusage.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
proto.h 1bb6d0e15f Import upstream version 3.4.1 15 years ago
putshell.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
reset.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
restore.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
save.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
sort.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
stack.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
streqvcmp.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
text_mmap.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
time.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
tokenize.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
usage.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
value-type.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
value-type.h 1bb6d0e15f Import upstream version 3.4.1 15 years ago
version.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
xat-attribute.c 1bb6d0e15f Import upstream version 3.4.1 15 years ago
xat-attribute.h 1bb6d0e15f Import upstream version 3.4.1 15 years ago

README

THIS TARBALL IS NOT A FULL DISTRIBUTION.

The contents of this tarball is designed to be incorporated into
software packages that utilize the AutoOpts option automation
package and are intended to be installed on systems that may not
have libopts installed. It is redistributable under the terms
of either the LGPL (see COPYING.lgpl) or under the terms of
the advertising clause free BSD license (see COPYING.mbsd).

Usage Instructions for autoconf/automake/libtoolized projects:

1. Install the unrolled tarball into your package source tree,
copying ``libopts.m4'' to your autoconf macro directory.

In your bootstrap (pre-configure) script, you can do this:

rm -rf libopts libopts-*
gunzip -c `autoopts-config libsrc` | tar -xvf -
mv -f libopts-*.*.* libopts
cp -fp libopts/m4/*.m4 m4/.

I tend to put my configure auxiliary files in "m4".
Whatever directory you choose, if it is not ".", then
be sure to tell autoconf about it with:

AC_CONFIG_AUX_DIR(m4)

This is one macro where you *MUST* remember to *NOT* quote
the argument. If you do, automake will get lost.

2. Add the following to your ``configure.ac'' file:

LIBOPTS_CHECK

or:

LIBOPTS_CHECK([relative/path/to/libopts])

This macro will automatically invoke

AC_CONFIG_FILES( [relative/path/to/libopts/Makefile] )

The default ``relative/path/to/libopts'' is simply
``libopts''.

3. Add the following to your top level ``Makefile.am'' file:

if NEED_LIBOPTS
SUBDIRS += $(LIBOPTS_DIR)
endif

where ``<...>'' can be whatever other files or directories
you may need. The SUBDIRS must be properly ordered.
*PLEASE NOTE* it is crucial that the SUBDIRS be set under the
control of an automake conditional. To work correctly,
automake has to know the range of possible values of SUBDIRS.
It's a magical name with magical properties. ``NEED_LIBOPTS''
will be correctly set by the ``LIBOPTS_CHECK'' macro, above.

4. Add ``$(LIBOPTS_CFLAGS)'' to relevant compiler flags and
``$(LIBOPTS_LDADD)'' to relevant link options whereever
you need them in your build tree.

5. Make sure your object files explicitly depend upon the
generated options header file. e.g.:

$(prog_OBJECTS) : prog-opts.h
prog-opts.h : prog-opts.c
prog-opts.c : prog-opts.def
autogen prog-opts.def

6. *OPTIONAL* --
If you are creating man pages and texi documentation from
the program options, you will need these rules somewhere, too:

man_MANS = prog.1
prog.1 : prog-opts.def
autogen -Tagman1.tpl -bprog prog-opts.def

prog-invoke.texi : prog-opts.def
autogen -Taginfo.tpl -bprog-invoke prog-opts.def

If your package does not utilize the auto* tools, then you
will need to hand craft the rules for building the library.

LICENSING:

This material is copyright 1993-2007 by Bruce Korb.
You are licensed to use this under the terms of either
the GNU Lesser General Public License (see: COPYING.lgpl), or,
at your option, the modified Berkeley Software Distribution
License (see: COPYING.mbsd). Both of these files should be
included with this tarball.