* tmac/groff_ms.man: Completely rewritten.

1 files changed, 810 insertions, 134 deletions

diff --git a/tmac/groff_ms.man b/tmac/groff_ms.man
index 590b0607..eca546f6 100644
--- a/tmac/groff_ms.man
+++ b/tmac/groff_ms.man
@@ -1,5 +1,6 @@
+'\" t
 .ig
-Copyright (C) 1989-1995, 2001 Free Software Foundation, Inc.
+Copyright (C) 1989-1995, 2001, 2002 Free Software Foundation, Inc.
 
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice
@@ -23,71 +24,766 @@ groff_ms \- groff ms macros
 .B groff
 .B \-ms
 [
-.IR options .\|.\|.
+.IR options .\|.\|.\&
 ]
 [
-.IR files .\|.\|.
+.IR files .\|.\|.\&
 ]
 .br
 .B groff
 .B \-m\ ms
 [
-.IR options .\|.\|.
+.IR options .\|.\|.\&
 ]
 [
-.IR files .\|.\|.
+.IR files .\|.\|.\&
 ]
+.\" -----
 .SH DESCRIPTION
-This manual page describes the GNU version of the ms macros,
-which is part of the groff document formatting system.
-The groff ms macros are intended to be compatible with the
-documented behaviour of the 4.3
+This manual page describes the GNU version of the
+.I ms
+macros,
+part of the
+.I groff
+typesetting system.
+The
+.I ms
+macros are mostly compatible with the
+documented behavior of the 4.3
 .SM BSD
