Here are some more updates to the man page for troff's ms macro set. I went through /sys/lib/tmac/tmac.s looking for things to add. This patch was inspired by a missing .MC, which was documented in Mike Lesk's papers on ms. You'll find such things as new macros and argument descriptions for the set. I also added a basic BUGS section. - Pietro Gagliardi

Notes:
Wed Mar 19 19:05:35 EDT 2008 geoff
    I think we can rely on people to consult the -ms paper,
    use common sense and maybe even experiment a little.


Reference: /n/sources/patch/sorry/ms-man-update-2
Date: Sun Mar 16 05:52:34 CET 2008
Signed-off-by: pietro10@mac.com
Reviewed-by: geoff

--- /sys/man/6/ms	Sun Mar 16 05:51:00 2008
+++ /sys/man/6/ms	Sun Mar 16 05:50:59 2008
@@ -59,8 +59,13 @@
 .IR troff (1),
 .IR tbl (1),
 .IR pic (1)
+.SH BUGS
+.PP
+\fL\&.UL\fP can't wrap around lines.
+.PP
+Some devices make boxing look bad.
 .SH REQUESTS
-.ta \w'.\fL.CW \fIx y z\fR 'u +\w'Initial 'u +\w'Cause 'u
+.ta \w'.\fL.CW \fIx y z\fR 'u +\w'same as \fL.1C\fP 'u +\w'Cause 'u
 .br
 .di x
 			\ka
@@ -78,7 +83,18 @@
 .ti0
 \fL\&.2C\fP	no	yes	Two column format.
 .ti0
-\fL\&.AB\fP	no	yes	Begin abstract.
+\fL\&.AB\fP\ \fIx\fP	no	yes	Begin abstract.
+If
+.I x
+is not given, the word "ABSTRACT' is used as the header of the abstract.
+Using
+.L no
+for
+.I x
+means that no header is printed (but the abstract is still there).
+Any other value for
+.I x
+uses that value as the header.
 .ti0
 \fL\&.AE\fP	-	yes	End abstract.
 .ti0
@@ -86,14 +102,14 @@
 Suppressed in
 .BR .TM .
 .ti0
-\fL\&.AT\fP	no	yes	Print `Attached' and turn off line filling.
+\fL\&.AT\fP	no	yes	Print `Attached:' and turn off line filling.
 .ti0
-\fL\&.AU\fP\fP\fP \fIx y\fR	no	yes	Author's name follows.
+\fL\&.AU\fP\ \fIx\ y\fR	no	yes	Author's name follows.
 .IR x " is location and " y " is"
 extension, ignored except in
 .BR TM .
 .ti0
-\fL\&.B\fP \fIx y z\fR	no	no	Print
+\fL\&.B\fP\ \fIx\ y\ z\fR	no	no	Print
 .I x
 in boldface, append roman
 .I y
@@ -101,11 +117,16 @@
 .IR z ;
 if no argument switch to boldface.
 .ti0
-\fL\&.B1\fP	no	yes	Begin text to be enclosed in a box.
+\fL\&.B1\fP\ \fIx\fP	no	yes	Begin text to be enclosed in a box.
+If
+.I x
+is
+.L C
+center the box, any other value or no value left-aligns it.
 .ti0
 \fL\&.B2\fP	no	yes	End boxed text.
 .ti0
-\fL\&.BI\fP \fIx y z\fR	no	no	Print
+\fL\&.BI\fP\ \fIx\ y\ z\fR	no	no	Print
 .I x
 in bold italic, append roman
 .I y
@@ -117,11 +138,16 @@
 foot of page.
 May be redefined.
 .ti0
-\fL\&.BX\fP \fIx\fR	no	no	Print
+\fL\&.BX\fP\ \fIx\fR	no	no	Print
 .I x
 in a box.
 .ti0
-\fL\&.CW\fP \fIx y z\fR	no	no	Constant width font for
+\fL\&.CT\fP\ \fIname\fP	no	yes	Print `Copy to:' and turn off line filling.
+If a
+.I name
+is given, say 'Copy to \fIname\fP:' instead.
+.ti0
+\fL\&.CW\fP\ \fIx\ y\ z\fR	no	no	Constant width font for
 .IR x ,
 append roman
 .I y
@@ -129,9 +155,7 @@
 .IR z ;
 if no argument switch to constant width.
 .ti0
-\fL\&.CT\fP	no	yes	Print `Copies to' and turn off line filling.
-.ti0
-\fL\&.DA\fP \fIx\fR	nroff	no	`Date line' at bottom of page
+\fL\&.DA\fP\ \fIx\fR	nroff	no	`Date line' at bottom of page
 is
 .IR x .
 Default is today.
@@ -140,7 +164,7 @@
 Implies
 .BR .KE .
 .ti0
-\fL\&.DS\fP \fIx\fR	no	yes	Start of displayed text,
+\fL\&.DS\fP\ \fIx\fR	no	yes	Start of displayed text,
 to appear verbatim line-by-line:
 .L I
 indented (default),
@@ -161,7 +185,7 @@
 or
 .IR eqn (1).
 .ti0
-\fL\&.EQ\fP \fIx y\fR	-	yes	Display equation.
+\fL\&.EQ\fP\ \fIx y\fR	-	yes	Display equation.
 Equation number is
 .IR y .
 Optional
@@ -173,7 +197,7 @@
 .ti0
 \fL\&.FE\fP	-	yes	End footnote.
 .ti0
-\fL\&.FP\fP \fIx\fR	-	no	Set font positions for a family, e.g.,
+\fL\&.FP\fP\ \fIx\fR	-	no	Set font positions for a family, e.g.,
 .L .FP lucidasans
 .ti0
 \fL\&.FS\fP	no	no	Start footnote.
