nulib2/nufxlib
Stephen Kitt f6ff60420b
Add AC_DEFINE descriptions
This allows current autoheader to process configure.in, preserving the
comments in config.h.in.

Signed-off-by: Stephen Kitt <steve@sk2.org>
2019-05-04 23:02:16 +02:00
..
samples Fix test-twirl 2015-12-26 15:55:58 -08:00
.gitignore Distinguish Unicode and Mac OS Roman strings 2015-01-02 17:14:34 -08:00
Archive.c Distinguish Unicode and Mac OS Roman strings 2015-01-02 17:14:34 -08:00
ArchiveIO.c Move method return type to declaration line 2014-12-22 16:00:33 -08:00
Bzip2.c Distinguish Unicode and Mac OS Roman strings 2015-01-02 17:14:34 -08:00
ChangeLog.txt Update version for v3.1.0 release 2017-09-21 11:52:37 -07:00
Charset.c Win32 API fix 2015-01-04 11:29:18 -08:00
Compress.c Move method return type to declaration line 2014-12-22 16:00:33 -08:00
config.guess Remove placeholder version number from directory name. 2014-10-28 10:27:31 -07:00
config.h.in Use integer types with explicit widths 2014-12-22 14:56:12 -08:00
config.sub Remove placeholder version number from directory name. 2014-10-28 10:27:31 -07:00
configure Fix Mac OS X behavior 2015-01-03 15:59:37 -08:00
configure.in Add AC_DEFINE descriptions 2019-05-04 23:02:16 +02:00
COPYING-LIB Remove placeholder version number from directory name. 2014-10-28 10:27:31 -07:00
Crc16.c Minor Mac fixes 2015-01-03 11:24:12 -08:00
Debug.c Distinguish Unicode and Mac OS Roman strings 2015-01-02 17:14:34 -08:00
Deferred.c Distinguish Unicode and Mac OS Roman strings 2015-01-02 17:14:34 -08:00
Deflate.c Move method return type to declaration line 2014-12-22 16:00:33 -08:00
Entry.c Minor Mac fixes 2015-01-03 11:24:12 -08:00
Expand.c Move method return type to declaration line 2014-12-22 16:00:33 -08:00
FileIO.c Improve Mac OS X file type handling 2015-12-26 15:22:16 -08:00
Funnel.c Distinguish Unicode and Mac OS Roman strings 2015-01-02 17:14:34 -08:00
INSTALL Remove placeholder version number from directory name. 2014-10-28 10:27:31 -07:00
install-sh Remove placeholder version number from directory name. 2014-10-28 10:27:31 -07:00
Lzc.c Move method return type to declaration line 2014-12-22 16:00:33 -08:00
Lzw.c Missed a "uint". 2014-12-22 16:20:39 -08:00
Makefile.in Ensure the library is built before the samples 2019-05-04 23:00:48 +02:00
Makefile.msc Distinguish Unicode and Mac OS Roman strings 2015-01-02 17:14:34 -08:00
MiscStuff.c Move method return type to declaration line 2014-12-22 16:00:33 -08:00
MiscStuff.h Fix include guards 2014-12-22 16:06:55 -08:00
MiscUtils.c Distinguish Unicode and Mac OS Roman strings 2015-01-02 17:14:34 -08:00
mkinstalldirs Remove placeholder version number from directory name. 2014-10-28 10:27:31 -07:00
NOTES.md Add Unicode details to NOTES 2015-01-04 15:31:35 -08:00
nufxlib.def Distinguish Unicode and Mac OS Roman strings 2015-01-02 17:14:34 -08:00
NufxLib.h Fix handling of entries with missing threads 2015-12-26 12:05:13 -08:00
NufxLibPriv.h Include file/line info without DEBUG_MSGS 2015-01-07 15:06:25 -08:00
README.txt Minor Mac fixes 2015-01-03 11:24:12 -08:00
Record.c Fix extraction of disk images 2016-01-11 09:11:30 -08:00
SourceSink.c Distinguish Unicode and Mac OS Roman strings 2015-01-02 17:14:34 -08:00
Squeeze.c Move method return type to declaration line 2014-12-22 16:00:33 -08:00
SysDefs.h Update SysDefs for Visual Studio 2015 2015-11-15 15:36:01 -08:00
Thread.c Fix extraction of disk images 2016-01-11 09:11:30 -08:00
Value.c Move method return type to declaration line 2014-12-22 16:00:33 -08:00
Version.c Distinguish Unicode and Mac OS Roman strings 2015-01-02 17:14:34 -08:00

