contrib/groff/contrib/chem/examples/122/README

   1 This directory contains the examples for the `chem' language written
   2 in the book:
   3
   4     Computing Science Technical Report No. 122
   5     CHEM - A Program for Typesetting Chemical Diagrams: User Manual
   6     by Jon L. Bentley, Lynn W. Jelinski, Brian W. Kernighan
   7
   8 The book is available in the internet at
   9 <http://cm.bell-labs.com/cm/cs/cstr/122.ps.gz>.
  10
  11 Many of the examples had to be fixed.  Unfortunately, the `chem' akw
  12 version does not run on many of these programs.  But the Perl version
  13 of `chem' works on all examples.
  14
  15 Most examples do not use the modern chemical display.  They have C
  16 atoms added, whereas the modern method omits all C atoms and their
  17 directly appended H atoms.
  18
  19 The examples are named and sorted by the chapter where they are found
  20 in the book.  For example, the file `ch4c_colon.chem' means a `chem'
  21 example in chapter 4; according to `c', it is the third example in
  22 this chapter; the name `colon' is used to describe the context of the
  23 example.
  24
  25 You can view the graphical display of the examples by calling
  26
  27     groffer <file>
  28
  29 `groffer' calls `chem' automatically.
  30
  31 If you want to transform example files to a different format use the
  32 `roff2*' programs:
  33
  34 `roff2dvi' prints dvi format to standard output,
  35 `roff2html' generates html output,
  36 `roff2pdf' outputs pdf mode,
  37 `roff2ps' produces PostScript output,
  38 `roff2text' generates text output in the groff device `latin1',
  39 `roff2x' prints the output  in  the  groff  device  X  that  is
  40          suitable  for programs  like `gxditview' or `xditview'.
  41
  42 To get a suitable `groff' output run
  43
  44     @g@chem <file> | groff -p ...
  45
  46
  47 ####### License
  48
  49 Last update: 5 Jan 2009
  50
  51 Copyright (C) 2006, 2009 Free Software Foundation, Inc.
  52 Written by Bernd Warken.
  53
  54 This file is part of `chem', which is part of `groff'.
  55
  56 `groff' is free software; you can redistribute it and/or modify it
  57 under the terms of the GNU General Public License as published by
  58 the Free Software Foundation, either version 3 of the License, or
  59 (at your option) any later version.
  60
  61 `groff' is distributed in the hope that it will be useful, but WITHOUT
  62 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  63 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  64 for more details.
  65
  66 You should have received a copy of the GNU General Public License
  67 along with this program. If not, see <http://www.gnu.org/licenses/>.
  68
  69
  70 ####### Emacs settings
  71
  72 Local Variables:
  73 mode: text
  74 End: