"Inside LessTif" README
-----------------------------------------------------------------------------

Copyright (c) 1996, 2001 by
  D. Backx (danny.backx@skynet.be)
  M. Miers (miers@packet.net),
  C. Toshok (toshok@hungry.com),
  H. Albrecht (editor, harald@plt.rwth-aachen.de)


See file PUBLIC for legal notice.

This is the README for the source distribution (LaTeX2e) of the
"Inside LessTif" book. It DOES NOT contain either the P*stScr*pt files
or PDF ready for printing.  You'll need the following software if you
want to process the LaTeX sources:

  - LaTeX 2e (LaTeX 2.09 won't work). Make sure you have a moderately
    recent distribution, especially in case you want to work with
    pdflatex.

  - pdflatex, if you want to directly produce PDF. This is now the
    recommended way. You should use at least 0.14h, better some of
    the 1.00?-pretest releases. They work great.
  
  - As an alternative to pdflatex you may use vtex from Micropress Inc.

  - ghostscript - if you want to preview the .dvi file. You'll need
    this or you won't see the figures in the xdvi previewer. Again,
    use a recent ghostscript release.

  - dvips(k) - for converting .dvi to .ps. If you use pdflatex/vtex,
    you won't need this.

  - xfig - for manipulating or creating figures.

  - awk - this one is needed to correct errors in the .eps files generated
    by the fig2dev translator, which translates .fig files into .eps files.
    (Note: might new be obsolete -- untested with newer xfig releases)


PDF (highly recommended!):

Currently, only ISO A4 is supported, but this is a standard, isn't it?
(grin) With the current TeX distributions and pdflatex/vtex available, this
is now the preferred document output format:
  - capter and section bookmarks,
  - hyperlinked index, table of contents, figures, tables,
  - Type 1 fonts (with a Type 3 circle crept in...).

To create the PDF file:
  $ make pdf


P*stscr*pt:

As this is a multi-national project, different papersizes (well, two: a4 and
letter) are supported. In addition "Inside LessTif" can be formatted for
single-sided or double-sided printing. Because double-sided printing is also
supported for printers capable of single-sided printing, we end up with
eight different .ps files:

    LessTif<?><?>.ps
            |  |
            |  +-- a4   for european a4 paper size
            |      l    for u.s. letter paper size
            |
            +----- s    for single-sided printing
                   d    for double-sided printing
                   odd  for files containing odd pages
                   even for files containing even pages


To create a preview on a4 paper (single-sided) do a:
  $ make dvi
  $ xdvi LessTifsa4.dvi
To create a preview on letter-sized paper (single-sided) enter:
  $ make LessTifsl.dvi
  $ xdvi LessTifsl.dvi

If you want to create the final .ps files, type:
  $ make all
This creates eight .ps files, ready for single-sided or double-sided
printing.

As usual, you can cleanup everything (except .eps files and .gz files):
  $ make clean


FEEDBACK:

If you want to comment on this document, come up with suggestion,
corrections or even additions please send an email to
  lesstif@lesstif.org

-----------------------------------------------------------------------------
END OF "Inside LessTif" README
