Lines Matching +full:left +full:- +full:input +full:- +full:single +full:- +full:end

3 .\" Copyright (c) 2012, 2014-2023 Ingo Schwarze <schwarze@openbsd.org>
50 .Bl -tag -width Ds
77 Specify the input encoding.
81 .Cm us-ascii ,
82 .Cm iso-8859-1 ,
84 .Cm utf-8 .
87 .Bl -enum
89 If the first three bytes of the input file are the UTF-8 byte order
90 mark (BOM, 0xefbbbf), input is interpreted as
91 .Cm utf-8 .
93 If the first or second line of the input file matches the
97 .D1 .\e" -*- Oo ...; Oc coding: Ar encoding ; No -*-
99 then input is interpreted according to
102 If the first non-ASCII byte in the file introduces a valid UTF-8
103 sequence, input is interpreted as
104 .Cm utf-8 .
106 Otherwise, input is interpreted as
107 .Cm iso-8859-1 .
112 all input files are interpreted as
116 all input files are interpreted as
118 By default, the input language is automatically detected for each file:
132 Comma-separated output options.
154 mode only parses the input and produces no output.
216 Read from the given input file.
220 reads from standard input.
244 to force text output in 7-bit ASCII character encoding documented in the
250 Font styles are applied by using back-spaced encoding such that an
257 is the back-space character number 8.
270 are rendered best-effort in an ASCII equivalent.
272 .Sq single quotes
277 formatters represent single quotes in ASCII output.
279 Unicode-compatible fonts because contrary to ASCII, Unicode uses
286 .Bl -tag -width Ds
288 The left margin for normal text is set to
298 input files in
325 .Ql man -akO tag Ic=ulimit
340 conforms to HTML5 using optional self-closing tags.
344 Non-ASCII characters are rendered
350 .Bl -tag -width Ds
416 .Nm Ns -specific
432 adequate font-style and font-weight attributes for various macros.
433 The result is readable in any graphical or text-based web browser,
435 Instead, formatting is mostly left to browser defaults
445 .Bd -literal -offset 3n
446 MANPAGER='lynx -force_html' man -T html -O tag=MANPAGER man
447 MANPAGER='w3m -T text/html' man -T html -O tag=toc mandoc
455 .Ql MANPAGER=less man -T html -O tag=toc mandoc
462 If an input file contains at least two non-standard sections,
468 automatically selects UTF-8 or ASCII output according to the current
476 selects the UTF-8 character encoding, it produces
477 .Sx UTF-8 Output ;
487 input into
500 If the input format of a file is
502 the input is copied to the output.
507 are displayed before copying the input to the output.
513 input to the markdown format conforming to
521 Non-ASCII characters are encoded as HTML entities.
524 non-ASCII characters are transliterated to ASCII approximations in
539 input languages are not supported by
543 PDF-1.1 output may be generated by
552 .Qq Adobe-3.0
553 Level-2 pages may be generated by
556 family, 11-point.
558 Line-height is 1.4m.
566 .Bl -tag -width Ds
584 .Ss UTF-8 Output
587 to force text output in UTF-8 multi-byte character encoding,
598 on those where the internal character representation is not UCS-4,
620 .Bl -enum -compact
629 Node type (text, elem, block, head, body, body-end, tail, tbl, eqn).
632 .Bl -dash -compact
636 An asterisk if the node starts a new input line.
638 The input line number (starting at one).
642 The input column number (starting at one).
650 NOSRC if the node is not in the input file,
661 .Bl -tag -width Ds
669 .Bl -tag -width MANPAGER
675 is selected, it decides whether to use ASCII or UTF-8 output format.
676 It never affects the interpretation of input files.
678 Any non-empty value of the environment variable
712 .Bl -tag -width Ds -compact
746 No input files have been read.
762 .Dl $ mandoc -a mandoc.1 man.1 apropos.1 makewhatis.8
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
791 .Bd -ragged -offset indent
803 number of the input file where the message was triggered.
805 Both are omitted for messages referring to an input file as a whole.
827 .Bl -tag -width "warning"
830 There isn't necessarily anything wrong with the input files.
834 No input files have been read and no output is produced.
836 An input file uses unsupported low-level
852 An input file uses dubious or discouraged style.
862 suggestion really justifies a change to the input file.
905 .Bl -ohang
938 In the base system, it is conventionally left blank.
949 .Bl -ohang
957 .Dq yyyy-dd-mm .
981 A single manual page contains two copies of the RCS identifier for
1088 request occurs even though the document already switched to no-fill mode
1091 .It Sy "input text line longer than 80 bytes"
1092 Consider breaking the input text line
1094 .It Sy "verbatim \(dq--\(dq, maybe consider using \e(em"
1096 Even though the ASCII output device renders an em-dash as
1097 .Qq \-\- ,
1098 that is not a good way to write it in an input file
1108 .It Sy "whitespace at end of input line"
1110 Whitespace at the end of input lines is almost never semantically
1115 Comment lines start with a dot, a backslash, and a double-quote character.
1122 .Bl -ohang
1129 macro before the first non-prologue macro.
1149 The name of the input file being processed is known and its file
1150 name extension starts with a non-zero digit, but the
1156 argument that starts with a different non-zero digit.
1201 macro occurs after some non-prologue macro, but still takes effect.
1211 .Bl -ohang
1251 .It Sy "description not at the end of NAME"
1272 The title line of the manual will end after the dash.
1325 macros differs from a single comma, or there is trailing punctuation
1337 .Bl -ohang
1347 If the intention is to call it, move it to its own input line;
1354 .Bl -dash -compact
1356 at the beginning and end of sections and subsections
1358 right before non-compact lists and displays
1360 at the end of items in non-column, non-compact lists
1367 .Bl -dash -compact
1394 The paragraph macro is moved after the end of the list.
1395 .It Sy "skipping no-space macro"
1397 An input line begins with an
1407 format, and rendering in SGML-based output formats is likely to be
1450 While parsing the next-line scope of the previous macro,
1455 .Bl -ohang
1465 follows it on the same logical input line:
1466 .Bl -dash -compact
1470 keyword to open a multi-line scope.
1472 A request or macro or some text, resulting in a single-line scope.
1474 The immediate end of the logical line without any intervening whitespace,
1475 resulting in next-line scope.
1478 and there is no other content on its logical input line.
1479 Note that it doesn't matter whether the logical input line is split
1480 across multiple physical input lines using
1513 .It Sy "missing display type, using -ragged"
1528 .It Sy "missing -width in -tag list, using 8n"
1563 The item head is left empty.
1605 on the same input line.
1607 before the text or macros following on the next input line.
1614 macro on the next input line.
1627 .It Sy "missing -std argument, adding it"
1658 but there is nothing to the left of it.
1662 .Bl -ohang
1697 .It Sy "skipping -width argument"
1719 columns are joined into one single cell.
1753 block contains plain text or non-% macros.
1754 The bogus content is left in the syntax tree.
1800 .Bl -ohang
1803 The meaning of blank input lines is only well-defined in non-fill mode:
1804 In fill mode, line breaks of text input lines are not supposed to be
1815 The meaning of tab characters is only well-defined in non-fill mode:
1817 on text input lines.
1825 Start it on a new input line to help formatters produce correct spacing.
1844 .Bl -ohang
1862 .Bl -ohang
1863 .It Sy "non-alphabetic character in tbl options"
1887 As a fallback, a single left-justified column is used.
1898 The rest of the input line, starting from the parenthesis, has no effect.
1919 .It Sy "data block open at end of tbl"
1929 .Bl -ohang
1938 macro appears after the first non-prologue macro.
1945 .It Sy "input stack limit exceeded, infinite loop?"
1949 .Bl -dash -compact
1954 expansion of nested user-defined macros,
1964 The input file contains a byte that is not a printable
1970 Consider editing the input file to replace the byte with an ASCII
1976 request, nor as a user-defined macro, nor, respectively, as an
1992 An input file attempted to run a shell command
2014 .It Sy "skipping end of block that is not open"
2027 right delimiter or closing brace, or the end of an equation, table, or
2041 .It Sy "inserting missing end of block"
2049 .It Sy "appending missing end of block"
2051 At the end of the document, an explicit
2055 next-line scope or
2066 non-whitespace ASCII characters.
2094 and the rest of the input line is discarded including the escape sequence.
2095 When parsing for a request or a user-defined macro name to be called,
2114 .It Sy "NOT IMPLEMENTED: Bd -file"
2132 .It Sy "missing list type, using -item"
2146 request is neither a single ASCII character
2147 nor a single character escape sequence.
2153 request is neither a single ASCII character
2154 nor a single character escape sequence.
2190 statement has a non-numeric or negative argument or no argument at all.
2263 .Bl -dash -offset 2n -width 2n -compact
2282 with more than one argument or with a non-integer argument
2306 .Bl -ohang
2309 The end of the input line is encountered
2330 range, or an invalid variable-length form
2331 of a single-byte character escape sequence, for example writing
2350 .Qq " %&()*+-./0123456789:<=>"
2355 using the apostrophe-quote character
2360 .Bl -ohang
2361 .It Sy "input too large"
2365 cannot handle input files larger than its arbitrary size limit
2375 was found in an input file.
2379 An input file contains an escape sequence supported by GNU troff
2386 An input file contains a
2411 .It Sy "skipping tbl in -Tman mode"
2413 An input file contains the
2420 input is not supported.
2421 .It Sy "skipping eqn in -Tman mode"
2423 An input file contains the
2430 input is not supported.
2433 .Bl -ohang
2468 .It Sy "\-Tmarkdown unsupported for man(7) input"
2472 option was specified but an input file uses the
2475 No output is produced for that input file.
2500 .An -nosplit