@@ -182,7 +206,7 @@
 \fL\&.HO\fP	-	no	`Bell Laboratories, Holmdel,
 New Jersey 07733'.
 .ti0
-\fL\&.I\fP \fIx y z\fR	no	no	Italicize
+\fL\&.I\fP\ \fIx\ y\ z\fR	no	no	Italicize
 .IR x ,
 append roman
 .I y
@@ -190,11 +214,13 @@
 .IR z ;
 if no argument switch to italic.
 .ti0
+\fL\&.IE\fP	yes	yes	Same as \fL.LP\fP.
+.ti0
 \fL\&.IH\fP	no	no	`Bell Laboratories, Naperville, Illinois 60540'
 .ti0
 \fL\&.IM\fP	no	no	Print document in BTL format for an internal memorandum.  Must be first.
 .ti0
-\fL\&.IP\fP \fIx y\fR	no	yes	Start indented paragraph,
+\fL\&.IP\fP\ \fIx\ y\fR	no	yes	Start indented paragraph,
 with hanging tag
 .IR x .
 Indentation is
@@ -218,6 +244,12 @@
 produces a full Lucent letterhead, a second argument is a room number,
 a third argument is a telephone number.
 .ti0
+\fL\&.MC\fP\ \fIx\fP	same as \fL\&.1C\fP	yes	Multi-column format,
+.I x
+is the column width.
+If none specified, is the same as
+.L .2C .
+.ti0
 \fL\&.MF\fP	-	-	Print document in BTL format for `Memorandum for File.'  Must be first.
 .ti0
 \fL\&.MH\fP	-	no	`Bell Laboratories, Murray Hill,
@@ -225,10 +257,10 @@
 .ti0
 \fL\&.MR\fP	-	-	Print document in BTL format for `Memorandum for Record.'  Must be first.
 .ti0
-\fL\&.ND\fP \fIdate\fR	troff	no	Use date supplied (if any) only in
+\fL\&.ND\fP\ \fIdate\fR	troff	no	Use date supplied (if any) only in
 special BTL format positions; omit from page footer.
 .ti0
-\fL\&.NH\fP \fIn\fR	-	yes	Same as
+\fL\&.NH\fP\ \fIn\fR	-	yes	Same as
 .BR .SH ,
 with automatic section
 numbers like `1.2.3';
@@ -240,7 +272,9 @@
 .ti0
 \fL\&.NL\fP	yes	no	Make letters normal size.
 .ti0
-\fL\&.P1\fP	-	yes	Begin program display in constant width font.
+\fL\&.P1\fP\ \fIx\fP	-	yes	Begin program display in constant width font.
+.I x
+is the indent of the block; the default is .4 inches.
 .ti0
 \fL\&.P2\fP	-	yes	End program display.
 .ti0
@@ -253,9 +287,11 @@
 \fL\&.PP\fP	no	yes	Begin paragraph.
 First line indented.
 .ti0
-\fL\&.PS\fP \fIh w\fR	-	yes	Start picture; height
+\fL\&.PS\fP\ \fIh w\fR	-	yes	Start picture; height
 and width in inches.
 .ti0
+\fL\&.PT\fP	page no.	no	Top title, automatically invoked at head of page.
+.ti0
 \fL\&.PY\fP	-	no	`Bell Laboratories, Piscataway, New Jersey 08854'
 .ti0
 \fL\&.QE\fP	-	yes	End quoted material.
@@ -264,7 +300,12 @@
 .ti0
 \fL\&.QS\fP	-	yes	Begin quoted material (indent both margins).
 .ti0
-\fL\&.R\fP	yes	no	Roman text follows.
+\fL\&.R\fP\ \fIx y\fP	yes	no	Place
+.I x
+in roman font, appending
+.I y
+in the current font if given.
+If no argument switch to roman.
 .ti0
 \fL\&.RE\fP	-	yes	End relative indent level.
 .ti0
@@ -275,7 +316,7 @@
 \fL\&.RS\fP	-	yes	Start level of relative indentation
 from which subsequent indentation is measured.
 .ti0
-\fL\&.SG\fP \fIx\fR	no	yes	Insert signature(s) of author(s),
+\fL\&.SG\fP\ \fIx\fR	no	yes	Insert signature(s) of author(s),
 ignored except in
 .B .TM
 and
@@ -301,15 +342,18 @@
 Arguments are TM number, (quoted list of) case number(s), and file number.
 Must precede other requests.
 .ti0
-\fL\&.TR\fP \fIx\fR	-	-	Print in BTL technical report format; report number is \fIx\fR.  Must be first.
+\fL\&.TR\fP\ \fIx\fR	-	-	Print in BTL technical report format; report number is \fIx\fR.  Must be first.
 .ti0
-\fL\&.TS\fP \fIx\fR	-	yes	Begin table; if
+\fL\&.TS\fP\ \fIx\fR	-	yes	Begin table; if
 .I x
 is
 .B H
 table heading is repeated on new pages.
 .ti0
-\fL\&.UL\fP \fIx\fR	-	no	Underline argument (even in troff).
+\fL\&.UL\fP\ \fIx\fR	-	no	Underline argument (even in troff).
+.ti0
+\fL\&.US\fP\ \fIx\fP	-	no	'the UNIX operating system\fIx\fP';
+first use gives registered trakemark notice after 'UNIX.'
 .ti0
 \fL\&.UX\fP\ \fIy z\fP	-	no	`\fIz\fRUNIX\fIy\fP';
 first use gives registered trademark notice.