contrib/chem/examples/122/README.txt

   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 Copyright (C) 2006-2018 Free Software Foundation, Inc.
  50 Written by Bernd Warken <groff-bernd.warken-72@web.de>.
  51
  52 This file is part of 'chem', which is part of 'groff'.
  53
  54 'groff' is free software; you can redistribute it and/or modify it
  55 under the terms of the GNU General Public License (GPL) version 2 as
  56 published by the Free Software Foundation.
  57
  58 'groff' is distributed in the hope that it will be useful, but WITHOUT
  59 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  60 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  61 for more details.
  62
  63 You should have received a copy of the GNU General Public License
  64 along with this program.  If not, see <http://www.gnu.org/licenses/>.
  65
  66 The GPL2 license text is available in the internet at
  67 <http://www.gnu.org/licenses/gpl-2.0.html>.
  68
  69
  70 ####### Emacs settings
  71
  72 Local Variables:
  73 mode: text
  74 End: