Metropoli BBS
VIEWER: libex.doc MODE: TEXT (ASCII)
LIBEX.LIB

--> G/GX ONLY!

Library Explorer & Extractor

Author : HPreg and DEYLONE (see PCT.TXT)

Documentation by Joe Horn.

This is a terrific library-extraction tool.  It is the only tool yet
written that extracts a command AND ALL OF ITS EXTERNAL CALLS into a
directory, thus automating the otherwise tedious task of making
subsets of large libraries.  It is also the only tool that optionally
extracts all of a function's header, such as what it does when you
press RULES, ISOL, and derivative; whether it's allowed in algebraics,
what it does in the EquationWriter, and more.

It can break an entire Library or just one function. And it can break
a built-in ROM Library and recover ALL external calls to other
libraries (XLIBs).

The output of LIBEX is compatible with the input for LIBMKR, also on
this disk.

Parameters for LIBEX 

Option 1: Number of the Library to break
	  In this case the entire library is extracted.
	  Output is to a directory called 'LIB' (or LIB.1 etc).

Option 2: List of XLIB/Functions/Commands
	  Only the specified ones are extracted.
	  External calls are extracted if specified by SETPREF.

Note : if you want to break a ROM Library, set the Recover External
XLIB option to ON.

RCLXLIB is just a X->R that works with ONE XLIB function put in a
list.

Note: The first SETPREF option (EXT) is what controls whether or not
the library command's external calls will be extracted as well; this
is needed if you're trying to make a subset of a library.

The second SETPREF option (DIR) is what controls whether or not a
function's header will be extracted as well; this is not normally
desired.

'$PRG' (when present) is the actual code of the extracted function.
Otherwise, its code will be in a variable named the same thing as the
command being extracted.
[ RETURN TO DIRECTORY ]