diff options
| author | Dmitri Vereshchagin <dmitri.vereshchagin@gmail.com> | 2024-01-31 20:47:13 +0300 |
|---|---|---|
| committer | Dan Cross <crossd@gmail.com> | 2025-07-27 09:58:50 -0400 |
| commit | 10564b11755ff2d48d0f5073c46571e806fa6fb4 (patch) | |
| tree | 229252742051d83558fff2352642d0f57ba66615 /man/man3/fmtinstall.3 | |
| parent | 00446db7d8fdb3ea56fa104643b34823960f7be2 (diff) | |
| download | plan9port-10564b11755ff2d48d0f5073c46571e806fa6fb4.tar.gz plan9port-10564b11755ff2d48d0f5073c46571e806fa6fb4.zip | |
tmac/tmac.an: define .MR in a groff compatible way
groff 1.23.0 added .MR to its -man macro package. The NEWS file states
that the inclusion of the macro "was prompted by its introduction to
Plan 9 from User Space's troff in August 2020." From d32deab it seems
that the name for Plan 9 from User Space's implementation was suggested
by groff maintainer G. Brandon Robinson.
Not sure if the intention was to make these definitions compatible, but
it would be nice if they were.
Currently, Plan 9 from User Space's .MR expects its second argument to
be parenthesized. groff's .MR does not. This results in extra
parentheses appearing in manual references when viewing Plan 9 from User
Space's manual pages on a system using groff.
Diffstat (limited to 'man/man3/fmtinstall.3')
| -rw-r--r-- | man/man3/fmtinstall.3 | 20 |
1 files changed, 10 insertions, 10 deletions
diff --git a/man/man3/fmtinstall.3 b/man/man3/fmtinstall.3 index b68cd008..a9640267 100644 --- a/man/man3/fmtinstall.3 +++ b/man/man3/fmtinstall.3 @@ -94,16 +94,16 @@ int fmtrunestrcpy(Fmt *f, Rune *s); int errfmt(Fmt *f); .SH DESCRIPTION The interface described here allows the construction of custom -.MR print (3) +.MR print 3 verbs and output routines. In essence, they provide access to the workings of the formatted print code. .PP The -.MR print (3) +.MR print 3 suite maintains its state with a data structure called .BR Fmt . A typical call to -.MR print (3) +.MR print 3 or its relatives initializes a .B Fmt structure, passes it to subsidiary routines to process the output, @@ -154,7 +154,7 @@ to generate the output. These behave like .B fprint (see -.MR print (3) ) +.MR print 3 ) or .B vfprint except that the characters are buffered until @@ -207,7 +207,7 @@ In are the width and precision, and .IB fp ->flags the decoded flags for the verb (see -.MR print (3) +.MR print 3 for a description of these items). The standard flag values are: .B FmtSign @@ -282,7 +282,7 @@ produced. .PP Some internal functions may be useful to format primitive types. They honor the width, precision and flags as described in -.MR print (3) . +.MR print 3 . .I Fmtrune formats a single character .BR r . @@ -307,7 +307,7 @@ regardless of whether the output is bytes or runes. This function prints an error message with a variable number of arguments and then quits. Compared to the corresponding example in -.MR print (3) , +.MR print 3 , this version uses a smaller buffer, will never truncate the output message, but might generate multiple .B write @@ -364,9 +364,9 @@ main(...) .SH SOURCE .B \*9/src/lib9/fmt .SH SEE ALSO -.MR print (3) , -.MR utf (7) , -.MR errstr (3) +.MR print 3 , +.MR utf 7 , +.MR errstr 3 .SH DIAGNOSTICS These routines return negative numbers or nil for errors and set .IR errstr . |