[tex-live] typos in man pages

[Barbara Beeton]

werner,

    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
    below).

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.
suggestions?

    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.
							-- bb

        Werner
    
    
    ======================================================================
    
    
    --- /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 @@
     .PP
     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.
     .PP
     \*(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 @@
     .\"=====================================================================
     .SH FILES
     .TP
    -.I amsguide.tex"
    +.I amsguide.tex
     Documentation for \*(AX, typesettable by \*(TX.
     .TP
    -.I amfndoc.tex"
    +.I amfndoc.tex
     Documentation for AMS fonts, typesettable by \*(TX.
     .\"=====================================================================
     .SH "SEE ALSO"