gbranden pushed a commit to branch master in repository groff. commit a4f76b25aa6fc28674e4583efacada05cc72c141 Author: G. Branden Robinson <g.branden.robin...@gmail.com> AuthorDate: Wed Feb 10 16:43:44 2021 +1100
doc/ms.ms: Tweak style of section "Introduction". * Use two empty requests where vertical space is expected. * Refer to macro packages without using a leading hyphen. * Reflow. * Break input lines at commas. * Remove spurious hyphen before "groff". * Set multi-word parentheticals on their own input lines. * Center the measurement units table. * Set unit cells in Courier roman, since they're used as literal input. * Recast descriptions of v, n, m units. * Use typographer's quotes around "n" and "M". * Pluralize "pica" for consistency with other table rows. * Use an indented paragraph after the above table. * Use a centered, boxed table instead of a display for .nr/.ds example. * Comment the .nr/.ds examples. --- doc/ms.ms | 73 ++++++++++++++++++++++++++++++++++++++------------------------- 1 file changed, 44 insertions(+), 29 deletions(-) diff --git a/doc/ms.ms b/doc/ms.ms index 59d2d56..a784eb9 100644 --- a/doc/ms.ms +++ b/doc/ms.ms @@ -78,39 +78,53 @@ Introduction .XS Introduction .XE +. +. .LP The original -.I -ms +.I ms macros were included with .Acr AT&T .I troff -as well as the -.I -man +alongside the +.I man macros. +. While the -.I -man -package is intended for brief documents -that can be read on-line as well as printed, the -.I -ms -macros are suitable for longer documents that are meant to be -printed rather than read on-line. +.I man +package is intended for brief documents that can be read on-line as well +as printed, +the +.I ms +macros are suitable for longer documents that are meant to be printed +rather than read on-line. +. +. .PP The -.I -ms +.I ms macro package included with -.I -groff -is a complete, bottom-up re-implementation. -Several macros (specific to +.I groff +is a complete, +bottom-up re-implementation. +. +Several macros +(specific to .Acr AT&T -or Berkeley) are not included, +or Berkeley) +are not included, while several new commands are. +. See .I Differences from .Acr AT&T --ms\c +ms\c .R -, later in this document, for more information. +, later in this document, +for more information. +. +. .NH 2 Basic information .XS @@ -133,23 +147,24 @@ and can avoid problems in complex situations. . The following table summarizes typical units. . +. .TS -box; +box center; cb cb -c a . +cfCR l . Unit Description _ i inches c centimeters p points (1/72\[sd]) -v line height -n width of a letter ``n'' in the current font -m width of a letter ``M'' in the current font -P pica (1/6\[sd]) +v \[lq]vees\[rq]; height of a line using the current font +n \[lq]ens\[rq]; width of an \[lq]n\[rq] using the current font +m \[lq]ems\[rq]; width of an \[lq]M\[rq] using the current font +P picas (1/6\[sd]) .TE . . -.LP +.PP Set registers with using the .CW .nr request @@ -158,12 +173,12 @@ and strings with the request. . . -.DS -.CW -\&.nr PS 12 -\&.ds FAM P -.R -.DE +.TS +box center; +lfCR. +\&.nr PS 12 \[rs]" Use 12-point type. +\&.ds FAM P \[rs]" Use Palatino font family. +.TE . . .\" ------------------------ _______________________________________________ Groff-commit mailing list Groff-commit@gnu.org https://lists.gnu.org/mailman/listinfo/groff-commit