version 1.203, 2011/08/19 10:19:55 |
version 1.206, 2011/08/30 12:16:36 |
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 -offset indent "MacroX" "CallableX" "ParsedX" "closed by XXX" |
.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 -offset indent "MacroX" "CallableX" "ParsedX" "closed by XXXXXXXXXXX" |
.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 |