View | Details | Raw Unified | Return to bug 15781
Collapse All | Expand All

(-)mdoc.samples.7 (-8 / +10 lines)
Lines 71-77 Link Here
71
make up the
71
make up the
72
.Em "page structure domain"
72
.Em "page structure domain"
73
which consists of macros for titles, section headers, displays
73
which consists of macros for titles, section headers, displays
74
and lists. Essentially items which affect the physical position
74
and lists.
75
Essentially items which affect the physical position
75
of text on a formatted page.
76
of text on a formatted page.
76
In addition to the page structure domain, there are two more domains,
77
In addition to the page structure domain, there are two more domains,
77
the manual domain and the general text domain.
78
the manual domain and the general text domain.
Lines 790-797 Link Here
790
.Dl Li sptr, ptr),
791
.Dl Li sptr, ptr),
791
.Pp
792
.Pp
792
The punctuation is not recognized and all is output in the
793
The punctuation is not recognized and all is output in the
793
literal font. If the punctuation is separated by a leading
794
literal font.
794
white space:
795
If the punctuation is separated by a leading white space:
795
.Pp
796
.Pp
796
.Dl \&.Li "sptr , ptr ) ,"
797
.Dl \&.Li "sptr , ptr ) ,"
797
.Pp
798
.Pp
Lines 817-824 Link Here
817
The problem is that
818
The problem is that
818
.Xr troff
819
.Xr troff
819
may assume it is supposed to actually perform the operation
820
may assume it is supposed to actually perform the operation
820
or evaluation suggested by the characters.  To prevent
821
or evaluation suggested by the characters.
821
the accidental evaluation of these characters,
822
To prevent the accidental evaluation of these characters,
822
escape them with
823
escape them with
823
.Ql \e& .
824
.Ql \e& .
824
Typical syntax is shown in the first content macro displayed
825
Typical syntax is shown in the first content macro displayed
Lines 1133-1139 Link Here
1133
may be used with
1134
may be used with
1134
.Ql \&.Fa
1135
.Ql \&.Fa
1135
(function argument)
1136
(function argument)
1136
to get around the limitation. For example:
1137
to get around the limitation.
1138
For example:
1137
.Bd -literal -offset indent
1139
.Bd -literal -offset indent
1138
\&.Fo "int res_mkquery"
1140
\&.Fo "int res_mkquery"
1139
\&.Fa "int op"
1141
\&.Fa "int op"
Lines 1282-1288 Link Here
1282
The
1284
The
1283
.Ql \&.Op
1285
.Ql \&.Op
1284
macro
1286
macro
1285
places option brackets around the any remaining arguments on the command
1287
places option brackets around any remaining arguments on the command
1286
line, and places any
1288
line, and places any
1287
trailing punctuation outside the brackets.
1289
trailing punctuation outside the brackets.
1288
The macros
1290
The macros
Lines 2729-2735 Link Here
2729
where
2731
where
2730
.Em x
2732
.Em x
2731
is the name of the string.
2733
is the name of the string.
2732
The interpreting sequence may be used any where in the text.
2734
The interpreting sequence may be used anywhere in the text.
2733
.Pp
2735
.Pp
2734
.Bl -column "String " "Nroff " "Troff " -offset indent
2736
.Bl -column "String " "Nroff " "Troff " -offset indent
2735
.It Sy "String	Nroff	Troff"
2737
.It Sy "String	Nroff	Troff"

Return to bug 15781