gbranden pushed a commit to branch master
in repository groff.
commit 5817ff480d2b65f9946ac12fbeadd411e26351ef
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Dec 18 20:12:45 2025 -0600
contrib/chem/examples/122/README.txt: Revise.
...heavily.
CSTR #122 is a paper, not a book. It has sections, not chapters. The
"cm.bell-labs.com" site has mostly been dead or redirecting for years.
Recognize availability of groff's `-j` command-line option.
Fix spelling errors and non-idiomatic English.
Annotate a point that could use attention from someone with appropriate
expertise.
---
contrib/chem/examples/122/README.txt | 28 +++++++++++++---------------
1 file changed, 13 insertions(+), 15 deletions(-)
diff --git a/contrib/chem/examples/122/README.txt
b/contrib/chem/examples/122/README.txt
index 94c7991ae..50a237e09 100644
--- a/contrib/chem/examples/122/README.txt
+++ b/contrib/chem/examples/122/README.txt
@@ -1,30 +1,28 @@
This directory contains the examples for the chem language written
-in the book:
+in the Bell Labs paper CSTR #122.
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
+Historically, this paper was available 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.
+Many of the examples had to be fixed. Unfortunately, the AWK version of
+chem version does not run on many of these files. The Perl
+version of chem distributed with groff does.
-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.
+Most examples do not use a modern style of depiction. They show carbon
+atoms explicitly, whereas contemporary practice omits all C atoms and
+their bound hydrogen atoms. [A chemist should fact-check this. --GBR]
-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
+The examples are named and sorted by the section whence they are found
+in CSTR #122. For example, the file 'ch4c_colon.chem' [sic] means an
+example in section 4; the 'c' indicates that it is the third example in
+this section; the name 'colon' is used to describe the content of the
example.
-You can view the graphical display of the examples by calling
-
- @g@chem <file> | groff -p ...
+Render the examples with "groff -j".
##### Editor settings
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
