1 .\" $Id: mandoc.1,v 1.106 2014/08/08 01:50:59 schwarze Exp $
3 .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
4 .\" Copyright (c) 2012, 2014 Ingo Schwarze <schwarze@openbsd.org>
6 .\" Permission to use, copy, modify, and distribute this software for any
7 .\" purpose with or without fee is hereby granted, provided that the above
8 .\" copyright notice and this permission notice appear in all copies.
10 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
18 .Dd $Mdocdate: August 8 2014 $
23 .Nd format and display UNIX manuals
28 .Op Fl I Cm os Li = Ar name
40 manual pages for display.
48 text from stdin, implying
54 The arguments are as follows:
57 .It Fl I Cm os Li = Ar name
59 Override the default operating system
69 for available formats.
73 Comma-separated output options.
78 for available formats.
82 Print version and exit.
84 Specify the minimum message
86 to be reported on the standard error output and to affect the exit status.
109 to exit after parsing a file that causes warnings or errors of at least
111 No formatted output will be produced from that file.
116 are requested, they can be joined with a comma, for example
117 .Fl W Ns Cm error , Ns Cm stop .
119 Read input from zero or more files.
120 If unspecified, reads from stdin.
121 If multiple files are specified,
123 will halt with the first failed parse.
143 should only be used for legacy manuals.
147 which is also the default, determines encoding on-the-fly: if the first
154 parser is used; otherwise, the
159 files are specified with
161 each has its file-type determined this way.
162 If multiple files are
167 is specified, then this format is used exclusively.
171 utility accepts the following
173 arguments, which correspond to output modes:
174 .Bl -tag -width "-Tlocale"
176 Produce 7-bit ASCII output.
181 Produce strict CSS1/HTML-4.01 output.
185 Parse only: produce no output.
187 .Fl W Ns Cm warning .
188 .It Fl T Ns Cm locale
189 Encode output using the current locale.
203 Produce PostScript output.
205 .Sx PostScript Output .
207 Produce an indented parse tree.
209 Encode output in the UTF\-8 multi-byte format.
213 Produce strict CSS1/XHTML-1.0 output.
218 If multiple input files are specified, these will be processed by the
219 corresponding filter in-order.
223 which is the default, is rendered in standard 7-bit ASCII documented in
226 Font styles are applied by using back-spaced encoding such that an
230 .Sq _ Ns \e[bs] Ns c ,
233 is the back-space character number 8.
234 Emboldened characters are rendered as
235 .Sq c Ns \e[bs] Ns c .
237 The special characters documented in
239 are rendered best-effort in an ASCII equivalent.
240 If no equivalent is found,
244 Output width is limited to 78 visible columns unless literal input lines
249 arguments are accepted:
251 .It Cm indent Ns = Ns Ar indent
252 The left margin for normal text is set to
254 blank characters instead of the default of five for
258 Increasing this is not recommended; it may result in degraded formatting,
259 for example overfull lines or ugly line breaks.
260 .It Cm width Ns = Ns Ar width
261 The output width is set to
263 which will normalise to \(>=60.
268 conforms to HTML-4.01 strict.
271 .Pa example.style.css
272 file documents style-sheet classes available for customising output.
273 If a style-sheet is not specified with
276 defaults to simple output readable in any graphical or text-based web
279 Special characters are rendered in decimal-encoded UTF\-8.
283 arguments are accepted:
293 elements and only emit the subtree below the
298 argument will be ignored.
299 This is useful when embedding manual content within existing documents.
300 .It Cm includes Ns = Ns Ar fmt
305 is used as a template for linked header files (usually via the
310 are replaced with the include filename.
311 The default is not to present a
313 .It Cm man Ns = Ns Ar fmt
317 .Ar ../html%S/%N.%S.html ,
318 is used as a template for linked manuals (usually via the
325 are replaced with the linked manual's name and section, respectively.
326 If no section is included, section 1 is assumed.
327 The default is not to
329 .It Cm style Ns = Ns Ar style.css
332 is used for an external style-sheet.
333 This must be a valid absolute or
337 Locale-depending output encoding is triggered with
339 This option is not available on all systems: systems without locale
340 support, or those whose internal representation is not natively UCS-4,
345 for font style specification and available command-line arguments.
347 Translate input format into
350 This is useful for distributing manual sources to legacy systems
357 is passed as input, it is translated into
359 If the input format is
361 the input is copied to the output, expanding any
365 The parser is also run, and as usual, the
369 are displayed before copying the input to the output.
371 PDF-1.1 output may be generated by
374 .Sx PostScript Output
377 arguments and defaults.
378 .Ss PostScript Output
381 Level-2 pages may be generated by
383 Output pages default to letter sized and are rendered in the Times font
385 Margins are calculated as 1/9 the page length and width.
388 Special characters are rendered as in
393 arguments are accepted:
395 .It Cm paper Ns = Ns Ar name
405 You may also manually specify dimensions as
407 width by height in millimetres.
408 If an unknown value is encountered,
415 to force a UTF\-8 locale.
418 for details and options.
422 conforms to XHTML-1.0 strict.
426 for details; beyond generating XHTML tags instead of HTML tags, these
427 output modes are identical.
431 utility exits with one of the following values, controlled by the message
437 .Bl -tag -width Ds -compact
439 No warnings or errors occurred, or those that did were ignored because
440 they were lower than the requested
443 At least one warning occurred, but no error, and
447 At least one parsing error occurred, but no fatal error, and
453 A fatal parsing error occurred.
455 Invalid command line arguments were specified.
456 No input files have been read.
458 An operating system error occurred, for example memory exhaustion or an
459 error accessing input files.
462 to exit at once, possibly in the middle of parsing or formatting a file.
468 .Fl W Ns Cm warning .
470 To page manuals to the terminal:
472 .Dl $ mandoc \-Wall,stop mandoc.1 2\*(Gt&1 | less
473 .Dl $ mandoc mandoc.1 mdoc.3 mdoc.7 | less
475 To produce HTML manuals with
479 .Dl $ mandoc \-Thtml -Ostyle=style.css mdoc.7 \*(Gt mdoc.7.html
481 To check over a large set of manuals:
483 .Dl $ mandoc \-Tlint `find /usr/src -name \e*\e.[1-9]`
485 To produce a series of PostScript manuals for A4 paper:
487 .Dl $ mandoc \-Tps \-Opaper=a4 mdoc.7 man.7 \*(Gt manuals.ps
493 format, for use on systems lacking an
497 .Dl $ mandoc \-Tman foo.mdoc \*(Gt foo.man
499 Messages displayed by
503 .D1 Nm Ns : Ar file : Ns Ar line : Ns Ar column : level : message : macro args
505 Line and column numbers start at 1.
506 Both are omitted for messages referring to an input file as a whole.
507 Macro names and arguments are omitted where meaningless.
508 Fatal messages about invalid command line arguments
509 or operating system errors, for example when memory is exhausted,
516 Message levels have the following meanings:
517 .Bl -tag -width "warning"
519 Opening or reading an input file failed, so the parser cannot
520 even be started and no output is produced from that input file.
522 The parser is unable to parse a given input file at all.
523 No formatted output is produced from that input file.
525 An input file contains syntax that cannot be safely interpreted,
526 either because it is invalid or because
528 does not implement it yet.
529 By discarding part of the input or inserting missing tokens,
530 the parser is able to continue, and the error does not prevent
531 generation of formatted output, but typically, preparing that
532 output involves information loss, broken document structure
533 or unintended formatting.
535 An input file uses obsolete, discouraged or non-portable syntax.
536 All the same, the meaning of the input is unambiguous and a correct
537 rendering can be produced.
538 Documents causing warnings may render poorly when using other
539 formatting tools instead of
547 levels are hidden unless their level, or a lower level, is requested using a
552 .Ss Warnings related to the document prologue
554 .It Sy "missing manual title, using UNTITLED"
558 macro has no arguments, or there is no
560 macro before the first non-prologue macro.
561 .It Sy "missing manual title, using \(dq\(dq"
565 macro, or it has no arguments.
566 .It Sy "lower case character in document title"
568 The title is still used as given in the
573 .It Sy "missing manual section, using \(dq\(dq"
579 macro lacks the mandatory section argument.
580 .It Sy "unknown manual section"
582 The section number in a
584 line is invalid, but still used.
585 .It Sy "unknown manual volume or arch"
589 line is invalid, but still used.
590 The manual is assumed to be architecture-independent.
591 .It Sy "missing date, using today's date"
593 The document was parsed as
599 macro has no arguments or only empty arguments;
600 or the document was parsed as
606 macro has less than three arguments or its third argument is empty.
607 .It Sy "cannot parse date, using it verbatim"
613 macro does not follow the conventional format.
614 .It Sy "missing Os macro, using \(dq\(dq"
616 The default or current system is not shown in this case.
617 .It Sy "duplicate prologue macro"
619 One of the prologue macros occurs more than once.
620 The last instance overrides all previous ones.
621 .It Sy "late prologue macro"
627 macro occurs after some non-prologue macro, but still takes effect.
628 .It Sy "skipping late title macro"
632 macro can only occur before the first non-prologue macro
633 because traditional formatters write the page header
634 before parsing the document body.
635 Even though this technical restriction does not apply to
637 traditional semantics is preserved.
638 The late macro is discarded including its arguments.
639 .It Sy "prologue macros out of order"
641 The prologue macros are not given in the conventional order
645 All three macros are used even when given in another order.
647 .Ss Warnings regarding document structure
649 .It Sy ".so is fragile, better use ln(1)"
651 Including files only works when the parser program runs with the correct
652 current working directory.
653 .It Sy "no document body"
655 The document body contains neither text nor macros.
656 An empty document is shown, consisting only of a header and a footer line.
657 .It Sy "content before first section header"
659 Some macros or text precede the first
664 The offending macros and text are parsed and added to the top level
665 of the syntax tree, outside any section block.
666 .It Sy "first section is not NAME"
668 The argument of the first
676 .It Sy "bad NAME section contents"
678 The last node in the NAME section is not an
680 macro, or any preceding macro is not
682 or the NAME section is completely empty.
687 .It Sy "sections out of conventional order"
689 A standard section occurs after another section it usually precedes.
690 All section titles are used as given,
691 and the order of sections is not changed.
692 .It Sy "duplicate section title"
694 The same standard section title occurs more than once.
695 .It Sy "unexpected section"
697 A standard section header occurs in a section of the manual
698 where it normally isn't useful.
700 .Ss "Warnings related to macros and nesting"
702 .It Sy "obsolete macro"
706 manual for replacements.
707 .It Sy "skipping paragraph macro"
710 documents, this happens
713 at the beginning and end of sections and subsections
715 right before non-compact lists and displays
717 at the end of items in non-column, non-compact lists
719 and for multiple consecutive paragraph macros.
723 documents, it happens
735 macros having neither head nor body arguments
746 .It Sy "moving paragraph macro out of list"
750 list contains a trailing paragraph macro.
751 The paragraph macro is moved after the end of the list.
752 .It Sy "skipping no-space macro"
754 An input line begins with an
757 The macro is ignored.
758 .It Sy "blocks badly nested"
760 If two blocks intersect, one should completely contain the other.
761 Otherwise, rendered output is likely to look strange in any output
762 format, and rendering in SGML-based output formats is likely to be
763 outright wrong because such languages do not support badly nested
765 Typical examples of badly nested blocks are
766 .Qq Ic \&Ao \&Bo \&Ac \&Bc
768 .Qq Ic \&Ao \&Bq \&Ac .
776 .It Sy "nested displays are not portable"
783 display occurs nested inside another
788 but fails with most other implementations.
789 .It Sy "moving content out of list"
793 list block contains text or macros before the first
796 The offending children are moved before the beginning of the list.
797 .It Sy ".Vt block has child macro"
801 macro supports plain text arguments only.
802 Formatting may be ugly and semantic searching
803 for the affected content might not work.
804 .It Sy "fill mode already enabled, skipping"
808 request occurs even though the document is still in fill mode,
809 or already switched back to fill mode.
811 .It Sy "fill mode already disabled, skipping"
815 request occurs even though the document already switched to no-fill mode
816 and did not switch back to fill mode yet.
818 .It Sy "line scope broken"
820 While parsing the next-line scope of the previous macro,
821 another macro is found that prematurely terminates the previous one.
822 The previous, interrupted macro is deleted from the parse tree.
824 .Ss "Warnings related to missing arguments"
826 .It Sy "skipping empty request"
828 The macro name is missing from a macro definition request.
829 .It Sy "conditional request controls empty scope"
831 A conditional request is only useful if any of the following
832 follows it on the same logical input line:
837 keyword to open a multi-line scope.
839 A request or macro or some text, resulting in a single-line scope.
841 The immediate end of the logical line without any intervening whitespace,
842 resulting in next-line scope.
844 Here, a conditional request is followed by trailing whitespace only,
845 and there is no other content on its logical input line.
846 Note that it doesn't matter whether the logical input line is split
847 across multiple physical input lines using
849 line continuation characters.
850 This is one of the rare cases
851 where trailing whitespace is syntactically significant.
852 The conditional request controls a scope containing whitespace only,
853 so it is unlikely to have a significant effect,
854 except that it may control a following
857 .It Sy "skipping empty macro"
859 The indicated macro has no arguments and hence no effect.
860 .It Sy "empty argument, using 0n"
862 The required width is missing after
869 .It Sy "argument count wrong"
871 The indicated macro has too few or too many arguments.
872 The syntax tree will contain the wrong number of arguments as given.
873 Formatting behaviour depends on the specific macro in question.
874 Note that the same message may also occur as an ERROR, see below.
875 .It Sy "missing display type, using -ragged"
879 macro is invoked without the required display type.
880 .It Sy "list type is not the first argument"
884 macro, at least one other argument precedes the type argument.
887 utility copes with any argument order, but some other
889 implementations do not.
890 .It Sy "missing -width in -tag list, using 8n"
899 .It Sy "missing utility name, using \(dq\(dq"
903 macro is called without an argument before
905 has first been called with an argument.
906 .It Sy "empty head in list item"
918 macro lacks the required argument.
919 The item head is left empty.
920 .It Sy "empty list item"
932 An empty list item is shown.
933 .It Sy "missing font type"
937 macro has no argument.
938 It switches to the default font,
940 .It Sy "unknown font type"
948 .It Sy "missing -std argument, adding it"
954 macro lacks the required
961 even when it is not specified, but other implementations may not.
963 .Ss "Warnings related to bad macro arguments"
965 .It Sy "unterminated quoted argument"
967 Macro arguments can be enclosed in double quote characters
968 such that space characters and macro names contained in the quoted
969 argument need not be escaped.
970 The closing quote of the last argument of a macro can be omitted.
971 However, omitting it is not recommended because it makes the code
973 .It Sy "duplicate argument"
979 macro has more than one
986 All but the last instances of these arguments are ignored.
987 .It Sy "skipping duplicate argument"
991 macro has more than one
996 All but the first of these arguments are ignored.
997 .It Sy "skipping duplicate display type"
1001 macro has more than one type argument; the first one is used.
1002 .It Sy "skipping duplicate list type"
1006 macro has more than one type argument; the first one is used.
1007 .It Sy "skipping -width argument"
1021 .It Sy "unknown AT&T UNIX version"
1025 macro has an invalid argument.
1026 It is used verbatim, with
1029 .It Sy "invalid content in Rs block"
1033 block contains plain text or non-% macros.
1034 The bogus content is left in the syntax tree.
1035 Formatting may be poor.
1036 .It Sy "invalid Boolean argument"
1040 macro has an argument other than
1044 The invalid argument is moved out of the macro, which leaves the macro
1045 empty, causing it to toggle the spacing mode.
1046 .It Sy "unknown font, skipping request"
1051 request has an invalid argument.
1053 .Ss "Warnings related to plain text"
1055 .It Sy "blank line in fill mode, using .sp"
1057 The meaning of blank input lines is only well-defined in non-fill mode:
1058 In fill mode, line breaks of text input lines are not supposed to be
1060 However, for compatibility with groff, blank lines in fill mode
1064 .It Sy "tab in filled text"
1066 The meaning of tab characters is only well-defined in non-fill mode:
1067 In fill mode, whitespace is not supposed to be significant
1068 on text input lines.
1069 As an implementation dependent choice, tab characters on text lines
1070 are passed through to the formatters in any case.
1071 Given that the text before the tab character will be filled,
1072 it is hard to predict which tab stop position the tab will advance to.
1073 .It Sy "whitespace at end of input line"
1074 .Pq mdoc , man , roff
1075 Whitespace at the end of input lines is almost never semantically
1076 significant \(em but in the odd case where it might be, it is
1077 extremely confusing when reviewing and maintaining documents.
1078 .It Sy "bad comment style"
1080 Comment lines start with a dot, a backslash, and a double-quote character.
1083 utility treats the line as a comment line even without the backslash,
1084 but leaving out the backslash might not be portable.
1085 .It Sy "invalid escape sequence"
1087 An escape sequence has an invalid opening argument delimiter, lacks the
1088 closing argument delimiter, or the argument has too few characters.
1089 If the argument is incomplete,
1093 expand to an empty string,
1099 to the length of the incomplete argument.
1100 All other invalid escape sequences are ignored.
1101 .It Sy "undefined string, using \(dq\(dq"
1103 If a string is used without being defined before,
1104 its value is implicitly set to the empty string.
1105 However, defining strings explicitly before use
1106 keeps the code more readable.
1108 .Ss "Errors related to equations"
1110 .It "unexpected equation scope closure"
1111 .It "equation scope open on exit"
1112 .It "overlapping equation scopes"
1113 .It "unexpected end of equation"
1114 .It "equation syntax error"
1116 .Ss "Errors related to tables"
1118 .It "bad table syntax"
1119 .It "bad table option"
1120 .It "bad table layout"
1121 .It "no table layout cells specified"
1122 .It "no table data cells specified"
1123 .It "ignore data in cell"
1124 .It "data block still open"
1125 .It "ignoring extra data cells"
1127 .Ss "Errors related to roff, mdoc, and man code"
1129 .It Sy "input stack limit exceeded, infinite loop?"
1131 Explicit recursion limits are implemented for the following features,
1132 in order to prevent infinite loops:
1135 expansion of nested escape sequences
1136 including expansion of strings and number registers,
1138 expansion of nested user-defined macros,
1144 When a limit is hit, the output is incorrect, typically losing
1145 some content, but the parser can continue.
1146 .It Sy "skipping bad character"
1147 .Pq mdoc , man , roff
1148 The input file contains a byte that is not a printable
1151 The message mentions the character number.
1152 The offending byte is replaced with a question mark
1154 Consider editing the input file to replace the byte with an ASCII
1155 transliteration of the intended character.
1156 .It Sy "skipping unknown macro"
1157 .Pq mdoc , man , roff
1158 The first identifier on a request or macro line is neither recognized as a
1160 request, nor as a user-defined macro, nor, respectively, as an
1165 It may be mistyped or unsupported.
1166 The request or macro is discarded including its arguments.
1167 .It Sy "skipping item outside list"
1171 macro occurs outside any
1174 It is discarded including its arguments.
1175 .It Sy "skipping column outside column list"
1179 macro occurs outside any
1182 It is discarded including its arguments.
1183 .It Sy "skipping end of block that is not open"
1184 .Pq mdoc , man , eqn , tbl , roff
1185 Various syntax elements can only be used to explicitly close blocks
1186 that have previously been opened.
1189 block closing macro, a
1194 macro, or the end of an equation, table, or
1196 conditional request is encountered but no matching block is open.
1197 The offending request or macro is discarded.
1198 .It Sy "inserting missing end of block"
1202 macros as well as tables require explicit closing by dedicated macros.
1203 A block that doesn't support bad nesting
1204 ends before all of its children are properly closed.
1205 The open child nodes are closed implicitly.
1206 .It Sy "scope open on exit"
1207 .Pq mdoc , man , eqn , tbl , roff
1208 At the end of the document, an explicit
1216 block, an equation, table, or
1218 conditional or ignore block is still open.
1219 The open block is closed implicitly.
1220 .It Sy "escaped character not allowed in a name"
1222 Macro, string and register identifiers consist of printable,
1223 non-whitespace ASCII characters.
1224 Escape sequences and characters and strings expressed in terms of them
1225 cannot form part of a name.
1226 The first argument of an
1234 request, or any argument of an
1236 request, or the name of a request or user defined macro being called,
1237 is terminated by an escape sequence.
1243 the request has no effect at all.
1250 what was parsed up to this point is used as the arguments to the request,
1251 and the rest of the input line is discarded including the escape sequence.
1252 When parsing for a request or a user-defined macro name to be called,
1253 only the escape sequence is discarded.
1254 The characters preceding it are used as the request or macro name,
1255 the characters following it are used as the arguments to the request or macro.
1256 .It Sy "argument count wrong"
1257 .Pq mdoc , man , roff
1258 The indicated request or macro has too few or too many arguments.
1259 The syntax tree will contain the wrong number of arguments as given.
1260 Formatting behaviour depends on the specific request or macro in question.
1261 Note that the same message may also occur as a WARNING, see above.
1262 .It Sy "missing list type, using -item"
1266 macro fails to specify the list type.
1267 .It Sy "missing manual name, using \(dq\(dq"
1271 lacks the required argument.
1272 .It Sy "uname(3) system call failed, using UNKNOWN"
1276 macro is called without arguments, and the
1281 can be compiled with
1283 .Fl D Cm OSNAME=\(dq\e\(dq Ar string Cm \e\(dq\(dq .
1285 .It Sy "unknown standard specifier"
1289 macro has an unknown argument and is discarded.
1290 .It Sy "skipping request without numeric argument"
1294 request has a non-numeric or negative argument or no argument at all.
1295 The invalid request is ignored.
1296 .It Sy "skipping all arguments"
1297 .Pq mdoc , man , eqn , roff
1310 macro in a list that don't support item heads, a
1322 block closing request is invoked with at least one argument.
1323 All arguments are ignored.
1324 .It Sy "skipping excess arguments"
1328 macro is invoked with more than one argument, or a request of the
1330 family is invoked with more than two arguments.
1331 The excess arguments are ignored.
1335 .It Sy "input too large"
1339 cannot handle input files larger than its arbitrary size limit
1340 of 2^31 bytes (2 Gigabytes).
1341 Since useful manuals are always small, this is not a problem in practice.
1342 Parsing is aborted as soon as the condition is detected.
1343 .It Sy "NOT IMPLEMENTED: Bd -file"
1345 For security reasons, the
1347 macro does not support the
1350 By requesting the inclusion of a sensitive file, a malicious document
1351 might otherwise trick a privileged user into inadvertently displaying
1352 the file on the screen, revealing the file content to bystanders.
1353 The parser exits immediately.
1354 .It Sy "NOT IMPLEMENTED: .so with absolute path or \(dq..\(dq"
1356 For security reasons,
1360 file inclusion requests only with relative paths
1361 and only without ascending to any parent directory.
1362 By requesting the inclusion of a sensitive file, a malicious document
1363 might otherwise trick a privileged user into inadvertently displaying
1364 the file on the screen, revealing the file content to bystanders.
1365 The parser exits immediately.
1366 .It Sy ".so request failed"
1370 request requires reading an external file.
1371 While trying to do so, an
1377 The parser exits immediately.
1378 Before showing this message,
1380 always shows another message explaining why the system call failed.
1383 This section summarises
1385 compatibility with GNU troff.
1386 Each input and output format is separately noted.
1387 .Ss ASCII Compatibility
1388 .Bl -bullet -compact
1390 Unrenderable unicode codepoints specified with
1392 escapes are printed as
1395 In GNU troff, these raise an error.
1405 are synonyms, as are \-filled and \-ragged.
1407 In historic GNU troff, the
1410 macro does not underline when scoped under an
1412 in the FILES section.
1413 This behaves correctly in
1416 A list or display following the
1421 does not assert a prior vertical break, just as it doesn't with
1431 Words aren't hyphenated.
1433 .Ss HTML/XHTML Compatibility
1434 .Bl -bullet -compact
1438 escape will revert the font to the previous
1440 escape, not to the last rendered decoration, which is now dictated by
1441 CSS instead of hard-coded.
1442 It also will not span past the current scope,
1443 for the same reason.
1446 mode, this will work fine.
1453 list types render similarly (no break following overreached left-hand
1454 side) due to the expressive constraints of HTML.
1461 lists render similarly.
1473 utility was written by
1474 .An Kristaps Dzonsons Aq Mt kristaps@bsd.lv .
1480 the maximum size of an element attribute is determined by
1482 which is usually 1024 bytes.
1483 Be aware of this when setting long link
1485 .Fl O Ns Cm style Ns = Ns Ar really/long/link .
1487 Nesting elements within next-line element scopes of
1497 and cause them to forget the formatting of the prior next-line scope.
1501 control character is an alias for the standard macro control character
1502 and does not emit a line-break as stipulated in GNU troff.
projects / dragonfly.git / blob