Lines Matching +full:ascii +full:. +full:d
1 .\" $Id: mandoc.1,v 1.267 2023/11/13 19:13:01 schwarze Exp $
2 .\"
3 .\" Copyright (c) 2012, 2014-2023 Ingo Schwarze <schwarze@openbsd.org>
4 .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
5 .\"
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.
9 .\"
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.
17 .\"
37 utility formats manual pages for display.
47 output.
58 would.
62 to paginate them.
63 This is the default.
65 .Fl a .
71 .Ic \&Os
74 .Ic \&TH
75 macro.
77 Specify the input encoding.
81 .Cm us-ascii ,
84 .Cm utf-8 .
91 .Cm utf-8 .
97 .D1 .\e" -*- Oo ...; Oc coding: Ar encoding ; No -*-
100 .Ar encoding .
102 If the first non-ASCII byte in the file introduces a valid UTF-8
104 .Cm utf-8 .
107 .Cm iso-8859-1 .
113 .Xr mdoc 7 .
117 .Xr man 7 .
120 .Ic \&Dd
122 .Ic \&Dt ,
127 parser is used.
130 is silently ignored.
132 Comma-separated output options.
134 .Ar options .
136 Select the output format.
140 .Cm ascii ,
150 .Cm utf8 .
154 mode only parses the input and produces no output.
158 error output, to standard output.
162 to be reported on the standard error output and to affect the exit status.
171 .Cm unsupp .
175 .Ic \&Os
180 return value.
188 conventions for a particular operating system.
192 .Cm base .
195 is silent.
200 for details.
207 the requested level.
208 No formatted output will be produced from that file.
214 .Fl W Cm error , Ns Cm stop .
216 Read from the given input file.
217 If multiple files are specified, they are processed in the given order.
220 reads from standard input.
226 .Xr man 1 .
237 manual.
240 are mutually exclusive and override each other.
241 .Ss ASCII Output
243 .Fl T Cm ascii
244 to force text output in 7-bit ASCII character encoding documented in the
245 .Xr ascii 7
248 set in the environment.
257 is the back-space character number 8.
259 .Sq c Ns \e[bs] Ns c .
262 .Xr ul 1 .
266 instead.
270 are rendered best-effort in an ASCII equivalent.
274 which agrees with all ASCII standards from 1965 to the latest
277 formatters represent single quotes in ASCII output.
278 This correct ASCII rendering may look strange with modern
279 Unicode-compatible fonts because contrary to ASCII, Unicode uses
281 quote.
290 blank characters instead of the default of five.
292 for example overfull lines or ugly line breaks.
294 wide, the default is reduced to three columns.
300 output style.
302 on the right side of the footer line.
307 source it was generated from.
312 rather than showing the manual page from the beginning.
317 number.
323 is used rather than the argument as a whole.
327 in the matching manual pages.
331 instead of the default of 78.
333 wide, the default is reduced to one less than the terminal width.
335 and may exceed the output width.
340 conforms to HTML5 using optional self-closing tags.
343 blocks use MathML.
344 Non-ASCII characters are rendered
345 as hexadecimal Unicode character references.
353 elements and only emit the subtree below the <body> element.
356 argument will be ignored.
357 This is useful when embedding manual content within existing documents.
362 .Ar ../src/%I.html ,
364 .Ic \&In
365 macro).
367 .Sq \&%I
368 are replaced with the include filename.
370 hyperlink.
375 .Ar ../html%S/%N.%S.html ,
377 .Ic \&Xr
378 macro).
380 .Sq \&%N
383 are replaced with the linked manual's name and section, respectively.
384 If no section is included, section 1 is assumed.
386 present a hyperlink.
388 .Ar %N.%S
390 otherwise, the second format is used.
391 .It Cm style Ns = Ns Ar style.css
393 .Ar style.css
394 is used as an external stylesheet.
396 relative URI.
399 .Pa mandoc.css
402 is recommended.
410 providing simple support for users who prefer a dark color scheme.
418 .Pa mandoc.css .
420 .Pa mandoc.css
426 is upgraded to a new version.
432 adequate font-style and font-weight attributes for various macros.
434 but does not aim for looking similar to terminal output.
436 and to user settings in the browser configuration.
439 .Sx ASCII Output .
443 rather than passing merely a file name.
453 .Xr less 1 .
460 URIs.
463 print a table of contents near the beginning of the output.
468 automatically selects UTF-8 or ASCII output according to the current
469 .Xr locale 1 .
479 .Sx ASCII Output .
481 .Fl T Cm locale .
489 output format.
493 formatters.
498 code is not supported.
502 the input is copied to the output.
507 are displayed before copying the input to the output.
514 .Lk https://daringfireball.net/projects/markdown/syntax.text\
515 "John Gruber's 2004 specification" .
517 .Lk https://commonmark.org/ CommonMark
518 specification.
520 The character set used for the markdown output is ASCII.
521 Non-ASCII characters are encoded as HTML entities.
524 non-ASCII characters are transliterated to ASCII approximations in
525 these contexts.
528 lost, and even part of the presentational markup may be lost.
532 directly.
541 output mode.
544 .Fl T Cm pdf .
549 arguments and defaults.
554 .Fl T Cm ps .
556 family, 11-point.
557 Margins are calculated as 1/9 the page length and width.
558 Line-height is 1.4m.
561 .Sx ASCII Output .
576 .Ar letter .
579 width by height in millimetres.
582 is used.
590 settings in the environment.
592 .Sx ASCII Output
595 arguments.
601 .Sx ASCII Output .
605 to show a human readable representation of the syntax tree.
606 It is useful for debugging the source code of manual pages.
607 The exact format is subject to change, so don't write parsers for it.
613 .Ic \&TH
614 line, or the fallbacks used.
616 In the tree dump, each output line shows one syntax tree node.
617 Child nodes are indented with respect to their parent node.
624 nodes, the content.
627 nodes.
629 Node type (text, elem, block, head, body, body-end, tail, tbl, eqn).
634 An opening parenthesis if the node is an opening delimiter.
636 An asterisk if the node starts a new input line.
638 The input line number (starting at one).
640 A colon.
642 The input column number (starting at one).
644 A closing parenthesis if the node is a closing delimiter.
646 A full stop if the node ends a sentence.
648 BROKEN if the node is a block broken by another block.
651 but automatically generated from macros.
654 for any output format.
663 Skip validation and show the unvalidated syntax tree.
665 the parser or by the validator.
666 Meta data is not available in this case.
672 .Xr locale 1 .
675 is selected, it decides whether to use ASCII or UTF-8 output format.
676 It never affects the interpretation of input files.
684 for details.
689 is specified.
693 is not defined.
696 is used.
701 is specified.
717 .Ar level .
724 was specified.
730 was requested.
737 was requested.
743 was requested.
745 Invalid command line arguments were specified.
746 No input files have been read.
749 of memory, file descriptors, or process table entries.
752 to exit at once, possibly in the middle of parsing or formatting a file.
758 .Fl W Cm all .
762 .Dl $ mandoc -a mandoc.1 man.1 apropos.1 makewhatis.8
765 .Pa /usr/share/misc/mandoc.css
768 .Dl $ mandoc \-T html -O style=/usr/share/misc/mandoc.css mdoc.7 > mdoc.7.html
772 .Dl $ mandoc \-T lint \(gafind /usr/src -name \e*\e.[1-9]\(ga
776 .Dl $ mandoc \-T ps \-O paper=a4 mdoc.7 man.7 > manuals.ps
786 .Dl $ mandoc \-T man foo.mdoc > foo.man
793 .Ar file : Ns Ar line : Ns Ar column : level : message : macro argument ...
803 number of the input file where the message was triggered.
804 The line and column numbers start at 1.
805 Both are omitted for messages referring to an input file as a whole.
810 strings are explained below.
813 triggering the message and its arguments are omitted where meaningless.
817 for all operating systems.
824 fields.
829 An operating system error occurred.
830 There isn't necessarily anything wrong with the input files.
831 Output may all the same be missing or incomplete.
833 Invalid command line arguments were specified.
834 No input files have been read and no output is produced.
838 features.
842 to process the file may be preferable.
845 in most cases caused by serious syntax errors.
848 may mismatch the author's intent in minor ways.
850 even if they do not usually cause misformatting.
852 An input file uses dubious or discouraged style.
854 formatting nor portability are in danger.
859 so it may occasionally issue bogus suggestions.
862 suggestion really justifies a change to the input file.
865 is not adhered to.
867 nor portability are in danger.
873 tag.
887 output mode.
897 .Ic \&Os
903 function.
909 .Ic \&Dd
914 base system.
917 format instead.
921 .Ic \&Dd
926 base system.
930 .Ic \&Dt
932 is running on.
936 .Ic \&Os
937 macro has an argument.
938 In the base system, it is conventionally left blank.
946 keyword substitution as conventionally used in these operating systems.
953 .Ic \&Dd
957 .Dq yyyy-dd-mm .
962 instead.
963 .It Sy "normalizing date format to" : No ...
966 .Ic \&Dd
968 .Ic \&TH
970 leading zero.
972 and the leading zero is omitted.
976 .Ic \&Dt
978 .Ic \&TH
979 macro.
982 the same operating system.
984 to the top of the page.
988 .Ic \&Sh
989 macro is similar, but not identical to a standard section name.
994 argument need not be escaped.
995 The closing quote of the last argument of a macro can be omitted.
997 harder to read.
1001 .Ic \&Bt ,
1002 .Ic \&Tn ,
1004 .Ic \&Ud
1005 macro was found.
1006 Simply delete it: it serves no useful purpose.
1010 .Ic \&Bx
1012 .Ic \&Ox ,
1013 .Ic \&Nx ,
1014 .Ic \&Fx ,
1016 .Ic \&Dx .
1020 .Ic \&Er
1022 .Ic \&Bl
1023 list are not in alphabetical order.
1027 .Ic \&Bl
1029 .Ic \&It
1031 .Ic \&Er
1032 number.
1036 .Ic \&Xr
1037 macro references a manual page that was not found.
1041 .Pa /usr/share/man : Ns Pa /usr/X11R6/man .
1044 preprocessor macro.
1056 .Xr man.conf 5
1061 preprocessor macro.
1065 .Ic \&Ex , \&Fo , \&Nd , \&Nm , \&Os , \&Sh , \&Ss , \&St ,
1067 .Ic \&Sx
1068 macro ends with a trailing delimiter.
1069 This is usually bad style and often indicates typos.
1070 Most likely, the delimiter can be removed.
1074 arguments is longer than one byte and ends with a trailing delimiter.
1076 argument, thus moving it out of the scope of the macro.
1080 .Ic \&fi
1082 or already switched back to fill mode.
1083 It has no effect.
1087 .Ic \&nf
1089 and did not switch back to fill mode yet.
1090 It has no effect.
1093 at one of the blank characters before column 80.
1096 Even though the ASCII output device renders an em-dash as
1099 because it renders poorly on all other output devices.
1102 A word followed by an empty pair of parentheses occurs on a text line.
1104 .Ic \&Fn
1106 .Ic \&Xr
1107 macro.
1112 extremely confusing when reviewing and maintaining documents.
1115 Comment lines start with a dot, a backslash, and a double-quote character.
1119 but leaving out the backslash might not be portable.
1126 .Ic \&Dt
1128 .Ic \&Dt
1129 macro before the first non-prologue macro.
1133 .Ic \&TH
1134 macro, or it has no arguments.
1138 .Ic \&Dt
1140 .Ic \&TH
1141 macro lacks the mandatory section argument.
1145 .Ic \&Dt
1146 line is invalid, but still used.
1151 .Ic \&Dt
1153 .Ic \&TH
1156 argument that starts with a different non-zero digit.
1159 argument is used as provided anyway.
1160 Consider checking whether the file name or the argument need a correction.
1166 .Ic \&Dd
1168 .Ic \&Dd
1173 .Ic \&TH
1175 .Ic \&TH
1176 macro has less than three arguments or its third argument is empty.
1180 .Ic \&Dd
1182 .Ic \&TH
1183 macro does not follow the conventional format.
1187 .Ic \&Dd
1189 .Ic \&TH
1191 .Xr time 3 .
1194 The default or current system is not shown in this case.
1198 .Ic \&Dd
1200 .Ic \&Os
1201 macro occurs after some non-prologue macro, but still takes effect.
1205 .Ic \&Dd ,
1206 .Ic \&Dt ,
1207 .Ic \&Os .
1208 All three macros are used even when given in another order.
1212 .It Sy ".so is fragile, better use ln(1)"
1215 current working directory.
1218 The document body contains neither text nor macros.
1219 An empty document is shown, consisting only of a header and a footer line.
1223 .Ic \&Sh
1225 .Ic \&SH
1226 section header.
1228 of the syntax tree, outside any section block.
1232 .Ic \&Sh
1234 .Sq NAME .
1238 .Xr apropos 1 .
1242 .Ic \&Nm
1244 .Ic \&Nd
1245 macro.
1249 .Ic \&Nd
1250 child macro.
1254 .Ic \&Nd
1255 child macro, but other content follows it.
1259 .Ic \&Nm
1261 .Ic \&Nd .
1265 .Ic \&Nm
1266 macro that is neither the first one nor preceded by a comma.
1270 .Ic \&Nd
1271 macro lacks the required argument.
1272 The title line of the manual will end after the dash.
1276 .Ic \&Nd
1277 macro appears outside the NAME section.
1280 but none of that behaviour is portable.
1283 A standard section occurs after another section it usually precedes.
1285 and the order of sections is not changed.
1288 The same standard section title occurs more than once.
1292 where it normally isn't useful.
1296 .Ic \&Xr
1298 .Ic \&MR
1301 .Ic \&Nm
1303 .Ic \&Fn
1305 .Ic \&Fo
1306 macro in the SYNOPSIS.
1308 .Ic \&Nm
1310 .Ic \&Fn
1312 .Ic \&Xr .
1316 .Ic \&Xr
1319 .Ic \&Xr
1320 macros referring to the same section are out of alphabetical order.
1324 .Ic \&Xr
1327 .Ic \&Xr
1328 macro.
1332 .Ic \&An
1333 macros, or only empty ones.
1334 Probably, there are author names lacking markup.
1342 manual for replacements.
1345 The name of a macro that is not callable appears on a macro line.
1346 It is printed verbatim.
1349 .Sq \e& .
1362 and for multiple consecutive paragraph macros.
1370 .Ic \&P ,
1371 .Ic \&PP ,
1373 .Ic \&LP
1377 .Ic \&IP
1381 .Ic \&br
1383 .Ic \&sp
1385 .Ic \&SH
1387 .Ic \&SS
1392 .Ic \&Bl
1393 list contains a trailing paragraph macro.
1394 The paragraph macro is moved after the end of the list.
1398 .Ic \&Ns
1400 .Ic \&Ns
1401 macro is an isolated closing delimiter.
1402 The macro is ignored.
1405 If two blocks intersect, one should completely contain the other.
1409 blocks at all.
1411 .Qq Ic \&Ao \&Bo \&Ac \&Bc
1413 .Qq Ic \&Ao \&Bq \&Ac .
1415 .Ic \&Ac
1417 .Ic \&Bo
1419 .Ic \&Bq ,
1420 respectively.
1424 .Ic \&Bd ,
1425 .Ic \&D1 ,
1427 .Ic \&Dl
1429 .Ic \&Bd
1430 display.
1433 but fails with most other implementations.
1437 .Ic \&Bl
1439 .Ic \&It
1440 macro.
1441 The offending children are moved before the beginning of the list.
1444 .Ic \&Bl Fl column
1446 .Ic \&Ta
1447 macro occurs as the first macro on a line, which is not portable.
1451 another macro is found that prematurely terminates the previous one.
1452 The previous, interrupted macro is deleted from the parse tree.
1461 control statement or operation keyword lacks its required argument.
1470 keyword to open a multi-line scope.
1472 A request or macro or some text, resulting in a single-line scope.
1475 resulting in next-line scope.
1478 and there is no other content on its logical input line.
1482 line continuation characters.
1484 where trailing whitespace is syntactically significant.
1488 .Ic \&el
1489 clause.
1492 The indicated macro has no arguments and hence no effect.
1496 .Ic \&Bd ,
1497 .Ic \&Bk ,
1498 .Ic \&Bl ,
1499 .Ic \&D1 ,
1500 .Ic \&Dl ,
1502 .Ic \&RS
1503 block contains nothing in its body and will produce no output.
1507 .Ic \&Bd
1509 .Ic \&Bl
1512 .Fl width .
1516 .Ic \&Bd
1517 macro is invoked without the required display type.
1521 .Ic \&Bl
1522 macro, at least one other argument precedes the type argument.
1527 implementations do not.
1531 .Ic \&Bl
1536 too.
1540 .Ic \&Ex Fl std
1542 .Ic \&Nm
1543 has first been called with an argument.
1547 .Ic \&Fo
1548 macro is called without an argument.
1549 No function name is printed.
1553 .Ic \&Bl
1561 .Ic \&It
1562 macro lacks the required argument.
1563 The item head is left empty.
1567 .Ic \&Bl
1574 .Ic \&It
1575 block is empty.
1576 An empty list item is shown.
1580 .Ic \&It
1582 .Ic \&Bd Fl column
1583 list has no arguments.
1587 other formatters may misformat the list.
1591 .Ic \&Bf
1592 macro has no argument.
1593 It switches to the default font.
1597 .Ic \&Bf
1598 argument is invalid.
1599 The default font is used instead.
1603 .Ic \&Pf
1605 on the same input line.
1607 before the text or macros following on the next input line.
1611 .Ic \&Rs
1613 .Ic \&Re
1614 macro on the next input line.
1615 Such an empty block does not produce any output.
1619 .Ic \&Xr
1621 .Ic \&MR
1622 macro lacks its second, section number argument.
1623 The first argument, i.e. the name, is printed, but without a section number.
1625 .Ic \&Xr ,
1626 the parentheses are also omitted.
1630 .Ic \&Ex
1632 .Ic \&Rv
1635 argument.
1640 even when it is not specified, but other implementations may not.
1644 .Ic \&OP
1645 macro is invoked without any argument.
1646 An empty pair of square brackets is shown.
1650 .Ic \&MT
1652 .Ic \&UR
1653 macro is invoked without any argument.
1654 An empty pair of angle brackets is shown.
1658 but there is nothing to the left of it.
1659 An empty box is inserted.
1666 .Ic \&Bd
1668 .Ic \&Bl
1675 argument.
1676 All but the last instances of these arguments are ignored.
1680 .Ic \&An
1685 argument.
1686 All but the first of these arguments are ignored.
1690 .Ic \&Bd
1691 macro has more than one type argument; the first one is used.
1695 .Ic \&Bl
1696 macro has more than one type argument; the first one is used.
1700 .Ic \&Bl
1709 argument.
1710 That has no effect.
1713 .Ic \&Bl Fl column
1715 .Ic \&Ta
1717 or exceeds the expected number by more than one.
1719 columns are joined into one single cell.
1723 .Ic \&At
1724 macro has an invalid argument.
1727 prefixed to it.
1731 .Ic \&Fa
1733 .Ic \&Fn
1734 macro contains a comma; it should probably be split into two arguments.
1738 .Ic \&Fc
1740 .Ic \&Fn
1742 parentheses are added automatically.
1746 .Ic \&Lb
1748 .Qq library Dq Ar name .
1752 .Ic \&Rs
1753 block contains plain text or non-% macros.
1754 The bogus content is left in the syntax tree.
1755 Formatting may be poor.
1759 .Ic \&Sm
1763 .Cm off .
1765 empty, causing it to toggle the spacing mode.
1770 request contains more than one font escape sequence.
1771 A wrong font may remain active after using the character.
1776 .Ic \&ft
1779 .Ic \&f
1782 argument.
1786 .Ic \&mc
1790 .Ic \&mc
1791 always ignores the second argument.
1795 .Ic \&tr
1796 request contains an odd number of characters.
1797 The last character is mapped to the blank character.
1801 .It Sy "blank line in fill mode, using .sp"
1805 significant.
1808 .Ic \&sp
1809 requests.
1811 .Ic \&Pp
1812 instead of a blank line.
1817 on text input lines.
1819 are passed through to the formatters in any case.
1821 it is hard to predict which tab stop position the tab will advance to.
1824 A new sentence starts in the middle of a text line.
1825 Start it on a new input line to help formatters produce correct spacing.
1828 The argument of an escape sequence is of an invalid form.
1829 Invalid escape sequences are ignored.
1833 right after the leading backslash is invalid.
1835 which is equivalent to ignoring the backslash.
1839 its value is implicitly set to the empty string.
1841 keeps the code more readable.
1848 .Pq Sq Cm s .
1849 Data provided for this cell is ignored, and nothing is printed in the cell.
1854 .Pq Sq Cm ^ .
1855 Data provided for this cell is ignored, and nothing is printed in the cell.
1858 A table layout specification contains more than two consecutive vertical bars.
1859 A double bar is printed, all additional bars are discarded.
1866 blank, or comma where the beginning of an option name is expected.
1867 The character is ignored.
1871 match any known option name.
1872 The word is ignored.
1877 followed by a closing parenthesis.
1878 The option is ignored.
1881 A table option argument contains an invalid number of characters.
1882 Both the option and the argument are ignored.
1886 specifying zero lines and zero columns.
1887 As a fallback, a single left-justified column is used.
1892 or a modifier precedes the first key.
1893 The invalid character is discarded.
1897 but no matching closing parenthesis.
1898 The rest of the input line, starting from the parenthesis, has no effect.
1901 A spacing modifier in a table layout is unreasonably large.
1902 The default spacing of 3n is used instead.
1905 A table does not contain any data cells.
1906 It will probably produce no output.
1913 in the table layout, but it contains data.
1914 The data is ignored.
1917 A data line contains more cells than the corresponding layout line.
1918 The data in the extra cells is ignored.
1924 .Cm T} .
1926 and any remaining cells stay empty.
1932 One of the prologue macros occurs more than once.
1933 The last instance overrides all previous ones.
1937 .Ic \&Dt
1938 macro appears after the first non-prologue macro.
1940 they write the page header before parsing the document body.
1943 traditional semantics is preserved.
1944 The late macro is discarded including its arguments.
1957 .Ic \&so
1958 file inclusion.
1961 some content, but the parser can continue.
1965 .Xr ascii 7
1966 character.
1967 The message mentions the character number.
1969 .Pq Sq \&? .
1970 Consider editing the input file to replace the byte with an ASCII
1971 transliteration of the intended character.
1980 macro.
1981 It may be mistyped or unsupported.
1982 The request or macro is discarded including its arguments.
1989 request occurs outside any macro definition and has no effect.
1993 or to read or write an external file.
1994 Such attempts are denied for security reasons.
1998 .Ic \&It
2000 .Ic \&Bl
2004 delimiter occurs outside any pile.
2005 It is discarded including its arguments.
2009 .Ic \&Ta
2011 .Ic \&Bl Fl column
2012 block.
2013 It is discarded including its arguments.
2017 that have previously been opened.
2022 .Ic \&ME , \&RE
2024 .Ic \&UE
2029 conditional request is encountered but no matching block is open.
2030 The offending request or macro is discarded.
2034 .Ic \&RE
2036 .Ic \&RS
2037 blocks is open.
2039 .Ic \&RE
2040 macro is discarded.
2045 macros as well as tables require explicit closing by dedicated macros.
2047 ends before all of its children are properly closed.
2048 The open child nodes are closed implicitly.
2056 .Ic \&MT , \&RS
2058 .Ic \&UR
2061 conditional or ignore block is still open.
2062 The open block is closed implicitly.
2066 non-whitespace ASCII characters.
2068 cannot form part of a name.
2070 .Ic \&am ,
2071 .Ic \&as ,
2072 .Ic \&de ,
2073 .Ic \&ds ,
2074 .Ic \&nr ,
2076 .Ic \&rr
2078 .Ic \&rm
2080 is terminated by an escape sequence.
2082 .Ic \&as ,
2083 .Ic \&ds ,
2085 .Ic \&nr ,
2086 the request has no effect at all.
2088 .Ic \&am ,
2089 .Ic \&de ,
2090 .Ic \&rr ,
2092 .Ic \&rm ,
2094 and the rest of the input line is discarded including the escape sequence.
2096 only the escape sequence is discarded.
2098 the characters following it are used as the arguments to the request or macro.
2102 and expands to the empty string.
2106 the escape sequence expands to the empty string.
2110 .Ic \&shift
2112 or an argument that is negative due to integer overflow.
2113 Macro argument numbering remains unchanged.
2117 .Ic \&Bd
2120 argument.
2123 the file on the screen, revealing the file content to bystanders.
2124 The argument is ignored including the file name following it.
2128 .Ic \&Bd
2129 block macro does not have any arguments.
2131 whatever mode was active before the block.
2135 .Ic \&Bl
2136 macro fails to specify the list type.
2140 .Ic \&ce
2141 request is not a number.
2146 request is neither a single ASCII character
2147 nor a single character escape sequence.
2148 The request is ignored including all its arguments.
2153 request is neither a single ASCII character
2154 nor a single character escape sequence.
2155 All arguments are ignored and printing of a margin character is disabled.
2159 .Ic \&Nm ,
2161 .Ic \&MR
2162 is called without any argument.
2166 .Ic \&Os
2169 system call failed.
2174 .Fl D Cm OSNAME=\(dq\e\(dq Ar string Cm \e\(dq\(dq .
2179 .Ic \&St
2180 macro has an unknown argument and is discarded.
2184 .Ic \&it
2187 .Ic \&size
2189 .Ic \&gsize
2190 statement has a non-numeric or negative argument or no argument at all.
2191 The invalid request or statement is ignored.
2197 currently being executed.
2198 All macro arguments are deleted and \en(.$ is set to zero.
2199 .It Sy "NOT IMPLEMENTED: .so with absolute path or \(dq..\(dq"
2204 .Ic \&so
2206 and only without ascending to any parent directory.
2209 the file on the screen, revealing the file content to bystanders.
2212 .Ic \&so .
2213 .It Sy ".so request failed"
2216 .Ic \&so
2218 opened.
2221 .Ic \&so .
2226 .Ic \&Bt ,
2227 .Ic \&Ed ,
2228 .Ic \&Ef ,
2229 .Ic \&Ek ,
2230 .Ic \&El ,
2231 .Ic \&Lp ,
2232 .Ic \&Pp ,
2233 .Ic \&Re ,
2234 .Ic \&Rs ,
2236 .Ic \&Ud
2238 .Ic \&It
2241 .Ic \&LP ,
2242 .Ic \&P ,
2244 .Ic \&PP
2247 .Ic \&EQ
2249 .Ic \&EN
2252 .Ic \&br ,
2253 .Ic \&fi ,
2255 .Ic \&nf
2257 .Sq \&..
2258 block closing request is invoked with at least one argument.
2259 All arguments are ignored.
2265 .Ic \&Fo ,
2266 .Ic \&MT ,
2267 .Ic \&PD ,
2268 .Ic \&RS ,
2269 .Ic \&UR ,
2270 .Ic \&ft ,
2272 .Ic \&sp
2275 .Ic \&An
2281 .Ic \&RE
2284 .Ic \&OP
2286 .Ic \&de
2289 .Ic \&Dt
2291 .Ic \&MR
2294 .Ic \&TH
2297 .Ic \&Bd ,
2298 .Ic \&Bk ,
2300 .Ic \&Bl
2303 The excess arguments are ignored.
2310 while parsing the argument of an escape sequence.
2321 to the length of the incomplete argument.
2322 All other incomplete escape sequences are ignored.
2327 or beyond the Unicode range, a \e[char...] escape sequence
2339 respectively.
2340 The escape sequence is ignored.
2344 .Nm .
2345 The escape sequence is ignored.
2350 .Qq " %&()*+-./0123456789:<=>"
2351 as an argument delimiter.
2353 and the rest of the argument may appear as output text.
2357 is recommended for readability and robustness.
2366 of 2^31 bytes (2 Gigabytes).
2367 Since useful manuals are always small, this is not a problem in practice.
2368 Parsing is aborted as soon as the condition is detected.
2371 An ASCII control character supported by other
2375 was found in an input file.
2376 It is replaced by a question mark.
2383 or considerable misformatting.
2391 or considerable misformatting.
2394 The options line of a table defines equation delimiters.
2395 Any equation source code contained in the table will be printed unformatted.
2400 modifier.
2401 The modifier is discarded.
2408 macro or of an undefined macro.
2410 as if they were a text line.
2414 .Ic \&TS
2415 macro.
2420 input is not supported.
2424 .Ic \&EQ
2425 macro.
2430 input is not supported.
2439 given as a command line argument cannot be opened.
2443 command line option was specified twice.
2447 option has a value but does not accept one.
2451 option has no argument but requires one.
2458 option has an invalid value.
2462 option is specified more than once.
2467 manual pages.
2474 language.
2475 No output is produced for that input file.
2490 .Ox 4.8 .
2498 .Ox 5.7 .
2504 .An Kristaps Dzonsons Aq Mt kristaps@bsd.lv
2506 .An Ingo Schwarze Aq Mt schwarze@openbsd.org .