Lines Matching +full:no +full:- +full:output

3 .\" Copyright (c) 2012, 2014-2023 Ingo Schwarze <schwarze@openbsd.org>
12 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
31 .Op Fl T Ar output
47 output.
50 .Bl -tag -width Ds
52 If the standard output is a terminal device and
56 to paginate the output, just like
60 Copy the formatted manual pages to the standard output without using
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
91 .Cm utf-8 .
97 .D1 .\e" -*- Oo ...; Oc coding: Ar encoding ; No -*-
102 If the first non-ASCII byte in the file introduces a valid UTF-8
104 .Cm utf-8 .
107 .Cm iso-8859-1 .
132 Comma-separated output options.
133 See the descriptions of the individual output formats for supported
135 .It Fl T Ar output
136 Select the output format.
138 .Ar output
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.
208 No formatted output will be produced from that file.
241 .Ss ASCII Output
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.
263 To remove the markup, pipe the output to
270 are rendered best-effort in an ASCII equivalent.
277 formatters represent single quotes in ASCII output.
279 Unicode-compatible fonts because contrary to ASCII, Unicode uses
286 .Bl -tag -width Ds
293 When output is to a pager on a terminal that is less than 66 columns
300 output style.
305 output formats in the same way as the
313 If no
325 .Ql man -akO tag Ic=ulimit
329 The output width is set to
332 When output is to a pager on a terminal that is less than 79 columns
334 In any case, lines that are output in literal mode are never wrapped
335 and may exceed the output width.
337 .Ss HTML Output
338 Output produced by
340 conforms to HTML5 using optional self-closing tags.
344 Non-ASCII characters are rendered
350 .Bl -tag -width Ds
384 If no section is included, section 1 is assumed.
403 It provides an appearance similar to terminal output with some additional
406 HTML output, in particular making anchor locations that support
416 .Nm Ns -specific
421 is always adapted to the HTML output generated by the
431 embeds a minimal stylesheet into the HTML output, mostly to select
432 adequate font-style and font-weight attributes for various macros.
433 The result is readable in any graphical or text-based web browser,
434 but does not aim for looking similar to terminal output.
439 .Sx ASCII Output .
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
450 Consequently, for HTML output, this argument does not work with
455 .Ql MANPAGER=less man -T html -O tag=toc mandoc
462 If an input file contains at least two non-standard sections,
463 print a table of contents near the beginning of the output.
465 .Ss Locale Output
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 ;
479 .Sx ASCII Output .
480 This output mode can also be selected explicitly with
482 .Ss Man Output
489 output format.
502 the input is copied to the output.
507 are displayed before copying the input to the output.
508 .Ss Markdown Output
516 The output also almost conforms to the
520 The character set used for the markdown output is ASCII.
521 Non-ASCII characters are encoded as HTML entities.
523 are rendered as code spans and code blocks in the markdown output,
524 non-ASCII characters are transliterated to ASCII approximations in
541 output mode.
542 .Ss PDF Output
543 PDF-1.1 output may be generated by
546 .Sx PostScript Output
550 .Ss PostScript Output
552 .Qq Adobe-3.0
553 Level-2 pages may be generated by
555 Output pages default to letter sized and are rendered in the Times font
556 family, 11-point.
558 Line-height is 1.4m.
561 .Sx ASCII Output .
566 .Bl -tag -width Ds
584 .Ss UTF-8 Output
587 to force text output in UTF-8 multi-byte character encoding,
592 .Sx ASCII Output
598 on those where the internal character representation is not UCS-4,
601 .Sx ASCII Output .
602 .Ss Syntax tree output
616 In the tree dump, each output line shows one syntax tree node.
620 .Bl -enum -compact
629 Node type (text, elem, block, head, body, body-end, tail, tbl, eqn).
632 .Bl -dash -compact
653 NOPRT if the node is not supposed to generate output
654 for any output format.
661 .Bl -tag -width Ds
669 .Bl -tag -width MANPAGER
674 .Sx Locale Output
675 is selected, it decides whether to use ASCII or UTF-8 output format.
678 Any non-empty value of the environment variable
712 .Bl -tag -width Ds -compact
720 occurred, but no warning or error, and
726 At least one warning occurred, but no error, and
733 but no unsupported feature was encountered, and
757 output mode implies
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
827 .Bl -tag -width "warning"
831 Output may all the same be missing or incomplete.
834 No input files have been read and no output is produced.
836 An input file uses unsupported low-level
839 The output may be incomplete and/or misformatted,
887 output mode.
905 .Bl -ohang
949 .Bl -ohang
957 .Dq yyyy-dd-mm .
963 .It Sy "normalizing date format to" : No ...
971 In the formatted output, the month name is written out in full
1006 Simply delete it: it serves no useful purpose.
1071 .It Sy "no blank before trailing delimiter"
1083 It has no effect.
1088 request occurs even though the document already switched to no-fill mode
1090 It has no effect.
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 \-\- ,
1099 because it renders poorly on all other output devices.
1115 Comment lines start with a dot, a backslash, and a double-quote character.
1122 .Bl -ohang
1127 macro has no arguments, or there is no
1129 macro before the first non-prologue macro.
1132 There is no
1134 macro, or it has no arguments.
1150 name extension starts with a non-zero digit, but the
1156 argument that starts with a different non-zero digit.
1165 and it has no
1169 macro has no arguments or only empty arguments;
1172 and it has no
1201 macro occurs after some non-prologue macro, but still takes effect.
1211 .Bl -ohang
1216 .It Sy "no document body"
1331 An AUTHORS sections contains no
1337 .Bl -ohang
1354 .Bl -dash -compact
1358 right before non-compact lists and displays
1360 at the end of items in non-column, non-compact lists
1367 .Bl -dash -compact
1395 .It Sy "skipping no-space macro"
1406 Otherwise, rendered output is likely to look strange in any output
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
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.
1475 resulting in next-line scope.
1478 and there is no other content on its logical input line.
1492 The indicated macro has no arguments and hence no effect.
1503 block contains nothing in its body and will produce no output.
1513 .It Sy "missing display type, using -ragged"
1528 .It Sy "missing -width in -tag list, using 8n"
1583 list has no arguments.
1592 macro has no argument.
1604 macro has no argument, or only one argument and no macro follows
1615 Such an empty block does not produce any output.
1627 .It Sy "missing -std argument, adding it"
1662 .Bl -ohang
1697 .It Sy "skipping -width argument"
1710 That has no effect.
1753 block contains plain text or non-% macros.
1800 .Bl -ohang
1803 The meaning of blank input lines is only well-defined in non-fill mode:
1815 The meaning of tab characters is only well-defined in non-fill mode:
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.
1897 but no matching closing parenthesis.
1898 The rest of the input line, starting from the parenthesis, has no effect.
1906 It will probably produce no output.
1929 .Bl -ohang
1938 macro appears after the first non-prologue macro.
1949 .Bl -dash -compact
1954 expansion of nested user-defined macros,
1960 When a limit is hit, the output is incorrect, typically losing
1976 request, nor as a user-defined macro, nor, respectively, as an
1989 request occurs outside any macro definition and has no effect.
2029 conditional request is encountered but no matching block is open.
2055 next-line scope or
2066 non-whitespace ASCII characters.
2086 the request has no effect at all.
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"
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
2330 range, or an invalid variable-length form
2331 of a single-byte character escape sequence, for example writing
2350 .Qq " %&()*+-./0123456789:<=>"
2353 and the rest of the argument may appear as output text.
2355 using the apostrophe-quote character
2360 .Bl -ohang
2411 .It Sy "skipping tbl in -Tman mode"
2418 output mode, where
2421 .It Sy "skipping eqn in -Tman mode"
2428 output mode, where
2433 .Bl -ohang
2451 option has no argument but requires one.
2463 .It Sy "no such tag"
2468 .It Sy "\-Tmarkdown unsupported for man(7) input"
2475 No output is produced for that input file.
2500 .An -nosplit