version 1.203, 2011/08/19 10:19:55 |
version 1.208, 2011/09/02 19:37:35 |
Line 98 or a single one character sequence. |
|
Line 98 or a single one character sequence. |
|
Examples: |
Examples: |
.Bl -tag -width Ds -offset indent -compact |
.Bl -tag -width Ds -offset indent -compact |
.It Li \e(em |
.It Li \e(em |
em dash |
Two-letter em dash escape. |
.It Li \ee |
.It Li \ee |
backslash |
One-letter backslash escape. |
.El |
.El |
.Pp |
.Pp |
See |
See |
|
|
Examples: |
Examples: |
.Bl -tag -width Ds -offset indent -compact |
.Bl -tag -width Ds -offset indent -compact |
.It Li \efBbold\efR |
.It Li \efBbold\efR |
write in bold, then switch to regular |
Write in bold, then switch to regular font mode. |
.It Li \efIitalic\efP |
.It Li \efIitalic\efP |
write in italic, then return to previous |
Write in italic, then return to previous font mode. |
.El |
.El |
.Pp |
.Pp |
Text decoration is |
Text decoration is |
|
|
Examples: |
Examples: |
.Bl -tag -width Ds -offset indent -compact |
.Bl -tag -width Ds -offset indent -compact |
.It Li \e*(Am |
.It Li \e*(Am |
ampersand |
Two-letter ampersand predefined string. |
.It Li \e*(Ba |
.It Li \e*q |
vertical bar |
One-letter double-quote predefined string. |
.El |
.El |
.Pp |
.Pp |
These strings are set using |
These strings are set using |
Line 176 In the rare case that a blank character is needed at t |
|
Line 176 In the rare case that a blank character is needed at t |
|
input line, it may be forced by |
input line, it may be forced by |
.Sq \e\ \e& . |
.Sq \e\ \e& . |
.Pp |
.Pp |
In general, space characters can be considered as non-whitespace |
In general, space characters can be rendered as literal |
characters by using non-breaking space escapes or |
characters by using non-breaking space escapes or |
.Sx Quotation . |
.Sx Quotation . |
.Pp |
.Pp |
Line 197 terminates the literal, regardless of surrounding whit |
|
Line 197 terminates the literal, regardless of surrounding whit |
|
Examples: |
Examples: |
.Bl -tag -width Ds -offset indent -compact |
.Bl -tag -width Ds -offset indent -compact |
.It Li .Fn strlen \(dqconst char *s\(dq |
.It Li .Fn strlen \(dqconst char *s\(dq |
groups |
Group arguments |
.Qq const char *s |
.Qq const char *s |
into one term |
into one function argument. |
.Pq see Sx \&Fn |
If unspecified, |
|
.Qq const , |
|
.Qq char , |
|
and |
|
.Qq *s |
|
would be considered separate arguments. |
|
.Pq See Sx \&Fn . |
.It Li .Op \(dqFl a\(dq |
.It Li .Op \(dqFl a\(dq |
considers |
Consider |
.Qq \&Fl a |
.Qq \&Fl a |
as literal text |
as literal text instead of a flag macro. |
.Pq see Sx \&Op , \&Fl |
.Pq Aee Sx \&Op , \&Fl . |
.El |
.El |
.Ss Scaling Widths |
.Ss Scaling Widths |
Many macros support scaled widths for their arguments. |
Many macros support scaled widths for their arguments. |
|
|
\(lBbody...\(rB |
\(lBbody...\(rB |
\&.Yc |
\&.Yc |
.Ed |
.Ed |
.Pp |
.Bl -column "MacroX" "CallableX" "ParsedX" "closed by XXX" -offset indent |
.Bl -column -compact -offset indent "MacroX" "CallableX" "ParsedX" "closed by XXX" |
|
.It Em Macro Ta Em Callable Ta Em Parsed Ta Em Scope |
.It Em Macro Ta Em Callable Ta Em Parsed Ta Em Scope |
.It Sx \&Bd Ta \&No Ta \&No Ta closed by Sx \&Ed |
.It Sx \&Bd Ta \&No Ta \&No Ta closed by Sx \&Ed |
.It Sx \&Bf Ta \&No Ta \&No Ta closed by Sx \&Ef |
.It Sx \&Bf Ta \&No Ta \&No Ta closed by Sx \&Ef |
Line 716 has multiple heads. |
|
Line 721 has multiple heads. |
|
\&.Yo \(lB\-arg \(lBparm...\(rB\(rB \(lBhead... \(lBTa head...\(rB\(rB |
\&.Yo \(lB\-arg \(lBparm...\(rB\(rB \(lBhead... \(lBTa head...\(rB\(rB |
\(lBbody...\(rB |
\(lBbody...\(rB |
.Ed |
.Ed |
.Pp |
.Bl -column "MacroX" "CallableX" "ParsedX" "closed by XXXXXXXXXXX" -offset indent |
.Bl -column -compact -offset indent "MacroX" "CallableX" "ParsedX" "closed by XXXXXXXXXXX" |
|
.It Em Macro Ta Em Callable Ta Em Parsed Ta Em Scope |
.It Em Macro Ta Em Callable Ta Em Parsed Ta Em Scope |
.It Sx \&It Ta \&No Ta Yes Ta closed by Sx \&It , Sx \&El |
.It Sx \&It Ta \&No Ta Yes Ta closed by Sx \&It , Sx \&El |
.It Sx \&Nd Ta \&No Ta \&No Ta closed by Sx \&Sh |
.It Sx \&Nd Ta \&No Ta \&No Ta closed by Sx \&Sh |
|
|
\&.Yo \(lB\-arg \(lBparm...\(rB\(rB \(lBhead...\(rB \ |
\&.Yo \(lB\-arg \(lBparm...\(rB\(rB \(lBhead...\(rB \ |
\(lBbody...\(rB \&Yc \(lBtail...\(rB |
\(lBbody...\(rB \&Yc \(lBtail...\(rB |
.Ed |
.Ed |
.Pp |
.Bl -column "MacroX" "CallableX" "ParsedX" "closed by XXXX" -offset indent |
.Bl -column "MacroX" "CallableX" "ParsedX" "closed by XXXX" -compact -offset indent |
|
.It Em Macro Ta Em Callable Ta Em Parsed Ta Em Scope |
.It Em Macro Ta Em Callable Ta Em Parsed Ta Em Scope |
.It Sx \&Ac Ta Yes Ta Yes Ta opened by Sx \&Ao |
.It Sx \&Ac Ta Yes Ta Yes Ta opened by Sx \&Ao |
.It Sx \&Ao Ta Yes Ta Yes Ta closed by Sx \&Ac |
.It Sx \&Ao Ta Yes Ta Yes Ta closed by Sx \&Ac |
Line 786 end of the line. |
|
Line 789 end of the line. |
|
.Bd -literal -offset indent |
.Bd -literal -offset indent |
\&.Yo \(lB\-arg \(lBval...\(rB\(rB \(lBbody...\(rB \(lBres...\(rB |
\&.Yo \(lB\-arg \(lBval...\(rB\(rB \(lBbody...\(rB \(lBres...\(rB |
.Ed |
.Ed |
.Pp |
.Bl -column "MacroX" "CallableX" "ParsedX" -offset indent |
.Bl -column "MacroX" "CallableX" "ParsedX" -compact -offset indent |
|
.It Em Macro Ta Em Callable Ta Em Parsed |
.It Em Macro Ta Em Callable Ta Em Parsed |
.It Sx \&Aq Ta Yes Ta Yes |
.It Sx \&Aq Ta Yes Ta Yes |
.It Sx \&Bq Ta Yes Ta Yes |
.It Sx \&Bq Ta Yes Ta Yes |
|
|
lists. |
lists. |
It delimits blocks representing table cells; |
It delimits blocks representing table cells; |
these blocks have bodies, but no heads. |
these blocks have bodies, but no heads. |
.Pp |
.Bl -column "MacroX" "CallableX" "ParsedX" "closed by XXXX" -offset indent |
.Bl -column "MacroX" "CallableX" "ParsedX" "closed by XXXX" -compact -offset indent |
|
.It Em Macro Ta Em Callable Ta Em Parsed Ta Em Scope |
.It Em Macro Ta Em Callable Ta Em Parsed Ta Em Scope |
.It Sx \&Ta Ta Yes Ta Yes Ta closed by Sx \&Ta , Sx \&It |
.It Sx \&Ta Ta Yes Ta Yes Ta closed by Sx \&Ta , Sx \&It |
.El |
.El |
Line 841 then the macro accepts an arbitrary number of argument |
|
Line 842 then the macro accepts an arbitrary number of argument |
|
|
|
\&.Yo \(lB\-arg \(lBval...\(rB\(rB arg0 arg1 argN |
\&.Yo \(lB\-arg \(lBval...\(rB\(rB arg0 arg1 argN |
.Ed |
.Ed |
.Pp |
.Bl -column "MacroX" "CallableX" "ParsedX" "Arguments" -offset indent |
.Bl -column "MacroX" "CallableX" "ParsedX" "Arguments" -compact -offset indent |
|
.It Em Macro Ta Em Callable Ta Em Parsed Ta Em Arguments |
.It Em Macro Ta Em Callable Ta Em Parsed Ta Em Arguments |
.It Sx \&%A Ta \&No Ta \&No Ta >0 |
.It Sx \&%A Ta \&No Ta \&No Ta >0 |
.It Sx \&%B Ta \&No Ta \&No Ta >0 |
.It Sx \&%B Ta \&No Ta \&No Ta >0 |
Line 2302 line itself; on following lines, only the |
|
Line 2302 line itself; on following lines, only the |
|
.Sx \&Ta |
.Sx \&Ta |
macro can be used to delimit cells, and |
macro can be used to delimit cells, and |
.Sx \&Ta |
.Sx \&Ta |
is only recognized as a macro when called by other macros, |
is only recognised as a macro when called by other macros, |
not as the first macro on a line. |
not as the first macro on a line. |
.Pp |
.Pp |
Note that quoted strings may span tab-delimited cells on an |
Note that quoted strings may span tab-delimited cells on an |
Line 3094 Newer groff and mandoc print |
|
Line 3094 Newer groff and mandoc print |
|
and the arguments. |
and the arguments. |
.It |
.It |
.Sx \&Bl Fl column |
.Sx \&Bl Fl column |
does not recognize trailing punctuation characters when they immediately |
does not recognise trailing punctuation characters when they immediately |
precede tabulator characters, but treats them as normal text and |
precede tabulator characters, but treats them as normal text and |
outputs a space before them. |
outputs a space before them. |
.It |
.It |
Line 3206 The following features are unimplemented in mandoc: |
|
Line 3206 The following features are unimplemented in mandoc: |
|
.Fl offset Ar center |
.Fl offset Ar center |
and |
and |
.Fl offset Ar right . |
.Fl offset Ar right . |
Groff does not implement centered and flush-right rendering either, |
Groff does not implement centred and flush-right rendering either, |
but produces large indentations. |
but produces large indentations. |
.It |
.It |
The |
The |