This directory contains the examples for the `chem' language written
in the book:

    Computing Science Technical Report No. 122
    CHEM - A Program for Typesetting Chemical Diagrams: User Manual
    by Jon L. Bentley, Lynn W. Jelinski, Brian W. Kernighan

The book is available in the internet at
<http://cm.bell-labs.com/cm/cs/cstr/122.ps.gz>.

Many of the examples had to be fixed.  Unfortunately, the `chem' akw
version does not run on many of these programs.  But the Perl version
of `chem' works on all examples.

Most examples do not use the modern chemical display.  They have C
atoms added, whereas the modern method omits all C atoms and their
directly appended H atoms.

The examples are named and sorted by the chapter where they are found
in the book.  For example, the file `ch4c_colon.chem' means a `chem'
example in chapter 4; according to `c', it is the third example in
this chapter; the name `colon' is used to describe the context of the
example.

You can view the graphical display of the examples by calling

    groffer <file>

`groffer' calls `chem' automatically.

If you want to transform example files to a different format use the
`roff2*' programs:

`roff2dvi' prints dvi format to standard output,
`roff2html' generates html output,
`roff2pdf' outputs pdf mode,
`roff2ps' produces PostScript output,
`roff2text' generates text output in the groff device `latin1',
`roff2x' prints the output  in  the  groff  device  X  that  is
         suitable  for programs  like `gxditview' or `xditview'.

To get a suitable `groff' output run

    chem <file> | groff -p ...


####### License

Last update: 5 Jan 2009

Copyright (C) 2006, 2009 Free Software Foundation, Inc.
Written by Bernd Warken.

This file is part of `chem', which is part of `groff'.

`groff' is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

`groff' is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.


####### Emacs settings

Local Variables:
mode: text
End:
