Lines Matching +full:display +full:- +full:related

3 .\" Copyright (c) 2012, 2014-2021 Ingo Schwarze <schwarze@openbsd.org>
37 utility formats manual pages for display.
50 .Bl -tag -width Ds
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.
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
329 .Ql man -akO tag Ic=ulimit
344 conforms to HTML5 using optional self-closing tags.
352 documents style-sheet classes available for customising output.
353 If a style-sheet is not specified with
356 defaults to simple output (via an embedded style-sheet)
357 readable in any graphical or text-based web
360 Non-ASCII characters are rendered
366 .Bl -tag -width Ds
410 is used for an external style-sheet.
421 .Bd -literal -offset 3n
422 MANPAGER='lynx -force_html' man -T html -O tag=MANPAGER man
423 MANPAGER='w3m -T text/html' man -T html -O tag=toc mandoc
431 .Ql MANPAGER=less man -T html -O tag=toc mandoc
438 If an input file contains at least two non-standard sections,
444 automatically selects UTF-8 or ASCII output according to the current
452 selects the UTF-8 character encoding, it produces
453 .Sx UTF-8 Output ;
497 Non-ASCII characters are encoded as HTML entities.
500 non-ASCII characters are transliterated to ASCII approximations in
519 PDF-1.1 output may be generated by
528 .Qq Adobe-3.0
529 Level-2 pages may be generated by
532 family, 11-point.
534 Line-height is 1.4m.
542 .Bl -tag -width Ds
560 .Ss UTF-8 Output
563 to force text output in UTF-8 multi-byte character encoding,
574 on those where the internal character representation is not UCS-4,
596 .Bl -enum -compact
605 Node type (text, elem, block, head, body, body-end, tail, tbl, eqn).
608 .Bl -dash -compact
637 .Bl -tag -width Ds
645 .Bl -tag -width MANPAGER
651 is selected, it decides whether to use ASCII or UTF-8 output format.
654 Any non-empty value of the environment variable
688 .Bl -tag -width Ds -compact
738 .Dl $ mandoc -l mandoc.1 man.1 apropos.1 makewhatis.8
742 as the style-sheet:
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
767 .Bd -ragged -offset indent
805 .Bl -tag -width "warning"
814 An input file uses unsupported low-level
883 .Bl -ohang
927 .Bl -ohang
935 .Dq yyyy-dd-mm .
1066 request occurs even though the document already switched to no-fill mode
1072 .It Sy "verbatim \(dq--\(dq, maybe consider using \e(em"
1074 Even though the ASCII output device renders an em-dash as
1075 .Qq \-\- ,
1093 Comment lines start with a dot, a backslash, and a double-quote character.
1099 .Ss Warnings related to the document prologue
1100 .Bl -ohang
1107 macro before the first non-prologue macro.
1128 name extension starts with a non-zero digit, but the
1134 argument that starts with a different non-zero digit.
1179 macro occurs after some non-prologue macro, but still takes effect.
1189 .Bl -ohang
1312 .Ss "Warnings related to macros and nesting"
1313 .Bl -ohang
1330 .Bl -dash -compact
1334 right before non-compact lists and displays
1336 at the end of items in non-column, non-compact lists
1343 .Bl -dash -compact
1371 .It Sy "skipping no-space macro"
1383 format, and rendering in SGML-based output formats is likely to be
1404 display occurs nested inside another
1406 display.
1426 While parsing the next-line scope of the previous macro,
1430 .Ss "Warnings related to missing arguments"
1431 .Bl -ohang
1442 .Bl -dash -compact
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.
1491 .It Sy "missing display type, using -ragged"
1495 macro is invoked without the required display type.
1506 .It Sy "missing -width in -tag list, using 8n"
1601 .It Sy "missing -std argument, adding it"
1635 .Ss "Warnings related to bad macro arguments"
1636 .Bl -ohang
1661 .It Sy "skipping duplicate display type"
1671 .It Sy "skipping -width argument"
1727 block contains plain text or non-% macros.
1764 .Ss "Warnings related to plain text"
1765 .Bl -ohang
1768 The meaning of blank input lines is only well-defined in non-fill mode:
1780 The meaning of tab characters is only well-defined in non-fill mode:
1821 .Ss "Warnings related to tables"
1822 .Bl -ohang
1839 .Ss "Errors related to tables"
1840 .Bl -ohang
1841 .It Sy "non-alphabetic character in tbl options"
1865 As a fallback, a single left-justified column is used.
1906 .Ss "Errors related to roff, mdoc, and man code"
1907 .Bl -ohang
1916 macro appears after the first non-prologue macro.
1927 .Bl -dash -compact
1932 expansion of nested user-defined macros,
1954 request, nor as a user-defined macro, nor, respectively, as an
2033 next-line scope or
2044 non-whitespace ASCII characters.
2073 When parsing for a request or a user-defined macro name to be called,
2085 .It Sy "NOT IMPLEMENTED: Bd -file"
2096 .It Sy "skipping display without arguments"
2103 .It Sy "missing list type, using -item"
2152 statement has a non-numeric or negative argument or no argument at all.
2225 .Bl -dash -offset 2n -width 2n -compact
2244 with more than one argument or with a non-integer argument
2266 .Bl -ohang
2317 .It Sy "skipping tbl in -Tman mode"
2327 .It Sy "skipping eqn in -Tman mode"
2339 .Bl -ohang
2374 .It Sy "\-Tmarkdown unsupported for man(7) input"
2406 .An -nosplit