head	1.5;
access;
symbols
	groff-1_20_1_real:1.5
	groff-1_20_1:1.5
	groff-1_20:1.5;
locks; strict;
comment	@# @;


1.5
date	2009.01.05.20.10.33;	author wl;	state Exp;
branches;
next	1.4;
commitid	LOYcfESGVCXMFixt;

1.4
date	2009.01.04.14.50.53;	author wl;	state Exp;
branches;
next	1.3;
commitid	RfDBP1nYqohhW8xt;

1.3
date	2006.11.09.23.56.49;	author bwarken;	state Exp;
branches;
next	1.2;

1.2
date	2006.11.06.23.17.25;	author bwarken;	state Exp;
branches;
next	1.1;

1.1
date	2006.10.26.22.13.49;	author wl;	state Exp;
branches;
next	;


desc
@@


1.5
log
@Update copyright year.
@
text
@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

    @@g@@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:
@


1.4
log
@

* */*: Update GPL2 to GPL3.
@
text
@d49 1
a49 1
Last update: 9 Nov 2006
d51 1
a51 1
Copyright (C) 2006 Free Software Foundation, Inc.
@


1.3
log
@Update chem-0.3.0
@
text
@d58 2
a59 2
the Free Software Foundation; either version 2, or (at your option)
any later version.
d67 1
a67 3
along with `groff'; see the files COPYING and LICENSE in the top
directory of the `groff' source.  If not, write to the Free Software
Foundation, 51 Franklin St - Fifth Floor, Boston, MA 02110-1301, USA.
@


1.2
log
@Update chem-0.1.2
@
text
@d29 14
a42 2
`groffer' calls `chem' automatically.  Or get a suitable `groff'
output by running
d49 1
a49 1
Last update: 6 Nov 2006
@


1.1
log
@

* import of chem 0.1.0
@
text
@d11 13
a23 4
The examples are sorted by the chapter 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.
d27 1
a27 1
    @@g@@chem <file> | groffer
d29 2
a30 1
or get a suitable `groff' output by running
d37 1
a37 1
Last update: 26 Oct 2006
@

