Lines Matching +full:ascii +full:. +full:r
1 .\" $OpenBSD: mandoc.1,v 1.166 2020/02/15 15:28:01 schwarze Exp $
2 .\"
3 .\" Copyright (c) 2012, 2014-2021 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.
293 .Xr man 7 .
295 for example overfull lines or ugly line breaks.
297 wide, the default is reduced to three columns.
303 output style.
306 .Fl O Cm indent Ns =5 .
311 source it was generated from.
316 rather than showing the manual page from the beginning.
321 number.
327 is used rather than the argument as a whole.
331 in the matching manual pages.
335 instead of the default of 78.
337 wide, the default is reduced to one less than the terminal width.
339 and may exceed the output width.
344 conforms to HTML5 using optional self-closing tags.
345 Default styles use only CSS1.
348 blocks use MathML.
351 .Pa /usr/share/misc/mandoc.css
352 documents style-sheet classes available for customising output.
358 browser.
360 Non-ASCII characters are rendered
361 as hexadecimal Unicode character references.
369 elements and only emit the subtree below the <body> element.
372 argument will be ignored.
373 This is useful when embedding manual content within existing documents.
378 .Ar ../src/%I.html ,
380 .Ic \&In
381 macro).
383 .Sq \&%I
384 are replaced with the include filename.
386 hyperlink.
391 .Ar ../html%S/%N.%S.html ,
393 .Ic \&Xr
394 macro).
396 .Sq \&%N
399 are replaced with the linked manual's name and section, respectively.
400 If no section is included, section 1 is assumed.
402 present a hyperlink.
404 .Ar %N.%S
406 otherwise, the second format is used.
407 .It Cm style Ns = Ns Ar style.css
409 .Ar style.css
410 is used for an external style-sheet.
412 relative URI.
415 .Sx ASCII Output .
419 rather than passing merely a file name.
429 .Xr less 1 .
436 URIs.
439 print a table of contents near the beginning of the output.
444 automatically selects UTF-8 or ASCII output according to the current
445 .Xr locale 1 .
455 .Sx ASCII Output .
457 .Fl T Cm locale .
465 output format.
469 formatters.
474 code is not supported.
478 the input is copied to the output.
483 are displayed before copying the input to the output.
490 .Lk http://daringfireball.net/projects/markdown/syntax.text\
491 "John Gruber's 2004 specification" .
493 .Lk http://commonmark.org/ CommonMark
494 specification.
496 The character set used for the markdown output is ASCII.
497 Non-ASCII characters are encoded as HTML entities.
500 non-ASCII characters are transliterated to ASCII approximations in
501 these contexts.
504 lost, and even part of the presentational markup may be lost.
508 directly.
517 output mode.
520 .Fl T Cm pdf .
525 arguments and defaults.
530 .Fl T Cm ps .
532 family, 11-point.
533 Margins are calculated as 1/9 the page length and width.
534 Line-height is 1.4m.
537 .Sx ASCII Output .
552 .Ar letter .
555 width by height in millimetres.
558 is used.
566 settings in the environment.
568 .Sx ASCII Output
571 arguments.
577 .Sx ASCII Output .
581 to show a human readable representation of the syntax tree.
582 It is useful for debugging the source code of manual pages.
583 The exact format is subject to change, so don't write parsers for it.
589 .Ic \&TH
590 line, or the fallbacks used.
592 In the tree dump, each output line shows one syntax tree node.
593 Child nodes are indented with respect to their parent node.
600 nodes, the content.
603 nodes.
605 Node type (text, elem, block, head, body, body-end, tail, tbl, eqn).
610 An opening parenthesis if the node is an opening delimiter.
612 An asterisk if the node starts a new input line.
614 The input line number (starting at one).
616 A colon.
618 The input column number (starting at one).
620 A closing parenthesis if the node is a closing delimiter.
622 A full stop if the node ends a sentence.
624 BROKEN if the node is a block broken by another block.
627 but automatically generated from macros.
630 for any output format.
639 Skip validation and show the unvalidated syntax tree.
641 the parser or by the validator.
642 Meta data is not available in this case.
648 .Xr locale 1 .
651 is selected, it decides whether to use ASCII or UTF-8 output format.
652 It never affects the interpretation of input files.
660 for details.
665 is specified.
669 is not defined.
672 is used.
677 is specified.
693 .Ar level .
700 was specified.
706 was requested.
713 was requested.
719 was requested.
721 Invalid command line arguments were specified.
722 No input files have been read.
725 of memory, file descriptors, or process table entries.
728 to exit at once, possibly in the middle of parsing or formatting a file.
734 .Fl W Cm all .
738 .Dl $ mandoc -l mandoc.1 man.1 apropos.1 makewhatis.8
741 .Pa /usr/share/misc/mandoc.css
744 .Dl $ mandoc \-T html -O style=/usr/share/misc/mandoc.css mdoc.7 > mdoc.7.html
748 .Dl $ mandoc \-T lint \(gafind /usr/src -name \e*\e.[1-9]\(ga
752 .Dl $ mandoc \-T ps \-O paper=a4 mdoc.7 man.7 > manuals.ps
762 .Dl $ mandoc \-T man foo.mdoc > foo.man
779 number of the input file where the message was triggered.
780 The line and column numbers start at 1.
781 Both are omitted for messages referring to an input file as a whole.
786 strings are explained below.
791 are omitted where meaningless.
795 for all operating systems.
802 fields.
807 An operating system error occurred.
808 There isn't necessarily anything wrong with the input files.
809 Output may all the same be missing or incomplete.
811 Invalid command line arguments were specified.
812 No input files have been read and no output is produced.
816 features.
820 to process the file may be preferable.
823 in most cases caused by serious syntax errors.
826 may mismatch the author's intent in minor ways.
828 even if they do not usually cause misformatting.
830 An input file uses dubious or discouraged style.
832 formatting nor portability are in danger.
837 so it may occasionally issue bogus suggestions.
840 suggestion really justifies a change to the input file.
843 is not adhered to.
845 nor portability are in danger.
851 tag.
865 output mode.
875 .Ic \&Os
881 function.
887 .Ic \&Dd
892 base system.
895 format instead.
899 .Ic \&Dd
904 base system.
908 .Ic \&Dt
910 is running on.
914 .Ic \&Os
915 macro has an argument.
916 In the base system, it is conventionally left blank.
924 keyword substitution as conventionally used in these operating systems.
931 .Ic \&Dd
935 .Dq yyyy-dd-mm .
940 instead.
941 .It Sy "normalizing date format to" : No ...
944 .Ic \&Dd
946 .Ic \&TH
948 leading zero.
950 and the leading zero is omitted.
954 .Ic \&Dt
956 .Ic \&TH
957 macro.
960 the same operating system.
962 to the top of the page.
966 .Ic \&Sh
967 macro is similar, but not identical to a standard section name.
972 argument need not be escaped.
973 The closing quote of the last argument of a macro can be omitted.
975 harder to read.
979 .Ic \&Bt ,
980 .Ic \&Tn ,
982 .Ic \&Ud
983 macro was found.
984 Simply delete it: it serves no useful purpose.
988 .Ic \&Bx
990 .Ic \&Ox ,
991 .Ic \&Nx ,
992 .Ic \&Fx ,
994 .Ic \&Dx .
998 .Ic \&Er
1000 .Ic \&Bl
1001 list are not in alphabetical order.
1005 .Ic \&Bl
1007 .Ic \&It
1009 .Ic \&Er
1010 number.
1014 .Ic \&Xr
1015 macro references a manual page that was not found.
1019 .Pa /usr/share/man : Ns Pa /usr/X11R6/man .
1022 preprocessor macro.
1034 .Xr man.conf 5
1039 preprocessor macro.
1043 .Ic \&Ex , \&Fo , \&Nd , \&Nm , \&Os , \&Sh , \&Ss , \&St ,
1045 .Ic \&Sx
1046 macro ends with a trailing delimiter.
1047 This is usually bad style and often indicates typos.
1048 Most likely, the delimiter can be removed.
1052 arguments is longer than one byte and ends with a trailing delimiter.
1054 argument, thus moving it out of the scope of the macro.
1058 .Ic \&fi
1060 or already switched back to fill mode.
1061 It has no effect.
1065 .Ic \&nf
1067 and did not switch back to fill mode yet.
1068 It has no effect.
1071 at one of the blank characters before column 80.
1074 Even though the ASCII output device renders an em-dash as
1077 because it renders poorly on all other output devices.
1080 A word followed by an empty pair of parentheses occurs on a text line.
1082 .Ic \&Fn
1084 .Ic \&Xr
1085 macro.
1090 extremely confusing when reviewing and maintaining documents.
1093 Comment lines start with a dot, a backslash, and a double-quote character.
1097 but leaving out the backslash might not be portable.
1104 .Ic \&Dt
1106 .Ic \&Dt
1107 macro before the first non-prologue macro.
1111 .Ic \&TH
1112 macro, or it has no arguments.
1116 .Ic \&Dt
1118 .Ic \&TH
1119 macro lacks the mandatory section argument.
1123 .Ic \&Dt
1124 line is invalid, but still used.
1129 .Ic \&Dt
1131 .Ic \&TH
1134 argument that starts with a different non-zero digit.
1137 argument is used as provided anyway.
1138 Consider checking whether the file name or the argument need a correction.
1144 .Ic \&Dd
1146 .Ic \&Dd
1151 .Ic \&TH
1153 .Ic \&TH
1154 macro has less than three arguments or its third argument is empty.
1158 .Ic \&Dd
1160 .Ic \&TH
1161 macro does not follow the conventional format.
1165 .Ic \&Dd
1167 .Ic \&TH
1169 .Xr time 3 .
1172 The default or current system is not shown in this case.
1176 .Ic \&Dd
1178 .Ic \&Os
1179 macro occurs after some non-prologue macro, but still takes effect.
1183 .Ic \&Dd ,
1184 .Ic \&Dt ,
1185 .Ic \&Os .
1186 All three macros are used even when given in another order.
1190 .It Sy ".so is fragile, better use ln(1)"
1193 current working directory.
1196 The document body contains neither text nor macros.
1197 An empty document is shown, consisting only of a header and a footer line.
1201 .Ic \&Sh
1203 .Ic \&SH
1204 section header.
1206 of the syntax tree, outside any section block.
1210 .Ic \&Sh
1212 .Sq NAME .
1216 .Xr apropos 1 .
1220 .Ic \&Nm
1222 .Ic \&Nd
1223 macro.
1227 .Ic \&Nd
1228 child macro.
1232 .Ic \&Nd
1233 child macro, but other content follows it.
1237 .Ic \&Nm
1239 .Ic \&Nd .
1243 .Ic \&Nm
1244 macro that is neither the first one nor preceded by a comma.
1248 .Ic \&Nd
1249 macro lacks the required argument.
1250 The title line of the manual will end after the dash.
1254 .Ic \&Nd
1255 macro appears outside the NAME section.
1258 but none of that behaviour is portable.
1261 A standard section occurs after another section it usually precedes.
1263 and the order of sections is not changed.
1266 The same standard section title occurs more than once.
1270 where it normally isn't useful.
1274 .Ic \&Xr
1277 .Ic \&Nm
1279 .Ic \&Fn
1281 .Ic \&Fo
1282 macro in the SYNOPSIS.
1284 .Ic \&Nm
1286 .Ic \&Fn
1288 .Ic \&Xr .
1292 .Ic \&Xr
1295 .Ic \&Xr
1296 macros referring to the same section are out of alphabetical order.
1300 .Ic \&Xr
1303 .Ic \&Xr
1304 macro.
1308 .Ic \&An
1309 macros, or only empty ones.
1310 Probably, there are author names lacking markup.
1318 manual for replacements.
1321 The name of a macro that is not callable appears on a macro line.
1322 It is printed verbatim.
1325 .Sq \e& .
1338 and for multiple consecutive paragraph macros.
1346 .Ic \&P ,
1347 .Ic \&PP ,
1349 .Ic \&LP
1353 .Ic \&IP
1357 .Ic \&br
1359 .Ic \&sp
1361 .Ic \&SH
1363 .Ic \&SS
1368 .Ic \&Bl
1369 list contains a trailing paragraph macro.
1370 The paragraph macro is moved after the end of the list.
1374 .Ic \&Ns
1376 .Ic \&Ns
1377 macro is an isolated closing delimiter.
1378 The macro is ignored.
1381 If two blocks intersect, one should completely contain the other.
1385 blocks at all.
1387 .Qq Ic \&Ao \&Bo \&Ac \&Bc
1389 .Qq Ic \&Ao \&Bq \&Ac .
1391 .Ic \&Ac
1393 .Ic \&Bo
1395 .Ic \&Bq ,
1396 respectively.
1400 .Ic \&Bd ,
1401 .Ic \&D1 ,
1403 .Ic \&Dl
1405 .Ic \&Bd
1406 display.
1409 but fails with most other implementations.
1413 .Ic \&Bl
1415 .Ic \&It
1416 macro.
1417 The offending children are moved before the beginning of the list.
1420 .Ic \&Bl Fl column
1422 .Ic \&Ta
1423 macro occurs as the first macro on a line, which is not portable.
1427 another macro is found that prematurely terminates the previous one.
1428 The previous, interrupted macro is deleted from the parse tree.
1437 control statement or operation keyword lacks its required argument.
1446 keyword to open a multi-line scope.
1448 A request or macro or some text, resulting in a single-line scope.
1451 resulting in next-line scope.
1454 and there is no other content on its logical input line.
1458 line continuation characters.
1460 where trailing whitespace is syntactically significant.
1464 .Ic \&el
1465 clause.
1468 The indicated macro has no arguments and hence no effect.
1472 .Ic \&Bd ,
1473 .Ic \&Bk ,
1474 .Ic \&Bl ,
1475 .Ic \&D1 ,
1476 .Ic \&Dl ,
1477 .Ic \&MT ,
1478 .Ic \&RS ,
1480 .Ic \&UR
1481 block contains nothing in its body and will produce no output.
1485 .Ic \&Bd
1487 .Ic \&Bl
1490 .Fl width .
1494 .Ic \&Bd
1495 macro is invoked without the required display type.
1499 .Ic \&Bl
1500 macro, at least one other argument precedes the type argument.
1505 implementations do not.
1509 .Ic \&Bl
1514 too.
1518 .Ic \&Ex Fl std
1520 .Ic \&Nm
1521 has first been called with an argument.
1525 .Ic \&Fo
1526 macro is called without an argument.
1527 No function name is printed.
1531 .Ic \&Bl
1539 .Ic \&It
1540 macro lacks the required argument.
1541 The item head is left empty.
1545 .Ic \&Bl
1552 .Ic \&It
1553 block is empty.
1554 An empty list item is shown.
1558 .Ic \&It
1560 .Ic \&Bd Fl column
1561 list has no arguments.
1565 other formatters may misformat the list.
1569 .Ic \&Bf
1570 macro has no argument.
1571 It switches to the default font.
1575 .Ic \&Bf
1576 argument is invalid.
1577 The default font is used instead.
1581 .Ic \&Pf
1583 on the same input line.
1585 before the text or macros following on the next input line.
1589 .Ic \&Rs
1591 .Ic \&Re
1592 macro on the next input line.
1593 Such an empty block does not produce any output.
1597 .Ic \&Xr
1598 macro lacks its second, section number argument.
1599 The first argument, i.e. the name, is printed, but without subsequent
1600 parentheses.
1604 .Ic \&Ex
1606 .Ic \&Rv
1609 argument.
1614 even when it is not specified, but other implementations may not.
1618 .Ic \&OP
1619 macro is invoked without any argument.
1620 An empty pair of square brackets is shown.
1624 .Ic \&MT
1626 .Ic \&UR
1627 macro is invoked without any argument.
1628 An empty pair of angle brackets is shown.
1632 but there is nothing to the left of it.
1633 An empty box is inserted.
1640 .Ic \&Bd
1642 .Ic \&Bl
1649 argument.
1650 All but the last instances of these arguments are ignored.
1654 .Ic \&An
1659 argument.
1660 All but the first of these arguments are ignored.
1664 .Ic \&Bd
1665 macro has more than one type argument; the first one is used.
1669 .Ic \&Bl
1670 macro has more than one type argument; the first one is used.
1674 .Ic \&Bl
1683 argument.
1684 That has no effect.
1687 .Ic \&Bl Fl column
1689 .Ic \&Ta
1691 or exceeds the expected number by more than one.
1693 columns are joined into one single cell.
1697 .Ic \&At
1698 macro has an invalid argument.
1701 prefixed to it.
1705 .Ic \&Fa
1707 .Ic \&Fn
1708 macro contains a comma; it should probably be split into two arguments.
1712 .Ic \&Fc
1714 .Ic \&Fn
1716 parentheses are added automatically.
1720 .Ic \&Lb
1722 .Qq library Dq Ar name .
1726 .Ic \&Rs
1727 block contains plain text or non-% macros.
1728 The bogus content is left in the syntax tree.
1729 Formatting may be poor.
1733 .Ic \&Sm
1737 .Cm off .
1739 empty, causing it to toggle the spacing mode.
1744 request contains more than one font escape sequence.
1745 A wrong font may remain active after using the character.
1750 .Ic \&ft
1753 .Ic \&f
1756 argument.
1760 .Ic \&tr
1761 request contains an odd number of characters.
1762 The last character is mapped to the blank character.
1766 .It Sy "blank line in fill mode, using .sp"
1770 significant.
1773 .Ic \&sp
1774 requests.
1776 .Ic \&Pp
1777 instead of a blank line.
1782 on text input lines.
1784 are passed through to the formatters in any case.
1786 it is hard to predict which tab stop position the tab will advance to.
1789 A new sentence starts in the middle of a text line.
1790 Start it on a new input line to help formatters produce correct spacing.
1795 a character escape sequence with an invalid name.
1806 to the length of the incomplete argument.
1807 All other invalid escape sequences are ignored.
1811 right after the leading backslash is invalid.
1813 which is equivalent to ignoring the backslash.
1817 its value is implicitly set to the empty string.
1819 keeps the code more readable.
1826 .Pq Sq Cm s .
1827 Data provided for this cell is ignored, and nothing is printed in the cell.
1832 .Pq Sq Cm ^ .
1833 Data provided for this cell is ignored, and nothing is printed in the cell.
1836 A table layout specification contains more than two consecutive vertical bars.
1837 A double bar is printed, all additional bars are discarded.
1844 blank, or comma where the beginning of an option name is expected.
1845 The character is ignored.
1849 match any known option name.
1850 The word is ignored.
1855 followed by a closing parenthesis.
1856 The option is ignored.
1859 A table option argument contains an invalid number of characters.
1860 Both the option and the argument are ignored.
1864 specifying zero lines and zero columns.
1865 As a fallback, a single left-justified column is used.
1870 or a modifier precedes the first key.
1871 The invalid character is discarded.
1875 but no matching closing parenthesis.
1876 The rest of the input line, starting from the parenthesis, has no effect.
1879 A spacing modifier in a table layout is unreasonably large.
1880 The default spacing of 3n is used instead.
1883 A table does not contain any data cells.
1884 It will probably produce no output.
1891 in the table layout, but it contains data.
1892 The data is ignored.
1895 A data line contains more cells than the corresponding layout line.
1896 The data in the extra cells is ignored.
1902 .Cm T} .
1904 and any remaining cells stay empty.
1910 One of the prologue macros occurs more than once.
1911 The last instance overrides all previous ones.
1915 .Ic \&Dt
1916 macro appears after the first non-prologue macro.
1918 they write the page header before parsing the document body.
1921 traditional semantics is preserved.
1922 The late macro is discarded including its arguments.
1935 .Ic \&so
1936 file inclusion.
1939 some content, but the parser can continue.
1943 .Xr ascii 7
1944 character.
1945 The message mentions the character number.
1947 .Pq Sq \&? .
1948 Consider editing the input file to replace the byte with an ASCII
1949 transliteration of the intended character.
1958 macro.
1959 It may be mistyped or unsupported.
1960 The request or macro is discarded including its arguments.
1967 request occurs outside any macro definition and has no effect.
1971 or to read or write an external file.
1972 Such attempts are denied for security reasons.
1976 .Ic \&It
1978 .Ic \&Bl
1982 delimiter occurs outside any pile.
1983 It is discarded including its arguments.
1987 .Ic \&Ta
1989 .Ic \&Bl Fl column
1990 block.
1991 It is discarded including its arguments.
1995 that have previously been opened.
2000 .Ic \&ME , \&RE
2002 .Ic \&UE
2007 conditional request is encountered but no matching block is open.
2008 The offending request or macro is discarded.
2012 .Ic \&RE
2014 .Ic \&RS
2015 blocks is open.
2017 .Ic \&RE
2018 macro is discarded.
2023 macros as well as tables require explicit closing by dedicated macros.
2025 ends before all of its children are properly closed.
2026 The open child nodes are closed implicitly.
2034 .Ic \&MT , \&RS
2036 .Ic \&UR
2039 conditional or ignore block is still open.
2040 The open block is closed implicitly.
2044 non-whitespace ASCII characters.
2046 cannot form part of a name.
2048 .Ic \&am ,
2049 .Ic \&as ,
2050 .Ic \&de ,
2051 .Ic \&ds ,
2052 .Ic \&nr ,
2054 .Ic \&rr
2056 .Ic \&rm
2058 is terminated by an escape sequence.
2060 .Ic \&as ,
2061 .Ic \&ds ,
2063 .Ic \&nr ,
2064 the request has no effect at all.
2066 .Ic \&am ,
2067 .Ic \&de ,
2068 .Ic \&rr ,
2070 .Ic \&rm ,
2072 and the rest of the input line is discarded including the escape sequence.
2074 only the escape sequence is discarded.
2076 the characters following it are used as the arguments to the request or macro.
2080 and expands to the empty string.
2084 the escape sequence expands to the empty string.
2088 .Ic \&Bd
2091 argument.
2094 the file on the screen, revealing the file content to bystanders.
2095 The argument is ignored including the file name following it.
2099 .Ic \&Bd
2100 block macro does not have any arguments.
2102 whatever mode was active before the block.
2106 .Ic \&Bl
2107 macro fails to specify the list type.
2111 .Ic \&ce
2112 request is not a number.
2117 request is neither a single ASCII character
2118 nor a single character escape sequence.
2119 The request is ignored including all its arguments.
2123 .Ic \&Nm ,
2124 or any call in the NAME section, lacks the required argument.
2128 .Ic \&Os
2131 system call failed.
2136 .Fl D Cm OSNAME=\(dq\e\(dq Ar string Cm \e\(dq\(dq .
2141 .Ic \&St
2142 macro has an unknown argument and is discarded.
2146 .Ic \&it
2149 .Ic \&size
2151 .Ic \&gsize
2152 statement has a non-numeric or negative argument or no argument at all.
2153 The invalid request or statement is ignored.
2159 currently being executed.
2160 All macro arguments are deleted and \en(.$ is set to zero.
2161 .It Sy "NOT IMPLEMENTED: .so with absolute path or \(dq..\(dq"
2166 .Ic \&so
2168 and only without ascending to any parent directory.
2171 the file on the screen, revealing the file content to bystanders.
2174 .Ic \&so .
2175 .It Sy ".so request failed"
2178 .Ic \&so
2180 opened.
2183 .Ic \&so .
2188 .Ic \&Bt ,
2189 .Ic \&Ed ,
2190 .Ic \&Ef ,
2191 .Ic \&Ek ,
2192 .Ic \&El ,
2193 .Ic \&Lp ,
2194 .Ic \&Pp ,
2195 .Ic \&Re ,
2196 .Ic \&Rs ,
2198 .Ic \&Ud
2200 .Ic \&It
2203 .Ic \&LP ,
2204 .Ic \&P ,
2206 .Ic \&PP
2209 .Ic \&EQ
2211 .Ic \&EN
2214 .Ic \&br ,
2215 .Ic \&fi ,
2217 .Ic \&nf
2219 .Sq \&..
2220 block closing request is invoked with at least one argument.
2221 All arguments are ignored.
2227 .Ic \&Fo ,
2228 .Ic \&MT ,
2229 .Ic \&PD ,
2230 .Ic \&RS ,
2231 .Ic \&UR ,
2232 .Ic \&ft ,
2234 .Ic \&sp
2237 .Ic \&An
2243 .Ic \&RE
2246 .Ic \&OP
2248 .Ic \&de
2251 .Ic \&Dt
2254 .Ic \&TH
2257 .Ic \&Bd ,
2258 .Ic \&Bk ,
2260 .Ic \&Bl
2263 The excess arguments are ignored.
2272 of 2^31 bytes (2 Gigabytes).
2273 Since useful manuals are always small, this is not a problem in practice.
2274 Parsing is aborted as soon as the condition is detected.
2277 An ASCII control character supported by other
2281 was found in an input file.
2282 It is replaced by a question mark.
2289 or considerable misformatting.
2297 or considerable misformatting.
2300 The options line of a table defines equation delimiters.
2301 Any equation source code contained in the table will be printed unformatted.
2306 modifier.
2307 The modifier is discarded.
2314 macro or of an undefined macro.
2316 as if they were a text line.
2320 .Ic \&TS
2321 macro.
2326 input is not supported.
2330 .Ic \&EQ
2331 macro.
2336 input is not supported.
2345 given as a command line argument cannot be opened.
2349 command line option was specified twice.
2353 option has a value but does not accept one.
2357 option has no argument but requires one.
2364 option has an invalid value.
2368 option is specified more than once.
2373 manual pages.
2380 language.
2381 No output is produced for that input file.
2396 .Ox 4.8 .
2404 .Ox 5.7 .
2410 .An Kristaps Dzonsons Aq Mt kristaps@bsd.lv
2412 .An Ingo Schwarze Aq Mt schwarze@openbsd.org .