NufxLib README, updated 2014/12/23
http://www.nulib.com/

See "COPYING-LIB" for distribution restrictions.


UNIX
====

Run the "configure" script.  Read through "INSTALL" if you haven't used
one of these before, especially if you want to use a specific compiler
or a particular set of compiler flags.

You can disable specific compression methods with "--disable-METHOD"
(run "sh ./configure --help" to see the possible options).  By default,
all methods are enabled except bzip2.

Run "make depend" if you have makedepend, and then type "make".  This will
build the library and all of the programs in the "samples" directory.
There are some useful programs in "samples", described in a README.txt
file there.  In particular, you should run samples/test-basic to verify
that things are more or less working.

If you want to install the library and header file into standard system
locations (usually /usr/local), run "make install".  To learn how to
specify different locations, read the INSTALL document.

There are some flags in "OPT" you may want to use.  The "autoconf" default
for @CFLAGS@ is "-g -O2".

-DNDEBUG
  Disable assert() calls and extra tests.  This will speed things up,
  but errors won't get caught until later on, making the root cause
  harder to locate.

-DDEBUG_MSGS
  Enable debug messages.  This increases the size of the executable,
  but shouldn't affect performance.  When errors occur, more output is
  produced.  The "debug dump" feature is enabled by this flag.

-DDEBUG_VERBOSE
  (Implicitly sets DEBUG_MSGS.)  Spray lots of debugging output.

If you want to do benchmarks, use "-O2 -DNDEBUG".  The recommended
configuration is "-g -O2 -DDEBUG_MSGS", so that verbose debug output is
available when errors occur.


BeOS
====

This works just like the UNIX version, but certain defaults have been
changed.  Running configure without arguments under BeOS is equivalent to:

    ./configure --prefix=/boot --includedir='${prefix}/develop/headers'
      --libdir='${exec_prefix}/home/config/lib' --mandir='/tmp'
      --bindir='${exec_prefix}/home/config/bin'

If you're using BeOS/PPC, it will also do:

    CC=cc CFLAGS='-proc 603 -opt full'


Mac OS X
========

This works just like the UNIX version, but includes support for resource
forks and Finder file/aux types.

Tested with Xcode v5.1.1 and Mac OS 10.8.5.


Win32
=====

If you're using an environment that supports "configure" scripts, such as
DJGPP, follow the UNIX instructions.

NufxLib has been tested with Microsoft Visual C++ 12 (Visual Studio 2013).
To build NufxLib, run the "Visual Studio 2013 x86 Native Tools Command
Prompt" shortcut to get a shell.  Change to the nufxlib directory, then:

    nmake -f makefile.msc

When the build finishes, run "test-basic.exe" to confirm things are working.

If you want to have zlib support enabled, you will need to have zlib.h,
zconf.h, and zlib.lib copied into the directory.  See "makefile.msc" for
more details.

The makefile builds NufxLib as a static library and as a DLL.


Other Notes
===========

If you want to use the library in a multithreaded application, you should
define "USE_REENTRANT_CALLS" to tell it to use reentrant versions of
certain library calls.  This defines _REENTRANT, which causes Solaris to
add the appropriate goodies.  (Seems to me you'd always want this on, but
for some reason Solaris makes you take an extra step, so I'm not going to
define it by default.)

Originally, NufxLib / NuLib2 were intended to be usable natively on the
Apple IIgs, so some of the design decisions were influenced by the need
to minimize memory usage (e.g. being able to get a directory listing
without holding the entire directory in memory) and interact with GS/OS
(forked files have a single filename, files have type/auxtype).  The IIgs
port was never started.


Legalese
========

NufxLib, a NuFX archive manipulation library.
Copyright (C) 2000-2014 by Andy McFadden, All Rights Reserved.

See COPYING for license.