[tex-live] typos in man pages
bnb at ams.org
Sun Aug 10 17:32:26 CEST 2008
how can I find out the people reponsible for a given man page?
For example, there are some serious typos in amstex.1 (see the patch
although the source of amstex itself is the
ams, i can't find any indication that the man
file originated here. the oldest copy we have
is one distributed with tetex in (i believe)
2006. the bottom of the file says
Web2C 7.5.6 Last change: 27 December 1992
so it is definitely not recent.
this is woefully out of date, and contains
other errors in addition to the technical ones
you pointed out. ams-latex has superseded
amstex as the "official" typesetting system
of the ams (if "official" is interpreted as
the system used for journal production), a
switchover which occurred pre-2000. there is
no man page for ams-latex or amsmath, although
amsmath.sty is mentioned in the man page text.
my question is, should this page be updated
or simply scrapped? i'm not sufficiently fluent
in creating man pages to do anything useful.
Shall I send patches to this list? Shall I fix it immediately in
TeXLive? I assume that the PDF files of the man pages are then
regenerated automatically, right?
if this page is to be retained, then there
really should be some more changes besides
the ones shown here.
--- /home/wl/texlive/texmf/doc/man/man1/amstex.1 2008-08-02 16:09:38.000000000 +0200
+++ amstex.1 2008-08-10 12:10:51.000000000 +0200
@@ -2,8 +2,8 @@
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
-.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff
-.el .ds OX TeX for nroff
+.if t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP\" for troff
+.if n .ds OX TeX\" for nroff
.\" the same but obliqued
.\" BX definition must follow TX so BX can use TX
.if t .ds BX \fRB\s-2IB\s0\fP\*(TX
@@ -37,9 +37,9 @@
The \*(AX macros encourage writers to think about the content of their
documents, rather than the form. The ideal, not always realized, is to
-have no formatting commands (like ``switch to italic'' or ``skip 2
-picas'') in the document at all; instead, everything is done
-by specific markup instructions: ``emphasize'', ``start a section''.
+have no formatting commands (like \(lqswitch to italic\(rq or \(lqskip 2
+picas\(rq) in the document at all; instead, everything is done
+by specific markup instructions: \(lqemphasize\(rq, \(lqstart a section\(rq.
\*(AX is the official typesetting system of the American Mathematical
Society, and nearly all of its publications are typeset using \*(AX. The
@@ -53,10 +53,10 @@
Documentation for \*(AX, typesettable by \*(TX.
Documentation for AMS fonts, typesettable by \*(TX.
.SH "SEE ALSO"
More information about the tex-live