Lines Matching +full:input +full:- +full:style

3 .\" Copyright (c) 2012, 2014-2023, 2025 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.
167 .Cm style ,
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.
279 Unicode-compatible fonts because contrary to ASCII, Unicode uses
286 .Bl -tag -width Ds
312 .Ql man -akO tag Ic=ulimit
327 conforms to HTML5 using optional self-closing tags.
331 Non-ASCII characters are rendered
337 .Bl -tag -width Ds
342 .Cm style
378 .It Cm style Ns = Ns Ar style.css
380 .Ar style.css
403 .Nm Ns -specific
416 .Fl O Cm style ,
419 adequate font-style and font-weight attributes for various macros.
420 The result is readable in any graphical or text-based web browser,
432 .Bd -literal -offset 3n
433 MANPAGER='lynx -force_html' man -T html -O tag=MANPAGER man
434 MANPAGER='w3m -T text/html' man -T html -O tag=toc mandoc
442 .Ql MANPAGER=less man -T html -O tag=toc mandoc
449 If an input file contains at least two non-standard sections,
455 automatically selects UTF-8 or ASCII output according to the current
463 selects the UTF-8 character encoding, it produces
464 .Sx UTF-8 Output ;
474 input into
487 If the input format of a file is
489 the input is copied to the output.
494 are displayed before copying the input to the output.
500 input to the markdown format conforming to
508 Non-ASCII characters are encoded as HTML entities.
511 non-ASCII characters are transliterated to ASCII approximations in
526 input languages are not supported by
530 PDF-1.1 output may be generated by
539 .Qq Adobe-3.0
540 Level-2 pages may be generated by
543 family, 11-point.
545 Line-height is 1.4m.
553 .Bl -tag -width Ds
571 .Ss UTF-8 Output
574 to force text output in UTF-8 multi-byte character encoding,
585 on those where the internal character representation is not UCS-4,
607 .Bl -enum -compact
616 Node type (text, elem, block, head, body, body-end, tail, tbl, eqn).
619 .Bl -dash -compact
623 An asterisk if the node starts a new input line.
625 The input line number (starting at one).
629 The input column number (starting at one).
637 NOSRC if the node is not in the input file,
648 .Bl -tag -width Ds
656 .Bl -tag -width MANPAGER
662 is selected, it decides whether to use ASCII or UTF-8 output format.
663 It never affects the interpretation of input files.
665 Any non-empty value of the environment variable
699 .Bl -tag -width Ds -compact
701 No base system convention violations, style suggestions, warnings,
706 At least one base system convention violation or style suggestion
710 .Fl W Cm style
733 No input files have been read.
749 .Dl $ mandoc -a mandoc.1 man.1 apropos.1 makewhatis.8
755 .Dl $ mandoc \-T html -O style=/usr/share/misc/mandoc.css mdoc.7 > mdoc.7.html
759 .Dl $ mandoc \-T lint \(gafind /usr/src -name \e*\e.[1-9]\(ga
763 .Dl $ mandoc \-T ps \-O paper=a4 mdoc.7 man.7 > manuals.ps
773 .Dl $ mandoc \-T man foo.mdoc > foo.man
778 .Bd -ragged -offset indent
790 number of the input file where the message was triggered.
792 Both are omitted for messages referring to an input file as a whole.
814 .Bl -tag -width "warning"
817 There isn't necessarily anything wrong with the input files.
821 No input files have been read and no output is produced.
823 An input file uses unsupported low-level
838 .It Cm style
839 An input file uses dubious or discouraged style.
844 .Cm style
848 .Cm style
849 suggestion really justifies a change to the input file.
858 .Cm style
865 .Cm style ,
879 .Cm style
892 .Bl -ohang
935 .Ss Style suggestions
936 .Bl -ohang
944 .Dq yyyy-mm-dd .
1033 .Fl W Cm style ,
1056 This is usually bad style and often indicates typos.
1075 request occurs even though the document already switched to no-fill mode
1078 .It Sy "input text line longer than 80 bytes"
1079 Consider breaking the input text line
1081 .It Sy "verbatim \(dq--\(dq, maybe consider using \e(em"
1083 Even though the ASCII output device renders an em-dash as
1084 .Qq \-\- ,
1085 that is not a good way to write it in an input file
1095 .It Sy "whitespace at end of input line"
1097 Whitespace at the end of input lines is almost never semantically
1100 .It Sy "bad comment style"
1102 Comment lines start with a dot, a backslash, and a double-quote character.
1109 .Bl -ohang
1118 macro before the first non-prologue
1123 An input document does not contain any
1140 The name of the input file being processed is known and its file
1141 name extension starts with a non-zero digit, but the
1147 argument that starts with a different non-zero digit.
1192 macro occurs after some non-prologue macro, but still takes effect.
1202 .Bl -ohang
1328 .Bl -ohang
1338 If the intention is to call it, move it to its own input line;
1345 .Bl -dash -compact
1349 right before non-compact lists and displays
1351 at the end of items in non-column, non-compact lists
1358 .Bl -dash -compact
1386 .It Sy "skipping no-space macro"
1388 An input line begins with an
1398 format, and rendering in SGML-based output formats is likely to be
1441 While parsing the next-line scope of the previous macro,
1446 .Bl -ohang
1456 follows it on the same logical input line:
1457 .Bl -dash -compact
1461 keyword to open a multi-line scope.
1463 A request or macro or some text, resulting in a single-line scope.
1466 resulting in next-line scope.
1469 and there is no other content on its logical input line.
1470 Note that it doesn't matter whether the logical input line is split
1471 across multiple physical input lines using
1504 .It Sy "missing display type, using -ragged"
1519 .It Sy "missing -width in -tag list, using 8n"
1596 on the same input line.
1598 before the text or macros following on the next input line.
1605 macro on the next input line.
1618 .It Sy "missing -std argument, adding it"
1653 .Bl -ohang
1688 .It Sy "skipping -width argument"
1744 block contains plain text or non-% macros.
1791 .Bl -ohang
1794 The meaning of blank input lines is only well-defined in non-fill mode:
1795 In fill mode, line breaks of text input lines are not supposed to be
1808 The meaning of tab characters is only well-defined in non-fill mode:
1810 on text input lines.
1818 Start it on a new input line to help formatters produce correct spacing.
1837 .Bl -ohang
1855 .Bl -ohang
1856 .It Sy "non-alphabetic character in tbl options"
1880 As a fallback, a single left-justified column is used.
1891 The rest of the input line, starting from the parenthesis, has no effect.
1928 .Bl -ohang
1937 macro appears after the first non-prologue macro.
1944 .It Sy "input stack limit exceeded, infinite loop?"
1948 .Bl -dash -compact
1953 expansion of nested user-defined macros,
1963 The input file contains a byte that is not a printable
1969 Consider editing the input file to replace the byte with an ASCII
1975 request, nor as a user-defined macro, nor, respectively, as an
1991 An input file attempted to run a shell command
2054 next-line scope or
2065 non-whitespace ASCII characters.
2093 and the rest of the input line is discarded including the escape sequence.
2094 When parsing for a request or a user-defined macro name to be called,
2113 .It Sy "NOT IMPLEMENTED: Bd -file"
2131 .It Sy "missing list type, using -item"
2189 statement has a non-numeric or negative argument or no argument at all.
2262 .Bl -dash -offset 2n -width 2n -compact
2281 with more than one argument or with a non-integer argument
2305 .Bl -ohang
2308 The end of the input line is encountered
2329 range, or an invalid variable-length form
2330 of a single-byte character escape sequence, for example writing
2349 .Qq " %&()*+-./0123456789:<=>"
2354 using the apostrophe-quote character
2359 .Bl -ohang
2360 .It Sy "input too large"
2364 cannot handle input files larger than its arbitrary size limit
2374 was found in an input file.
2378 An input file contains an escape sequence supported by GNU troff
2385 An input file contains a
2410 .It Sy "skipping tbl in -Tman mode"
2412 An input file contains the
2419 input is not supported.
2420 .It Sy "skipping eqn in -Tman mode"
2422 An input file contains the
2429 input is not supported.
2432 .Bl -ohang
2467 .It Sy "\-Tmarkdown unsupported for man(7) input"
2471 option was specified but an input file uses the
2474 No output is produced for that input file.
2499 .An -nosplit