		   --- The FWEB/MANUAL SUBDIRECTORY ---

NOTE:  Before doing any TeXing related to the user manual, you should put
this subdirectory into your TEXINPUTS path---for example,

	setenv TEXINPUTS "$TEXINPUTS":$HOME/fweb/manual

-------------------------------------------------------------------------------

To obtain a short reference guide to FWEB, say

	make guide

To obtain the complete user manual, say

	make -n manual

to see what will happen.  If executed, this command will dump the user
manual to the printer.  Note that the full user manual is about 180 pages
long!  For expert users, the reference guide should be adequate.  If you're
satisfied that all is well, say

	make manual

(The make file may just echo the print commands, rather than executing
them.  In that case, either do them by hand or comment out the definition of
ECHO in web/defaults.mk.)

  In addition to the manual fwebman.tex, this subdirectory contains a
variety of other files that are either included into the manual or used to
help typeset it, or serve various miscellaneous functions.  They are as
follows: 

	demos.sty --- Style file for the manual demos.

	demo0.web --- Introductory demo for the manual.
	demo1.web --- Examples of the use of named modules.
	demo2.web --- A language demo for the manual.
	demo3.web --- Illustrates forward referencing for identifiers.
	demo4.web --- Shows how to beautify array references in Fortran and C.

	demo?.tex --- Woven version of demo?.web.

	equations.sty --- A collection of macros to aid in constructing
			displayed equations in LaTeX, written by Charles
			Karney, Princeton University.

	f0to_web.src --- A sample Fortran source file.
	f0to_web.web --- A Web version of above.
	f0to_web.tex --- Woven version of above.
	f0to_web.f  --- Tangled version of above.

	f90_cpp.web --- A demo program containing Fortran--90 and C++ code.
	f90_cpp.tex --- Woven version of above.

	fmanmacs.tex --- Macros for the user manual and the installation
			guide. 
	fmanrefs.tex --- \input by fmanmacs; a rudimentary referencing
			scheme for the manual.

	fweb.tex   --- TeX macros needed for weaving the FWEB source code.
	
	fweb.1     --- Unix man pages.

	fweb.texinfo --- Source code for the .info files.
	fweb.info   --- On-line info for FWEB.
	fweb.info-1 --- As above.
	fweb.info-2 --- As above.

	fwebmac.web --- Source code for the FWEB macro package.
	fwebmac.tx --- Tangled output from above.  This is what is actually
			included into the .tex files produced by FWEAVE.
	fwebmac.tex --- Woven version of fwebmac.web.

	fwebman.tex --- The user manual.

	guide.tex --- The short reference guide.
	guide0.tex --- Body of the reference guide, included into both
			guide.tex and fwebman.tex.

	indexing.tex --- Macros for indexing the manual.
	indexmac.tex --- Read in by the LaTeX source fwebman.ind.

	mx.sty --- Style file for the makeindex utility.

	*.ndx --- Index files associated with above tex files.
	*.mds --- Module lists associated with above tex files.

	*.stl --- Details of style-file vocabulary.