-Unix ms macros subject to the following limitations:
-.IP \(bu
-the internals of groff ms are not similar to the internals of Unix ms
-and so documents that depend upon implementation details of Unix ms
-may well not work with groff ms;
-.IP \(bu
-there is no support for typewriter-like devices;
+Unix
+.I ms
+macros (see
+.I Differences from troff ms
+below for details).
+The
+.I ms
+macros are suitable for reports, letters, books, and
+technical documentation.
+.\" -----
+.SH USAGE
+The
+.I ms
+macro package expects files to have
+a certain amount of structure.
+The simplest documents can begin with a paragraph macro
+and consist of text separated by paragraph macros
+or even blank lines.
+Longer documents have a structure as follows:
+.TP
+.B "Document type"
+If you use the
+.B RP
+(report) macro at the beginning of the document,
+.I groff
+prints the cover page information on its own page;
+otherwise it prints the information on the
+first page with your document text immediately following.
+Other document formats found in AT&T
+.I troff
+are specific to AT&T
+or Berkeley, and are not supported in
+.IR "groff ms" .
+.TP
+.B "Format and layout"
+By setting number registers,
+you can change your document's type (font and size),
+margins, spacing, headers and footers, and footnotes.
+See 
+.I "Document control registers"
+below for more details.
+.TP
+.B "Cover page"
+A cover page consists of a title,
+and optionally the author's name and institution,
+an abstract, and the date.
+See
+.I "Cover page macros"
+below for more details.
+.TP
+.B "Body"
+Following the cover page is your document.
+It consists of paragraphs, headings, and lists.
+.TP
+.B "Table of contents"
+Longer documents usually include a table of contents,
+which you can add by placing the
+.B TC
+macro at the end of your document.
+.\" -----
+.SS "Document control registers"
+The following table lists the document control
+number registers.
+For the sake of consistency,
+set registers related to margins at the beginning of your document,
+or just after the
+.B RP
+macro.
+.LP
+.B Margin settings
+.TS
+center;
+cb cb cb cb
+afCW l l l .
+Reg.	Definition	Effective	Default
+_
+PO	Page offset (left margin)	next page	1i
+LL	Line length	next para.	6i
+LT	Header/footer length	next para.	6i
+HM	Top (header) margin	next page	1i
+FM	Bottom (footer) margin	next page	1i
+_
+.TE
+.LP
+.B Text settings
+.TS
+center;
+cb cb cb cb
+afCW l l l .
+Reg.	Definition	Effective	Default
+_
+PS	Point size	next para.	10p
+VS	Line spacing (leading)	next para.	12p
+_
+.TE
+.LP
+.if t .bp
+.B Paragraph settings
+.TS
+center;
+cb cb cb cb
+afCW l l l .
+Reg.	Definition	Effective	Default
+_
+PI	Initial indent	next para.	5n
+PD	Space between paragraphs	next para.	0.3v
+QI	Quoted paragraph indent	next para.	5n
+_
+.TE
+.LP
+.B Footnote settings
+.TS
+center;
+cb cb cb cb
+afCW l l l .
+Reg.	Definition	Effective	Default
+_
+FL	Footnote length	next footnote	LL*5/6
+FI	Footnote indent	next footnote	2n
+FF	Footnote format	next footnote	0
+_
+.TE
+.LP
+.B Other settings
+.TS
+center;
+cb cb cb cb
+afCW l l l .
+Reg.	Definition	Effective	Default
+_
+MINGW	Minimum width between columns	next page	2n
+_
+.TE
+.\" -----
+.SS "Cover page macros"
+Use the following macros to create a cover page for your document
+in the order shown.
+.TP
+.B \&.RP [no]
+Specifies the report format for your document.
+The report format creates a separate cover page.
+With no
+.B RP
+macro,
+.I groff
+prints a subset of the
+cover page on page\~1 of your document.
+.IP
+If you use the optional
+.B no
+argument,
+.I groff
+prints a title page but
+does not repeat any of the title page information
+(title, author, abstract, etc.\&)
+on page\~1 of the document.
+.TP
+.BI "\&.DA [" xxx ]
+(optional) Print the current date,
+or the arguments to the macro if any,
+on the title page (if specified)
+and in the footers.
+This is the default for
+.IR nroff .
+.TP
+.BI "\&.ND [" xxx ]
+(optional) Print the current date,
+or the arguments to the macro if any,
+on the title page (if specified)
+but not in the footers.
+This is the default for
+.IR troff .
+.TP
+.B \&.TL
+Specifies the document title.
+.I Groff
+collects text following the
+.B TL
+macro into the title, until reaching the author name or abstract.
+.TP
+.B \&.AU
+Specifies the author's name.
+You can specify multiple authors by using an
+.B AU
+macro for each author.
+.TP
+.B \&.AI
+Specifies the author's institution.
+You can specify multiple institutions.
+.TP
+.B \&.AB [no]
+Begins the abstract.
+The default is to print the word
+.BR ABSTRACT ,
+centered and in italics, above the text of the abstract.
+The option
+.B no
+suppresses this heading.
+.TP
+.B \&.AE
+End the abstract.
+.\" -----
+.SS Paragraphs
+Use the
+.B PP
+macro to create indented paragraphs,
+and the
+.B LP
+macro to create paragraphs with no initial indent.
+.PP
+The
+.B QP
+macro indents all text at both left and right margins.
+The effect is identical to the HTML
+.B <BLOCKQUOTE>
+element.
+The next paragraph or heading
+returns margins to normal.
+.SS Headings
+Use headings to create a hierarchical structure
+for your document.
+The
+.I ms
+macros print headings in
+.B bold
+using the same font family and point size as the body text.
+.PP
+The following heading macros are available:
+.TP
+.BI \&.NH \0xx
+Numbered heading.
+The argument
+.I xx
+is either a numeric argument to indicate the
+level of the heading, or
+.I S\ xx\ xx\ \c
+".\|.\|."
+to set the section number explicitly.
+If you specify heading levels out of sequence,
+such as invoking
+.B ".NH\ 3"
+after
+.BR ".NH\ 1" ,
+.I groff
+prints a warning on standard error.
+.TP
+.B \&.SH
+Unnumbered subheading.
+.\" -----
+.SS Highlighting
+The
+.I ms
+macros provide a variety of methods to highlight
+or emphasize text:
+.TP
+.BI "\&.B [" txt " [" post " [" pre ]]]
+Sets its first argument in
+.BR "bold type" .
+If you specify a second argument,
+.I groff
+prints it in the previous font after
+the bold text, with no intervening space
+(this allows you to set punctuation after
+the highlighted text without highlighting
+the punctuation).
+Similarly, it prints the third argument (if any)
+in the previous font
+.B before
+the first argument.
+For example,
+.RS
+.IP
+\&.B foo ) (
+.RE
+.IP
+prints
+.RB ( foo ).
+.IP
+If you give this macro no arguments,
+.I groff
+prints all text following in bold until
+the next highlighting, paragraph, or heading macro.
+.TP
+.BI "\&.R [" txt " [" post " [" pre ]]]
+Sets its first argument in
+roman (or regular) type.
+It operates similarly to the
+.B B
+macro otherwise.
+.TP
+.BI "\&.I [" txt " [" post " [" pre ]]]
+Sets its first argument in
+.IR "italic type" .
+It operates similarly to the
+.B B
+macro otherwise.
+.TP
+.BI "\&.CW [" txt " [" post " [" pre ]]]
+Sets its first argument in a constant width face.
+It operates similarly to the
+.B B
+macro otherwise.
+.TP
+.BI "\&.BI [" txt " [" post " [" pre ]]]
+Sets its first argument in bold italic type.
+It operates similarly to the
+.B B
+macro otherwise.
+.TP
+.BI "\&.BX [" txt ]
+Prints its argument and draws a box around it.
+If you want to box a string that contains spaces,
+use a digit-width space (\[rs]0).
+.TP
+.BI "\&.UL [" txt " [" post ]]
+Prints its first argument with an underline.
+If you specify a second argument,
+.I groff
+prints it in the previous font after
+the underlined text, with no intervening space.
+.TP
+.B \&.LG
+Prints all text following in larger type
+(2\~points larger than the current point size) until
+the next font size, highlighting, paragraph, or heading macro.
+You can specify this macro multiple times
+to enlarge the point size as needed.
+.TP
+.B \&.SM
+Prints all text following in
+smaller type
+(2\~points smaller than the current point size) until
+the next type size, highlighting, paragraph, or heading macro.
+You can specify this macro multiple times
+to reduce the point size as needed.
+.TP
+.B \&.NL
+Prints all text following in
+the normal point size
+(that is, the value of the
+.B PS
+register).
+.TP
+.BI \[rs]*{ text \[rs]*}
+Print the enclosed
+.I text
+as a superscript.
+.\" -----
+.SS Lists
+The
+.B IP
+macro handles duties for all lists.
+Its syntax is as follows:
+.TP
+.BI ".IP [" marker " [" width ]]
+.IP
+The
+.I marker
+is usually a bullet character
+.B \[rs](bu
+for unordered lists,
+a number (or auto-incrementing number register) for numbered lists,
+or a word or phrase for indented (glossary-style) lists.
+.IP
+The
+.I width
+specifies the indent for the body of each list item.
+Once specified, the indent remains the same for all
+list items in the document until specified again.
+.\" -----
+.SS "Displays and keeps"
+Use displays to show text-based examples or figures
+(such as code listings).
+Displays turn off filling, so lines of code can be
+displayed as-is without inserting
+.B br
+requests in between each line.
+Displays can be 
+.I kept
+on a single page, or allowed to break across pages.
+The following table shows the display types available.
+.TS
+center;
+cb s | cb 
+cb cb | ^
+lfCW lfCW | lw(3i) .
+Display macro	Type of display
+With keep	No keep
+_
+\&.DS L	\&.LD	Left-justified.
+\&.DS I [\fIindent\fP]	\&.ID	T{
+Indented (default indent in the \fBDI\fP register).
+T}
+\&.DS B	\&.BD	T{
+Block-centered (left-justified, longest line centered).
+T}
+\&.DS C	\&.CD	Centered.
+\&.DS R	\&.RD	Right-justified.
+_
+.TE
+.LP
+Use the
+.B DE
+macro to end any display type.
+.PP
+To
+.I keep
+text together on a page,
+such as
+a paragraph that refers to a table (or list, or other item)
+immediately following, use the
+.B KS
+and
+.B KE
+macros.
+The
+.B KS
+macro begins a block of text to be kept on a single page,
+and the
+.B KE
+macro ends the block.
+.PP
+You can specify a
+.I "floating keep"
+using the
+.B KF
+and
+.B KE
+macros.
+If the keep cannot fit on the current page,
+.I groff
+holds the contents of the keep and allows text following
+the keep (in the source file) to fill in the remainder of
+the current page.
+When the page breaks,
+whether by an explicit
+.B bp
+request or by reaching the end of the page,
+.I groff
+prints the floating keep at the top of the new page.
+This is useful for printing large graphics or tables
+that do not need to appear exactly where specified.
+.\" -----
+.SS "Tables, figures, equations, and references"
+The
+.I -ms
+macros support the standard
+.I groff
+preprocessors:
+.IR tbl ,
+.IR pic ,
+.IR eqn ,
+and
+.IR refer .
+Mark text meant for preprocessors by enclosing it
+in pairs of tags as follows:
+.TP
+.BR "\&.TS [H]" " and " \&.TE
+Denotes a table, to be processed by the
+.I tbl
+preprocessor.
+The optional
+.BR H "\~argument"
+instructs
+.I groff
+to create a running header with the information
+up to the
+.B TH
+macro.
+.I Groff
+prints the header at the beginning of the table;
+if the table runs onto another page,
+.I groff
+prints the header on the next page as well.
+.TP
+.BR \&.PS " and " \&.PE
+Denotes a graphic, to be processed by the
+.I pic
+preprocessor.
+You can create a
+.I pic
+file by hand, using the
+AT&T
+.I pic
+manual available on the Web as a reference,
+or by using a graphics program such as
+.IR xfig .
+.TP
+.BR "\&.EQ [\fI\,align\/\fP]" " and " \&.EN
+Denotes an equation, to be processed by the
+.I eqn
+preprocessor.
+The optional
+.I align
+argument can be
+.BR C ,
+.BR L ,
+or\~\c
+.B I
+to center (the default), left-justify, or indent
+the equation.
+.TP
+.BR \&.[ " and " \&.]
+Denotes a reference, to be processed by the
+.I refer
+preprocessor.
+The GNU
+.IR @g@refer (@MAN1EXT@)
+manual page provides a comprehensive reference
+to the preprocessor and the format of the
+bibliographic database.
+.\" -----
+.SS Footnotes
+The
+.I ms
+macros provide a flexible footnote system.
+You can specify a numbered footnote by using the
+.B \[rs]**
+escape, followed by the text of the footnote
+enclosed by
+.B FS
+and
+.B FE
+macros.
+.PP
+You can specify symbolic footnotes
+by placing the character (such as
+.B \[rs](dg
+for the dagger character),
+followed by the symbol and the text of the footnote
+enclosed by
+.B FS
+and
+.B FE
+macros.
+.PP
+You can control how
+.I groff
+prints footnote numbers by changing the value of the
+.B FF
+register as follows:
+.RS
+.TP
+0
+Prints the footnote number as a superscript; indents the footnote (default).
+.TP
+1
+Prints the number followed by a period (like\~1.\&)
+and indents the footnote.
+.TP
+2
+Like\~1, without an indent.
+.TP
+3
+Like\~1, but prints the footnote number as a hanging paragraph.
+.LP
+.RE
+You can use footnotes safely within keeps and displays,
+but avoid using numbered footnotes within floating keeps.
+You can set a second
+.B \[rs]**
+between a
+.B \[rs]**
+and its corresponding
+.BR .FS ;
+as long as each
+.B .FS
+occurs
+.I after
+the corresponding
+.B \[rs]**
+and the occurrences of
+.B .FS
+are in the same order as the corresponding occurrences of
+.BR \[rs]** .
+.\" -----
+.SS "Headers and footers"
+There are two ways to define headers and footers:
+.IP \(bu 3n
+Use the strings
+.BR LH ,
+.BR CH ,
+and
+.B RH
+to set the left, center, and right headers; use
+.BR LF ,
+.BR CF ,
+and
+.B RF
+to set the left, center, and right footers.
+This works best for documents that do not distinguish
+between odd and even pages.
 .IP \(bu
-Berkeley localisms, in particular the
-.B TM
+Use the
+.B OH
 and
-.B CT
-macros, are not implemented;
+.B EH
+macros to define headers for the odd and even pages; and
+.B OF
+and
+.B EF
+macros to define footers for the odd and even pages.
+This is more flexible than defining the individual strings.
+The syntax for these macros is as follows:
+.RS
+.IP
+.BI "\&.OH '" left ' center ' right '
+.RE
+.IP
+You can replace the quote (') marks with any character not
+appearing in the header or footer text.
+.\" -----
+.SS Margins
+You control margins using a set of number registers.
+The following table lists the register names and defaults:
+.TS
+center;
+cb cb cb cb
+afCW l l a .
+Reg.	Definition	Effective	Default
+_
+PO	Page offset (left margin)	next page	1i
+LL	Line length	next para.	6i
+LT	Header/footer length	next para.	6i
+HM	Top (header) margin	next page	1i
+FM	Bottom (footer) margin	next page	1i
+_
+.TE
+.PP
+Note that there is no right margin setting.
+The combination of page offset and line length
+provide the information necessary to
+derive the right margin.
+.\" -----
+.SS "Multiple columns"
+The
+.I ms
+macros can set text in as many columns as will reasonably
+fit on the page.
+The following macros are available.
+All of them force a page break if a multi-column mode is already set.
+However, if the current mode is single-column, starting a multi-column
+mode does
+.I not
+force a page break.
+.TP
+.B \&.1C
+Single-column mode.
+.TP
+.B \&.2C
+Two-column mode.
+.TP
+.BI "\&.MC [" width " [" gutter ]]
+Multi-column mode.
+If you specify no arguments, it is equivalent to the
+.B 2C
+macro.
+Otherwise,
+.I width
+is the width of each column and
+.I gutter
+is the space between columns.
+The
+.B MINGW
+number register is the default gutter width.
+.\" -----
+.SS "Creating a table of contents"
+Wrap text that you want to appear in the
+table of contents in
+.B XS
+and
+.B XE
+macros.
+Use the
+.B TC
+macro to print the table of contents at the end of the document.
+.\" -----
+.SH "DIFFERENCES FROM troff ms"
+The
+.I "groff ms"
+macros are a complete re-implementation,
+using no original AT&T code.
+Since they take advantage of the extended features in
+.IR groff ,
+they cannot be used with AT&T
+.IR troff .
+Other differences include:
+.IP \(bu 3n
+The internals of
+.I "groff ms"
+differ from the internals of Unix
+.IR ms . 
+Documents that depend upon implementation details of Unix
+.I ms
+may not format properly with
+.IR "groff ms" .
+.IP \(bu
+The error-handling policy of
+.I "groff ms"
+is to detect and report errors,
+rather than silently to ignore them.
 .IP \(bu
-groff ms
-does not provide cut marks;
+Bell Labs localisms are not implemented.
 .IP \(bu
-multiple line spacing is not allowed
-(use a larger vertical spacing instead);
+Berkeley localisms, in particular the cover page macros,
+are not implemented.
 .IP \(bu
-groff ms does not work in compatibility mode (eg with the
+.I "Groff ms"
+does not work in compatibility mode (e.g.\& with the
 .B \-C
-option);
+option).
 .IP \(bu
-the error-handling policy of groff ms
-is to detect and report errors,
-rather than silently to ignore them.
-.LP
-The groff ms macros make use of many features of GNU troff
-and therefore cannot be used with any other troff.
-.LP
-Bell Labs localisms are not implemented in either the
-.SM BSD
-ms macros or in the groff ms macros.
-.LP
-Some Unix ms documentation says that the
+There is no support for typewriter-like devices.
+.IP \(bu
+.I "Groff ms"
+does not provide cut marks.
+.IP \(bu
+Multiple line spacing is not supported
+(use a larger vertical spacing instead).
+.IP \(bu
+Some Unix
+.I ms
+documentation says that the
 .B CW
 and
 .B GW
 number registers can be used to control the column width and
 gutter width respectively.
-This is not the case.
 These number registers are not used in groff ms.
-.LP
-Macros that cause a reset set the indent.
+.IP \(bu
+Macros that cause a reset
+(paragraphs, headings, etc.)
+may change the indent.
 Macros that change the indent do not increment or decrement
 the indent, but rather set it absolutely.
 This can cause problems for documents that define
@@ -99,61 +795,31 @@ request but instead the
 and
 .B RE
 macros.
-.LP
+.IP \(bu
 The number register
 .B GS
-is set to 1 by the groff ms macros,
-but is not used by the Unix ms macros.
-It is intended that documents that need to determine whether
-they are being formatted with Unix ms or groff ms make use of this
-number register.
-.LP
-Footnotes are implemented so that they can safely be used within
-keeps and displays.
-Automatically numbered footnotes within floating keeps are
-not recommended.
-It is safe to have another
-.B \e**
-between a
-.B \e**
-and the corresponding
-.BR .FS ;
-it is required only that each
-.B .FS
-occur after the corresponding
-.B \e**
-and that the occurrences of
-.B .FS
-are in the same order as the corresponding occurrences of
-.BR \e** .
-.LP
-The strings
-.B \e*{
-and
-.B \e*}
-can be used to begin and end a superscript.
-.LP
-Some Unix V10 ms features are implemented.
-The
-.BR B ,
-.BR I
-and
-.B BI
-macros can have an optional third argument which will be printed
-in the current font before the first argument.
-There is a macro
-.B CW
-like
-.B B
-that changes to a constant-width font.
-.LP
-The following strings can be redefined to adapt the groff ms macros
-to languages other than English:
-.LP
-.nf
-.ta \w'REFERENCES'u+2n
+is set to\~1 by the
+.I "groff ms"
+macros,
+but is not used by the Unix
+.I ms
+macros.
+Documents that need to determine whether
+they are being formatted with Unix
+.I ms
+or
+.I "groff ms"
+should use this number register.
+.SS Strings
+You can redefine the following strings to adapt the
+.I "groff ms"
+macros to languages other than English:
+.TS
+center;
+cb cb
+afCW l .
 String	Default Value
-.sp .3v
+_
 REFERENCES	References
 ABSTRACT	ABSTRACT
 TOC	Table of Contents
@@ -169,69 +835,76 @@ MONTH9	September
 MONTH10	October
 MONTH11	November
 MONTH12	December
-.fi
+_
+.TE
+.\" -----
+.SS Text Settings
+The
+.B FAM
+string sets the default font family.
+If this string is undefined at initialization,
+it is set to Times.
 .LP
-The font family is reset from the string
-.BR FAM ;
-at initialization if this string is undefined it is set to the current
-font family.
 The point size, vertical spacing, and inter-paragraph spacing for footnotes
-are taken from the number registers
+are controlled by the number registers
 .BR FPS ,
 .BR FVS ,
 and
 .BR FPD ;
 at initialization these are set to
-.BR \en(PS-2 ,
-.BR \en[FPS]+2 ,
+.BR \[rs]n(PS-2 ,
+.BR \[rs]n[FPS]+2 ,
 and
-.B \en(PD/2
-respectively; however, if any of these registers has been defined
-before initialization, it will not be set.
+.B \[rs]n(PD/2
+respectively.
+If any of these registers are defined before initialization,
+the initialization macro does not change them.
+.LP
 The hyphenation flags (as set by the
-.B .hy
+.B hy
 request) are set from the
 .B HY
 register;
-if this has not been defined at initialization,
-it will be set to 14.
-.LP
-Right-aligned displays are available with
-.B ".DS R"
-and
-.BR .RD .
+the default is\~14.
+.\" -----
+.SH "NAMING CONVENTIONS"
 .LP
 The following conventions are used for names of macros, strings and
 number registers.
-External names available to documents that use the groff ms
+External names available to documents that use the
+.I "groff ms"
 macros contain only uppercase letters and digits.
-Internally the macros are divided into modules.
+.LP
+Internally the macros are divided into modules;
+naming conventions are as follows:
+.IP \(bu 3n
 Names used only within one module are of the form
-.IB module * name\fR.
+.IB \%module * name\fR.
+.IP \(bu
 Names used outside the module in which they are defined are of the form
-.IB module @ name\fR.
+.IB \%module @ name\fR.
+.IP \(bu
 Names associated with a particular environment are of the form
-.IB environment : name;
+.IB \%environment : name;
 these are used only within the
 .B par
-module,
-and
+module.
+.IP \(bu
 .I name
 does not have a module prefix.
+.IP \(bu
 Constructed names used to implement arrays are of the form
-.IB array ! index\fR.
+.IB \%array ! index\fR.
+.PP
 Thus the groff ms macros reserve the following names:
+.IP \(bu 3n
+Names containing the characters
+.BR * ,
+.BR @ ,
+and\~\c
+.BR : .
 .IP \(bu
-names containing
-.BR * ;
-.IP \(bu
-names containing
-.BR @ ;
-.IP \(bu
-names containing
-.BR : ;
-.IP \(bu
-names containing only uppercase letters and digits.
+Names containing only uppercase letters and digits.
 .SH FILES
 .B @MACRODIR@/ms.tmac
 (a wrapper file for
@@ -243,10 +916,13 @@ names containing only uppercase letters and digits.
 .BR @g@troff (@MAN1EXT@),
 .BR @g@tbl (@MAN1EXT@),
 .BR @g@pic (@MAN1EXT@),
-.BR @g@eqn (@MAN1EXT@)
-.br
-.BR ms (@MAN7EXT@)
-.
+.BR @g@eqn (@MAN1EXT@),
+.BR @g@refer (@MAN1EXT@)
+.SH AUTHOR
+Original manual page by James Clark
+.IR "et al" ;
+rewritten by Larry Kollar
+(\fIlkollar@despammed.com\fR).
 .\" Local Variables:
 .\" mode: nroff
 .\" End: