

		       WebMagick Documentation
		       

  This directory contains documentation (webmagick.texinfo) which
  is written in GNU's TeXInfo format. Provided that a texinfo.tex
  macro file is available, this file may be translated into a DVI
  file and from there into Postscript or some other output format
  for which a DVI driver exists. The GNU texinfo package (currently
  at version 3.11 provides a 'makeinfo' command which translates
  the TeXInfo file into 'info' format so that it may be browsed
  with the stand-anone 'info' program, viewed in Emacs, or viewed
  with the 'xinfo' program. High quality HTML output may be created
  via Lionel Cons's 'texi2html' program which is available from the
  URL "http://wwwcn.cern.ch/dci/texi2html/".
  
  If you lack a TeX installation, use the instructions found in
  `ftp://ftp.tug.org/tex/unixtex.ftp' and proceed from there. These
  instructions talk about individual packages. In my experience,
  obtaining and installing the packages 'texmflib.tar.gz' and
  'texk-7.0.tar.gz', plus the graphicx packages (see below) provide
  sufficient TeX capabilities in order to format the WebMagick
  documentation (in addition to the aforementioned GNU
  texinfo-3.11.tar.gz package).

  In order to handle the EPS figures used throughout the document
  you must install a recent dvips driver (included in texk-7.0.tar.gz)
  Which may be obtained from the CTAN network.

  ftp.tex.ac.uk is a represenative CPAN site with its CPAN files
  rooted under "/ctan/tex-archive/".  Another site is ftp.cdrom.com
  with files rooted under "/pub/tex/ctan/".
  
  If you really don't want to bother with installing TeX but want
  typeset output, then look at the 'webmagick.me' target in the
  Makefile which uses 'texi2roff' instead.  The output is not as
  nice but is seems to work ok.  The 'texi2roff' program takes only
  a few minutes to compile and install.

  Documentation processing paths are similar to the following:

  Postscript:
  ===========
  
  webmagick.texinfo-->texi2dvi-->webmagick.dvi-->dvips-->webmagick.ps

  The provided Postscript file is optimized for printers with the
  "CX" engine which include most 300DPI HP printers and clones. If
  your printer differs, you may want to generate your own
  Postscript file (presuming you have a TeX installation).
  
  Without a TeX installation Postscript can be generated via a combination
  of texi2roff and groff (see the 'webmagick.me' target in the Makefile):
  
  webmagick.texinfo-->texi2roff-->webmagick.me-->groff -me>webmagick_me.ps

  Info:
  =====
  
  webmagick.texinfo-->makeinfo-->webmagick.info*
  
  HTML:
  =====
  
  webmagick.texinfo-->texi2html-->webmagick*.html


  Documentation may be viewed on line via:
  
  o Using 'xdvi' on the DVI file
  o Using 'ghostview' on the Postscript file
  o Using 'info', 'xinfo', or 'emacs' on the Info file
  o Using 'nroff -me' on a generated webmagick.me troff file
  o Using a Web browser to view the HTML files
