← man/text
●mandoc — man mandoc — 80×24
ugur@toprak:~/man/text$man mandoc
Bölüm 1 Metin İşleme

mandoc

format manual pages

Synopsis

     mandoc [-ac] [-I os=name] [-K encoding] [-mdoc | -man] [-O options] [-T output] [-W level]
	    [file ...]

Description

The mandoc utility formats manual pages for display.

By default, mandoc reads mdoc(7) or man(7) text from stdin and produces -T locale output.

The options are as follows:

  • -a: If the standard output is a terminal device and -c is not specified, use less(1) to paginate the output, just like man(1) would.

  • -c: Copy the formatted manual pages to the standard output without using less(1) to paginate them. This is the default. It can be specified to override -a.

-I os=name Override the default operating system name for the mdoc(7) Os and for the man(7) TH macro.

-K encoding Specify the input encoding. The supported encoding arguments are us-ascii, iso-8859-1, and utf-8. If not specified, autodetection uses the first match in the following list:

  1. If the first three bytes of the input file are the UTF-8 byte order mark (BOM, 0xefbbbf), input is interpreted as utf-8.

  2. If the first or second line of the input file matches the emacs mode line format

." -- [...;] coding: encoding; --

then input is interpreted according to encoding.

  1. If the first non-ASCII byte in the file introduces a valid UTF-8 sequence, input is interpreted as utf-8.

  2. Otherwise, input is interpreted as iso-8859-1.

-mdoc | -man With -mdoc, all input files are interpreted as mdoc(7). With -man, all input files are interpreted as man(7). By default, the input language is automatically detected for each file: if the first macro is Dd or Dt, the mdoc(7) parser is used; otherwise, the man(7) parser is used. With other arguments, -m is silently ignored.

-O options Comma-separated output options. See the descriptions of the individual output formats for supported options.

-T output Select the output format. Supported values for the output argument are ascii, html, the default of locale, man, markdown, pdf, ps, tree, and utf8.

The special -T lint mode only parses the input and produces no output. It implies -W all and redirects parser messages, which usually appear on standard error output, to standard output.

-W level Specify the minimum message level to be reported on the standard error output and to affect the exit status. The level can be base, style, warning, error, or unsupp. The base level automatically derives the operating system from the contents of the Os macro, from the -Ios command line option, or from the uname(3) return value. The levels openbsd and netbsd are variants of base that bypass autodetection and request validation of base system conventions for a particular operating system. The level all is an alias for base. By default, mandoc is silent. See EXIT STATUS and DIAGNOSTICS for details.

The special option -W stop tells mandoc to exit after parsing a file that causes warnings or errors of at least the requested level. No formatted output will be produced from that file. If both a level and stop are requested, they can be joined with a comma, for example -W error,stop.

file Read from the given input file. If multiple files are specified, they are processed in the given order. If unspecified, mandoc reads from standard input.

The options -fhklw are also supported and are documented in man(1). In -f and -k mode, mandoc also supports the options -CMmOSs described in the apropos(1) manual. The options -fkl are mutually exclusive and override each other.

ASCII Output Use -T ascii to force text output in 7-bit ASCII character encoding documented in the ascii(7) manual page, ignoring the locale(1) set in the environment.

Font styles are applied by using back-spaced encoding such that an underlined character ‘c’ is rendered as ‘_[bs]c’, where ‘[bs]’ is the back-space character number 8. Emboldened characters are rendered as ‘c[bs]c’. This markup is typically converted to appropriate terminal sequences by the pager or ul(1). To remove the markup, pipe the output to col(1) -b instead.

The special characters documented in mandoc_char(7) are rendered best-effort in an ASCII equivalent. In particular, opening and closing ‘single quotes’ are represented as characters number 0x60 and 0x27, respectively, which agrees with all ASCII standards from 1965 to the latest revision (2012) and which matches the traditional way in which roff(7) formatters represent single quotes in ASCII output. This correct ASCII rendering may look strange with modern Unicode-compatible fonts because contrary to ASCII, Unicode uses the code point U+0060 for the grave accent only, never for an opening quote.

The following -O arguments are accepted:

indent=indent The left margin for normal text is set to indent blank characters instead of the default of five for mdoc(7) and seven for man(7). Increasing this is not recommended; it may result in degraded formatting, for example overfull lines or ugly line breaks. When output is to a pager on a terminal that is less than 66 columns wide, the default is reduced to three columns.

mdoc Format man(7) input files in mdoc(7) output style. This prints the operating system name rather than the page title on the right side of the footer line, and it implies -O indent=5. One useful application is for checking that -T man output formats in the same way as the mdoc(7) source it was generated from.

tag[=term] If the formatted manual page is opened in a pager, go to the definition of the term rather than showing the manual page from the beginning. If no term is specified, reuse the first command line argument that is not a section number. If that argument is in apropos(1) key=val format, only the val is used rather than the argument as a whole. This is useful for commands like ‘man -akO tag Ic=ulimit’ to search for a keyword and jump right to its definition in the matching manual pages.

width=width The output width is set to width instead of the default of 78. When output is to a pager on a terminal that is less than 79 columns wide, the default is reduced to one less than the terminal width. In any case, lines that are output in literal mode are never wrapped and may exceed the output width.

HTML Output Output produced by -T html conforms to HTML5 using optional self-closing tags. Default styles use only CSS1. Equations rendered from eqn(7) blocks use MathML.

The file /usr/share/misc/mandoc.css documents style-sheet classes available for customising output. If a style-sheet is not specified with -O style, -T html defaults to simple output (via an embedded style-sheet) readable in any graphical or text-based web browser.

Non-ASCII characters are rendered as hexadecimal Unicode character references.

The following -O arguments are accepted:

fragment Omit the <!DOCTYPE> declaration and the , , and elements and only emit the subtree below the element. The style argument will be ignored. This is useful when embedding manual content within existing documents.

includes=fmt The string fmt, for example, ../src/%I.html, is used as a template for linked header files (usually via the In macro). Instances of ‘%I’ are replaced with the include filename. The default is not to present a hyperlink.

man=fmt[;fmt] The string fmt, for example, ../html%S/%N.%S.html, is used as a template for linked manuals (usually via the Xr macro). Instances of ‘%N’ and ‘%S’ are replaced with the linked manual's name and section, respectively. If no section is included, section 1 is assumed. The default is not to present a hyperlink. If two formats are given and a file %N.%S exists in the current directory, the first format is used; otherwise, the second format is used.

style=style.css The file style.css is used for an external style-sheet. This must be a valid absolute or relative URI.

tag[=term] Same syntax and semantics as for ASCII Output. This is implemented by passing a file:// URI ending in a fragment identifier to the pager rather than passing merely a file name. When using this argument, use a pager supporting such URIs, for example

MANPAGER='lynx -force_html' man -T html -O tag=MANPAGER man MANPAGER='w3m -T text/html' man -T html -O tag=toc mandoc

Consequently, for HTML output, this argument does not work with more(1) or less(1). For example, ‘MANPAGER=less man -T html -O tag=toc mandoc’ does not work because less(1) does not support file:// URIs.

toc If an input file contains at least two non-standard sections, print a table of contents near the beginning of the output.

Locale Output By default, mandoc automatically selects UTF-8 or ASCII output according to the current locale(1). If any of the environment variables LC_ALL, LC_CTYPE, or LANG are set and the first one that is set selects the UTF-8 character encoding, it produces UTF-8 Output; otherwise, it falls back to ASCII Output. This output mode can also be selected explicitly with -T locale.

Man Output Use -T man to translate mdoc(7) input into man(7) output format. This is useful for distributing manual sources to legacy systems lacking mdoc(7) formatters. Embedded eqn(7) and tbl(7) code is not supported.

If the input format of a file is man(7), the input is copied to the output. The parser is also run, and as usual, the -W level controls which DIAGNOSTICS are displayed before copying the input to the output.

Markdown Output Use -T markdown to translate mdoc(7) input to the markdown format conforming to John Gruber's 2004 specification: http://daringfireball.net/projects/markdown/syntax.text. The output also almost conforms to the CommonMark: http://commonmark.org/ specification.

The character set used for the markdown output is ASCII. Non-ASCII characters are encoded as HTML entities. Since that is not possible in literal font contexts, because these are rendered as code spans and code blocks in the markdown output, non-ASCII characters are transliterated to ASCII approximations in these contexts.

Markdown is a very weak markup language, so all semantic markup is lost, and even part of the presentational markup may be lost. Do not use this as an intermediate step in converting to HTML; instead, use -T html directly.

The man(7), tbl(7), and eqn(7) input languages are not supported by -T markdown output mode.

PDF Output PDF-1.1 output may be generated by -T pdf. See PostScript Output for -O arguments and defaults.

PostScript Output PostScript "Adobe-3.0" Level-2 pages may be generated by -T ps. Output pages default to letter sized and are rendered in the Times font family, 11-point. Margins are calculated as 1/9 the page length and width. Line-height is 1.4m.

Special characters are rendered as in ASCII Output.

The following -O arguments are accepted:

paper=name The paper size name may be one of a3, a4, a5, legal, or letter. You may also manually specify dimensions as NNxNN, width by height in millimetres. If an unknown value is encountered, letter is used.

UTF-8 Output Use -T utf8 to force text output in UTF-8 multi-byte character encoding, ignoring the locale(1) settings in the environment. See ASCII Output regarding font styles and -O arguments.

On operating systems lacking locale or wide character support, and on those where the internal character representation is not UCS-4, mandoc always falls back to ASCII Output.

Syntax tree output Use -T tree to show a human readable representation of the syntax tree. It is useful for debugging the source code of manual pages. The exact format is subject to change, so don't write parsers for it.

The first paragraph shows meta data found in the mdoc(7) prologue, on the man(7) TH line, or the fallbacks used.

In the tree dump, each output line shows one syntax tree node. Child nodes are indented with respect to their parent node. The columns are:

  1. For macro nodes, the macro name; for text and tbl(7) nodes, the content. There is a special format for eqn(7) nodes.
  2. Node type (text, elem, block, head, body, body-end, tail, tbl, eqn).
  3. Flags:
  • An opening parenthesis if the node is an opening delimiter.
  • An asterisk if the node starts a new input line.
  • The input line number (starting at one).
  • A colon.
  • The input column number (starting at one).
  • A closing parenthesis if the node is a closing delimiter.
  • A full stop if the node ends a sentence.
  • BROKEN if the node is a block broken by another block.
  • NOSRC if the node is not in the input file, but automatically generated from macros.
  • NOPRT if the node is not supposed to generate output for any output format.

The following -O argument is accepted:

noval Skip validation and show the unvalidated syntax tree. This can help to find out whether a given behaviour is caused by the parser or by the validator. Meta data is not available in this case.

Environment

LC_CTYPE The character encoding locale(1). When Locale Output is selected, it decides whether to use ASCII or UTF-8 output format. It never affects the interpretation of input files.

MANPAGER Any non-empty value of the environment variable MANPAGER is used instead of the standard pagination program, less(1); see man(1) for details. Only used if -a or -l is specified.

PAGER Specifies the pagination program to use when MANPAGER is not defined. If neither PAGER nor MANPAGER is defined, less(1) is used. Only used if -a or -l is specified.

Exit Status

The mandoc utility exits with one of the following values, controlled by the message level associated with the -W option:

0 No base system convention violations, style suggestions, warnings, or errors occurred, or those that did were ignored because they were lower than the requested level. 1 At least one base system convention violation or style suggestion occurred, but no warning or error, and -W base or -W style was specified. 2 At least one warning occurred, but no error, and -W warning or a lower level was requested. 3 At least one parsing error occurred, but no unsupported feature was encountered, and -W error or a lower level was requested. 4 At least one unsupported feature was encountered, and -W unsupp or a lower level was requested. 5 Invalid command line arguments were specified. No input files have been read. 6 An operating system error occurred, for example exhaustion of memory, file descriptors, or process table entries. Such errors may cause mandoc to exit at once, possibly in the middle of parsing or formatting a file.

Note that selecting -T lint output mode implies -W all.

Examples

     To page manuals to the terminal:

	   $ mandoc -l mandoc.1 man.1 apropos.1 makewhatis.8

     To produce HTML manuals with /usr/share/misc/mandoc.css as the style-sheet:

	   $ mandoc -T html -O style=/usr/share/misc/mandoc.css mdoc.7 > mdoc.7.html

     To check over a large set of manuals:

	   $ mandoc -T lint `find /usr/src -name \*\.[1-9]`

     To produce a series of PostScript manuals for A4 paper:

	   $ mandoc -T ps -O paper=a4 mdoc.7 man.7 > manuals.ps

     Convert a modern mdoc(7) manual to the older man(7) format, for use on systems lacking an
     mdoc(7) parser:

	   $ mandoc -T man foo.mdoc > foo.man

Diagnostics

Messages displayed by mandoc follow this format:

mandoc: file:line:column: level: message: macro arguments (os)

The first three fields identify the file name, line number, and column number of the input file where the message was triggered. The line and column numbers start at 1. Both are omitted for messages referring to an input file as a whole. All level and message strings are explained below. The name of the macro triggering the message and its arguments are omitted where meaningless. The os operating system specifier is omitted for messages that are relevant for all operating systems. Fatal messages about invalid command line arguments or operating system errors, for example when memory is exhausted, may also omit the file and level fields.

Message levels have the following meanings:

syserr An operating system error occurred. There isn't necessarily anything wrong with the input files. Output may all the same be missing or incomplete.

badarg Invalid command line arguments were specified. No input files have been read and no output is produced.

unsupp An input file uses unsupported low-level roff(7) features. The output may be incomplete and/or misformatted, so using GNU troff instead of mandoc to process the file may be preferable.

error Indicates a risk of information loss or severe misformatting, in most cases caused by serious syntax errors.

warning Indicates a risk that the information shown or its formatting may mismatch the author's intent in minor ways. Additionally, syntax errors are classified at least as warnings, even if they do not usually cause misformatting.

style An input file uses dubious or discouraged style. This is not a complaint about the syntax, and probably neither formatting nor portability are in danger. While great care is taken to avoid false positives on the higher message levels, the style level tries to reduce the probability that issues go unnoticed, so it may occasionally issue bogus suggestions. Please use your good judgement to decide whether any particular style suggestion really justifies a change to the input file.

base A convention used in the base system of a specific operating system is not adhered to. These are not markup mistakes, and neither the quality of formatting nor portability are in danger. Messages of the base level are printed with the more intuitive style level tag.

Messages of the base, style, warning, error, and unsupp levels are hidden unless their level, or a lower level, is requested using a -W option or -T lint output mode.

As indicated below, all base and some style checks are only performed if a specific operating system name occurs in the arguments of the -W command line option, of the Os macro, of the -Ios command line option, or, if neither are present, in the return value of the uname(3) function.

Conventions for base system manuals Mdocdate found (mdoc, NetBSD) The Dd macro uses CVS Mdocdate keyword substitution, which is not supported by the NetBSD base system. Consider using the conventional “Month dd, yyyy” format instead.

Mdocdate missing (mdoc, OpenBSD) The Dd macro does not use CVS Mdocdate keyword substitution, but using it is conventionally expected in the OpenBSD base system.

unknown architecture (mdoc, OpenBSD, NetBSD) The third argument of the Dt macro does not match any of the architectures this operating system is running on.

operating system explicitly specified (mdoc, OpenBSD, NetBSD) The Os macro has an argument. In the base system, it is conventionally left blank.

RCS id missing (OpenBSD, NetBSD) The manual page lacks the comment line with the RCS identifier generated by CVS OpenBSD or NetBSD keyword substitution as conventionally used in these operating systems.

Style suggestions legacy man(7) date format (mdoc) The Dd macro uses the legacy man(7) date format “yyyy-dd-mm”. Consider using the conventional mdoc(7) date format “Month dd, yyyy” instead.

normalizing date format to: ... (mdoc, man) The Dd or TH macro provides an abbreviated month name or a day number with a leading zero. In the formatted output, the month name is written out in full and the leading zero is omitted.

lower case character in document title (mdoc, man) The title is still used as given in the Dt or TH macro.

duplicate RCS id A single manual page contains two copies of the RCS identifier for the same operating system. Consider deleting the later instance and moving the first one up to the top of the page.

possible typo in section name (mdoc) Fuzzy string matching revealed that the argument of an Sh macro is similar, but not identical to a standard section name.

unterminated quoted argument (roff) Macro arguments can be enclosed in double quote characters such that space characters and macro names contained in the quoted argument need not be escaped. The closing quote of the last argument of a macro can be omitted. However, omitting it is not recommended because it makes the code harder to read.

useless macro (mdoc) A Bt, Tn, or Ud macro was found. Simply delete it: it serves no useful purpose.

consider using OS macro (mdoc) A string was found in plain text or in a Bx macro that could be represented using Ox, Nx, Fx, or Dx.

errnos out of order (mdoc, NetBSD) The Er items in a Bl list are not in alphabetical order.

duplicate errno (mdoc, NetBSD) A Bl list contains two consecutive It entries describing the same Er number.

referenced manual not found (mdoc) An Xr macro references a manual page that was not found. When running with -W base, the search is restricted to the base system, by default to /usr/share/man:/usr/X11R6/man. This path can be configured at compile time using the MANPATH_BASE preprocessor macro. When running with -W style, the search is done along the full search path as described in the man(1) manual page, respecting the -m and -M command line options, the MANPATH environment variable, the man.conf(5) file and falling back to the default of /usr/share/man:/usr/X11R6/man:/usr/local/man, also configurable at compile time using the MANPATH_DEFAULT preprocessor macro.

trailing delimiter (mdoc) The last argument of an Ex, Fo, Nd, Nm, Os, Sh, Ss, St, or Sx macro ends with a trailing delimiter. This is usually bad style and often indicates typos. Most likely, the delimiter can be removed.

no blank before trailing delimiter (mdoc) The last argument of a macro that supports trailing delimiter arguments is longer than one byte and ends with a trailing delimiter. Consider inserting a blank such that the delimiter becomes a separate argument, thus moving it out of the scope of the macro.

fill mode already enabled, skipping (man) A fi request occurs even though the document is still in fill mode, or already switched back to fill mode. It has no effect.

fill mode already disabled, skipping (man) An nf request occurs even though the document already switched to no-fill mode and did not switch back to fill mode yet. It has no effect.

input text line longer than 80 bytes Consider breaking the input text line at one of the blank characters before column 80.

verbatim "--", maybe consider using (em (mdoc) Even though the ASCII output device renders an em-dash as "--", that is not a good way to write it in an input file because it renders poorly on all other output devices.

function name without markup (mdoc) A word followed by an empty pair of parentheses occurs on a text line. Consider using an Fn or Xr macro.

whitespace at end of input line (mdoc, man, roff) Whitespace at the end of input lines is almost never semantically significant — but in the odd case where it might be, it is extremely confusing when reviewing and maintaining documents.

bad comment style (roff) Comment lines start with a dot, a backslash, and a double-quote character. The mandoc utility treats the line as a comment line even without the backslash, but leaving out the backslash might not be portable.

Warnings related to the document prologue missing manual title, using UNTITLED (mdoc) A Dt macro has no arguments, or there is no Dt macro before the first non-prologue macro.

missing manual title, using "" (man) There is no TH macro, or it has no arguments.

missing manual section, using "" (mdoc, man) A Dt or TH macro lacks the mandatory section argument.

unknown manual section (mdoc) The section number in a Dt line is invalid, but still used.

filename/section mismatch (mdoc, man) The name of the input file being processed is known and its file name extension starts with a non-zero digit, but the Dt or TH macro contains a section argument that starts with a different non-zero digit. The section argument is used as provided anyway. Consider checking whether the file name or the argument need a correction.

missing date, using "" (mdoc, man) The document was parsed as mdoc(7) and it has no Dd macro, or the Dd macro has no arguments or only empty arguments; or the document was parsed as man(7) and it has no TH macro, or the TH macro has less than three arguments or its third argument is empty.

cannot parse date, using it verbatim (mdoc, man) The date given in a Dd or TH macro does not follow the conventional format.

date in the future, using it anyway (mdoc, man) The date given in a Dd or TH macro is more than a day ahead of the current system time(3).

missing Os macro, using "" (mdoc) The default or current system is not shown in this case.

late prologue macro (mdoc) A Dd or Os macro occurs after some non-prologue macro, but still takes effect.

prologue macros out of order (mdoc) The prologue macros are not given in the conventional order Dd, Dt, Os. All three macros are used even when given in another order.

Warnings regarding document structure .so is fragile, better use ln(1) (roff) Including files only works when the parser program runs with the correct current working directory.

no document body (mdoc, man) The document body contains neither text nor macros. An empty document is shown, consisting only of a header and a footer line.

content before first section header (mdoc, man) Some macros or text precede the first Sh or SH section header. The offending macros and text are parsed and added to the top level of the syntax tree, outside any section block. first section is not NAME (mdoc) İlk Sh makrosunun argümanı ‘NAME’ değil. Bu durum makwhatis(8) ve apropos(1) komutlarının kafasını karıştırabilir.

NAME section without Nm before Nd (mdoc) NAME bölümü, ilk Nd makrosundan önce herhangi bir Nm alt makrosu içermiyor.

NAME section without description (mdoc) NAME bölümünde zorunlu Nd alt makrosu eksik.

description not at the end of NAME (mdoc) NAME bölümü bir Nd alt makrosu içeriyor, ancak bunu başka içerikler takip ediyor.

bad NAME section content (mdoc) NAME bölümü, Nm ve Nd dışındaki düz metin veya makrolar içeriyor.

missing comma before name (mdoc) NAME bölümü, ne ilk sırada olan ne de önünde virgül bulunan bir Nm makrosu içeriyor.

missing description line, using "" (mdoc) Nd makrosunda gerekli argüman eksik. Kılavuzun başlık satırı tire işaretinden sonra sona erecektir.

description line outside NAME section (mdoc) NAME bölümünün dışında bir Nd makrosu görünüyor. Argümanlar yine de yazdırılır ve takip eden metin apropos(1) için kullanılır, ancak bu davranışların hiçbiri taşınabilir değildir.

sections out of conventional order (mdoc) Standart bir bölüm, genellikle kendisinden sonra gelmesi gereken başka bir bölümden sonra yer alıyor. Tüm bölüm başlıkları verildikleri gibi kullanılır ve bölümlerin sırası değiştirilmez.

duplicate section title (mdoc) Aynı standart bölüm başlığı birden fazla kez geçiyor.

unexpected section (mdoc) Kılavuzun normalde yararlı olmadığı bir bölümünde standart bir bölüm başlığı yer alıyor.

cross reference to self (mdoc) Bir Xr makrosu, mevcut kılavuz sayfasının bölümüyle eşleşen bir ada ve bölüme, NAME veya SYNOPSIS bölümündeki bir Nm makrosunda belirtilen bir ada ya da SYNOPSIS içindeki bir Fn veya Fo makrosuna atıfta bulunuyor. Xr yerine Nm veya Fn kullanmayı düşünün.

unusual Xr order (mdoc) SEE ALSO bölümünde, daha düşük bölüm numarasına sahip bir Xr makrosu, daha yüksek numaralı bir makroyu takip ediyor veya aynı bölüme atıfta bulunan iki Xr makrosu alfabetik sıra dışında yer alıyor.

unusual Xr punctuation (mdoc) SEE ALSO bölümünde, iki Xr makrosu arasındaki noktalama işareti tek bir virgülden farklı veya son Xr makrosundan sonra fazladan bir noktalama işareti var.

AUTHORS section without An macro (mdoc) AUTHORS bölümü hiçbir An makrosu içermiyor veya yalnızca boş olanları içeriyor. Muhtemelen, işaretlemesi (markup) eksik yazar isimleri var.

Warnings related to macros and nesting Makrolar ve iç içe yerleştirmelerle ilgili uyarılar obsolete macro (mdoc) Alternatifler için mdoc(7) kılavuzuna bakın.

macro neither callable nor escaped (mdoc) Çağrılabilir olmayan bir makronun adı bir makro satırında görünüyor. Olduğu gibi yazdırılır. Amaç bunu çağırmaksa, kendi girdi satırına taşıyın; aksi takdirde önüne ‘&’ ekleyerek kaçış karakteri uygulayın.

skipping paragraph macro mdoc(7) belgelerinde bu durum şuralarda gerçekleşir:

  • bölümlerin ve alt bölümlerin başında ve sonunda
  • sıkıştırılmamış (non-compact) listelerin ve ekranların (displays) hemen önünde
  • sütun olmayan, sıkıştırılmamış listelerdeki öğelerin sonunda
  • ve birden fazla ardışık paragraf makrosu için. man(7) belgelerinde ise şuralarda gerçekleşir:
  • boş P, PP ve LP makroları için
  • ne başlık ne de gövde argümanı olan IP makroları için
  • SH veya SS'den hemen sonraki br veya sp için

moving paragraph macro out of list (mdoc) Bir Bl listesindeki bir liste öğesi, sonda bir paragraf makrosu içeriyor. Paragraf makrosu listenin sonundan sonraya taşınır.

skipping no-space macro (mdoc) Bir girdi satırı bir Ns makrosuyla başlıyor veya bir Ns makrosundan sonraki ilk argüman yalıtılmış bir kapatma sınırlayıcısıdır. Makro yoksayılır.

blocks badly nested (mdoc) İki blok kesişiyorsa, biri diğerini tamamen içermelidir. Aksi takdirde, oluşturulan çıktı herhangi bir çıktı biçiminde garip görünecektir ve SGML tabanlı çıktı biçimlerindeki görselleştirme tamamen yanlış olacaktır çünkü bu tür diller kötü iç içe yerleştirilmiş blokları hiçbir şekilde desteklemez. Kötü iç içe yerleştirilmiş blokların tipik örnekleri "Ao Bo Ac Bc" ve "Ao Bq Ac" şeklindedir. Bu örneklerde Ac sırasıyla Bo ve Bq bloklarını keser.

nested displays are not portable (mdoc) Bir Bd, D1 veya Dl ekranı, başka bir Bd ekranının içinde iç içe geçmiş olarak bulunuyor. Bu mandoc ile çalışır, ancak diğer birçok uygulamada başarısız olur.

moving content out of list (mdoc) Bir Bl liste bloğu, ilk It makrosundan önce metin veya makrolar içeriyor. Hatalı alt öğeler listenin başlangıcından öncesine taşınır.

first macro on line Bir Bl -column listesi içinde, bir Ta makrosu satırdaki ilk makro olarak geçiyor ki bu taşınabilir değildir.

line scope broken (man) Bir önceki makronun sonraki satır kapsamı ayrıştırılırken, bir öncekini vaktinden önce sonlandıran başka bir makro bulunuyor. Kesintiye uğrayan önceki makro, ayrıştırma ağacından silinir.

Warnings related to missing arguments Eksik argümanlarla ilgili uyarılar skipping empty request (roff, eqn) Bir makro tanımlama isteğinde makro adı eksik veya bir eqn(7) kontrol ifadesi ya da işlem anahtar kelimesinde gerekli argüman bulunmuyor.

conditional request controls empty scope (roff) Koşullu bir istek, yalnızca aynı mantıksal girdi satırında aşağıdakilerden biri onu takip ediyorsa kullanışlıdır:

  • Çok satırlı bir kapsam açmak için ‘{’ anahtar kelimesi.
  • Tek satırlı bir kapsamla sonuçlanan bir istek, makro veya bir metin.
  • Herhangi bir ara boşluk olmaksızın mantıksal satırın hemen sonlanması, bu da sonraki satır kapsamıyla sonuçlanır. Burada, koşullu bir isteği yalnızca satır sonu boşluğu takip ediyor ve mantıksal girdi satırında başka hiçbir içerik bulunmuyor. Mantıksal girdi satırının ‘\’ satır devam ettirme karakterleri kullanılarak birden fazla fiziksel girdi satırına bölünmüş olmasının bir önemi olmadığını unutmayın. Bu, satır sonu boşluğunun sözdizimsel olarak önemli olduğu nadir durumlardan biridir. Koşullu istek yalnızca boşluk içeren bir kapsamı kontrol eder, bu nedenle sonraki bir el ifadesini kontrol etmesi dışında önemli bir etkiye sahip olması olası değildir.

skipping empty macro (mdoc) Belirtilen makronun hiçbir argümanı yoktur ve bu nedenle hiçbir etkisi yoktur.

empty block (mdoc, man) Bir Bd, Bk, Bl, D1, Dl, MT, RS veya UR bloğunun gövdesinde hiçbir şey yoktur ve çıktı üretmeyecektir.

empty argument, using 0n (mdoc) Bd veya Bl -offset ya da -width sonrasında gerekli genişlik eksik.

missing display type, using -ragged (mdoc) Bd makrosu gerekli ekran türü belirtilmeden çağrılıyor.

list type is not the first argument (mdoc) Bir Bl makrosunda, tür argümanından önce en az bir başka argüman yer alıyor. mandoc aracı her türlü argüman sırasıyla başa çıkabilir, ancak diğer bazı mdoc(7) uygulamaları bunu yapamaz.

missing -width in -tag list, using 8n (mdoc) -tag argümanına sahip her Bl makrosu -width seçeneğini de gerektirir.

missing utility name, using "" (mdoc) Ex -std makrosu, Nm henüz bir argümanla çağrılmadan önce bir argüman olmadan çağrılıyor.

missing function name, using "" (mdoc) Fo makrosu bir argüman olmadan çağrılıyor. Hiçbir işlev adı yazdırılmaz.

empty head in list item (mdoc) Bir Bl -diag, -hang, -inset, -ohang veya -tag listesinde, bir It makrosunda gerekli argüman eksik. Öğe başlığı boş bırakılır.

empty list item (mdoc) Bir Bl -bullet, -dash, -enum veya -hyphen listesinde bir It bloğu boş. Boş bir liste öğesi gösterilir.

missing argument, using next line (mdoc) Bir Bd -column listesindeki bir It makrosunun hiçbir argümanı yok. mandoc, hücre için varsa bir sonraki satırın metnini veya makrolarını kullanırken, diğer biçimlendiriciler listeyi yanlış biçimlendirebilir.

missing font type, using \fR (mdoc) Bir Bf makrosunun hiçbir argümanı yok. Varsayılan yazı tipine geçiş yapar.

unknown font type, using \fR (mdoc) Bf argümanı geçersiz. Bunun yerine varsayılan yazı tipi kullanılır.

nothing follows prefix (mdoc) Bir Pf makrosunun hiçbir argümanı yok veya yalnızca tek bir argümanı var ve aynı girdi satırında onu takip eden hiçbir makro bulunmuyor. Bu, amacını bozar; özellikle, bir sonraki girdi satırında takip eden metin veya makrolardan önce boşlukların bastırılması gerçekleştirilmez.

empty reference block (mdoc) Bir Rs makrosunu, bir sonraki girdi satırında hemen bir Re makrosu takip ediyor. Böyle boş bir blok herhangi bir çıktı üretmez.

missing section argument (mdoc) Bir Xr makrosunda ikinci, bölüm numarası argümanı eksik. İlk argüman, yani ad yazdırılır, ancak ardından gelen parantezler gösterilmez.

missing -std argument, adding it (mdoc) Bir Ex veya Rv makrosunda gerekli -std argümanı eksik. mandoc aracı belirtilmemiş olsa bile -std olduğunu varsayar, ancak diğer uygulamalar bunu varsaymayabilir.

missing option string, using "" (man) OP makrosu hiçbir argüman olmadan çağrılıyor. Boş bir köşeli parantez çifti gösterilir.

missing resource identifier, using "" (man) MT veya UR makrosu hiçbir argüman olmadan çağrılıyor. Boş bir açılı ayraç çifti gösterilir.

missing eqn box, using "" (eqn) Bir ayırt edici işaret (diacritic mark) veya ikili işleç bulundu, ancak solunda hiçbir şey yok. Boş bir kutu eklenir.

Warnings related to bad macro arguments Hatalı makro argümanlarıyla ilgili uyarılar duplicate argument (mdoc) Bir Bd veya Bl makrosunda birden fazla -compact, birden fazla -offset veya birden fazla -width argümanı var. Bu argümanların sonuncusu hariç tümü yoksayılır.

skipping duplicate argument (mdoc) Bir An makrosunda birden fazla -split veya -nosplit argümanı var. Bu argümanların ilki hariç tümü yoksayılır.

skipping duplicate display type (mdoc) Bir Bd makrosunda birden fazla tür argümanı var; ilki kullanılır.

skipping duplicate list type (mdoc) Bir Bl makrosunda birden fazla tür argümanı var; ilki kullanılır.

skipping -width argument (mdoc) Bir Bl -column, -diag, -ohang, -inset veya -item listesinde bir -width argümanı var. Bunun hiçbir etkisi yoktur.

wrong number of cells Bir Bl -column listesinin bir satırında, sekmelerin veya Ta makrolarının sayısı liste başlığı satırından beklenen sayıdan azdır veya beklenen sayıyı birden fazla aşmaktadır. Eksik hücreler boş kalır ve sütun sayısını aşan tüm hücreler tek bir hücrede birleştirilir.

unknown AT&T UNIX version (mdoc) Bir At makrosunun geçersiz bir argümanı var. Başına "AT&T UNIX " getirilerek olduğu gibi kullanılır.

comma in function argument (mdoc) Bir Fa veya Fn makrosunun argümanı virgül içeriyor; muhtevelen iki argümana bölünmesi gerekir.

parenthesis in function name (mdoc) Bir Fc veya Fn makrosunun ilk argümanı bir açılış veya kapanış parantezi içeriyor; bu muhtevelen yanlıştır, parantezler otomatik olarak eklenir.

unknown library name (mdoc, OpenBSD'de değil) Bir Lb makrosunun bilinmeyen bir ad argümanı var ve "library “name”" olarak görselleştirilecektir.

invalid content in Rs block (mdoc) Bir Rs bloğu düz metin veya % dışındaki makrolar içeriyor. Hatalı içerik sözdizimi ağacında bırakılır. Biçimlendirme zayıf olabilir.

invalid Boolean argument (mdoc) Bir Sm makrosunun on veya off dışında bir argümanı var. Geçersiz argüman makrodan dışarı taşınır, bu da makroyu boş bırakarak boşluk modunu değiştirmesine (toggle) neden olur.

argument contains two font escapes (roff) Bir char isteğinin ikinci argümanı birden fazla yazı tipi kaçış dizisi içeriyor. Karakter kullanıldıktan sonra yanlış bir yazı tipi aktif kalabilir.

unknown font, skipping request (man, tbl) Bir roff(7) ft isteği veya bir tbl(7) f düzen değiştiricisi bilinmeyen bir yazı tipi argümanına sahip.

odd number of characters in request (roff) Bir tr isteği tek sayıda karakter içeriyor. Son karakter boş karakterle eşleştirilir.

Warnings related to plain text Düz metinle ilgili uyarılar blank line in fill mode, using .sp (mdoc) Boş girdi satırlarının anlamı yalnızca doldurmasız (non-fill) modda iyi tanımlanmıştır: Doldurma (fill) modunda, metin girdi satırlarının satır sonlarının önemli olmaması gerekir. Ancak groff ile uyumluluk için, doldurma modundaki boş satırlar sp istekleri gibi biçimlendirilir. Paragraf sonu talep etmek için boş satır yerine Pp kullanın.

tab in filled text (mdoc, man) Sekme (tab) karakterlerinin anlamı yalnızca doldurmasız modda iyi tanımlanmıştır: Doldurma modunda, metin girdi satırlarındaki boşlukların önemli olmaması gerekir. Uygulamaya bağlı bir tercih olarak, metin satırlarındaki sekme karakterleri her durumda biçimlendiricilere iletilir. Sekme karakterinden önceki metnin doldurulacağı göz önüne alındığında, sekmenin hangi sekme durağı konumuna ilerleyeceğini tahmin etmek zordur.

new sentence, new line (mdoc) Metin satırının ortasında yeni bir cümle başlıyor. Biçimlendiricilerin doğru boşluk üretmesine yardımcı olmak için yeni bir girdi satırından başlatın.

invalid escape sequence (roff) Bir kaçış dizisinin geçersiz bir açılış argüman sınırlayıcısı var, kapanış argüman sınırlayıcısı eksik, argüman geçersiz bir biçimde veya geçersiz bir ada sahip bir karakter kaçış dizisidir. Argüman eksikse, * ve \n boş bir dizgeye, \B ‘0’ rakamına ve \w eksik argümanın uzunluğuna genişletilir. Diğer tüm geçersiz kaçış dizileri yoksayılır.

undefined escape, printing literally (roff) Bir kaçış dizisinde, öndeki ters eğik çizgiden hemen sonraki ilk karakter geçersizdir. O karakter olduğu gibi yazdırılır, bu da ters eğik çizgiyi yoksaymakla eşdeğerdir.

undefined string, using "" (roff) Bir dizge daha önce tanımlanmadan kullanılırsa, değeri örtük olarak boş dizgeye ayarlanır. Ancak dizgelerin kullanımdan önce açıkça tanımlanması kodun daha okunabilir kalmasını sağlar.

Warnings related to tables Tablolarla ilgili uyarılar tbl line starts with span (tbl) Bir tablo düzeni satırındaki ilk hücre yatay bir yayılımdır (‘s’). Bu hücre için sağlanan veriler yoksayılır ve hücreye hiçbir şey yazdırılmaz.

tbl column starts with span (tbl) Bir tablo düzeni spesifikasyonunun ilk satırı dikey bir yayılım (‘^’) talep ediyor. Bu hücre için sağlanan veriler yoksayılır ve hücreye hiçbir şey yazdırılmaz.

skipping vertical bar in tbl layout (tbl) Bir tablo düzeni spesifikasyonu ikiden fazla ardışık dikey çubuk içeriyor. Çift çubuk yazdırılır, tüm ek çubuklar atılır.

Errors related to tables Tablolarla ilgili hatalar non-alphabetic character in tbl options (tbl) Tablo seçenekleri satırı, bir seçenek adının başlangıcının beklendiği yerde harf, boşluk veya virgül dışında bir karakter içeriyor. Karakter yoksayılır.

skipping unknown tbl option (tbl) Tablo seçenekleri satırı, bilinen herhangi bir seçenek adıyla eşleşmeyen bir harf dizisi içeriyor. Sözcük yoksayılır.

missing tbl option argument (tbl) Argüman gerektiren bir tablo seçeneğini bir açılış parantezi takip etmiyor veya açılış parantezini hemen bir kapanış parantezi takip ediyor. Seçenek yoksayılır.

wrong tbl option argument size (tbl) Bir tablo seçeneği argümanı geçersiz sayıda karakter içeriyor. Hem seçenek hem de argüman yoksayılır.

empty tbl layout (tbl) Bir tablo düzeni spesifikasyonu tamamen boş, sıfır satır ve sıfır sütun belirtiyor. Geri çekilme planı (fallback) olarak sola yaslı tek bir sütun kullanılır.

invalid character in tbl layout (tbl) Bir tablo düzeni spesifikasyonu, ne bir düzen anahtar karakteri ne de bir düzen değiştirici olarak yorumlanabilen bir karakter içeriyor veya ilk anahtardan önce bir değiştirici geliyor. Geçersiz karakter atılır.

unmatched parenthesis in tbl layout (tbl) Bir tablo düzeni spesifikasyonu bir açılış parantezi içeriyor, ancak eşleşen bir kapanış parantezi yok. Girdi satırının geri kalanının, parantezden itibaren hiçbir etkisi yoktur.

ignoring excessive spacing in tbl layout (tbl) Tablo düzenindeki bir boşluk değiştirici makul olmayacak kadar büyük. Bunun yerine varsayılan olan 3n boşluk kullanılır.

tbl without any data cells (tbl) Bir tablo hiçbir veri hücresi içermiyor. Muhtemelen çıktı üretmeyecektir.

ignoring data in spanned tbl cell (tbl) Bir tablo hücresi, tablo düzeninde yatay bir yayılım (‘s’) veya dikey bir yayılım (‘^’) olarak işaretlenmiş, ancak veri içeriyor. Veri yoksayılır.

ignoring extra tbl data cells (tbl) Bir veri satırı karşılık gelen düzen satırından daha fazla hücre içeriyor. Fazladan hücrelerdeki veriler yoksayılır.

data block open at end of tbl (tbl) Bir veri bloğu T{ ile açılmış, ancak hiçbir zaman eşleşen bir T} ile kapatılmamış. Tablonun kalan veri satırlarının tümü tek bir hücreye yerleştirilir ve kalan tüm hücreler boş kalır.

Errors related to roff, mdoc, and man code roff, mdoc ve man kodlarıyla ilgili hatalar duplicate prologue macro (mdoc) Giriş (prologue) makrolarından biri birden fazla kez geçiyor. Son örnek öncekilerin hepsini geçersiz kılar.

skipping late title macro (mdoc) Dt makrosu ilk giriş dışı makrodan sonra görünüyor. Geleneksel biçimlendiriciler bununla başa çıkamaz çünkü sayfa başlığını belge gövdesini ayrıştırmadan önce yazarlar. Bu teknik kısıtlama mandoc için geçerli olmasa bile, geleneksel anlambilim korunur. Geç kalan makro argümanlarıyla birlikte atılır.

input stack limit exceeded, infinite loop? (roff) Sonsuz döngüleri önlemek için aşağıdaki özellikler için açık özyineleme (recursion) sınırları uygulanmıştır:

  • dizgilerin ve sayı yazmaçlarının (number registers) genişletilmesi dahil olmak üzere iç içe geçmiş kaçış dizilerinin genişletilmesi,
  • iç içe geçmiş kullanıcı tanımlı makroların genişletilmesi,
  • ve dosya dahil etme (inclusion). Bir sınıra ulaşıldığında çıktı yanlış olur, genellikle bazı içerikler kaybolur, ancak ayrıştırıcı devam edebilir.

skipping bad character (mdoc, man, roff) Girdi dosyası yazdırılabilir bir ascii(7) karakteri olmayan bir bayt içeriyor. Mesaj karakter numarasını belirtir. Hatalı bayt bir soru işareti (‘?’) ile değiştirilir. Baytı hedeflenen karakterin bir ASCII harf çevirisi ile değiştirmek için girdi dosyasını düzenlemeyi düşünün.

skipping unknown macro (mdoc, man, roff) Bir istek veya makro satırındaki ilk tanımlayıcı ne bir roff(7) isteği, ne kullanıcı tanımlı bir makro ne de sırasıyla bir mdoc(7) veya man(7) makrosu olarak tanınmıyor. Yanlış yazılmış veya desteklenmiyor olabilir. İstek veya makro, argümanlarıyla birlikte atılır.

skipping request outside macro (roff) Bir shift veya return isteği herhangi bir makro tanımının dışında gerçekleşiyor ve hiçbir etkisi yok.

skipping insecure request (roff) Bir girdi dosyası bir kabuk komutu çalıştırmaya ya da harici bir dosyayı okumaya veya yazmaya çalıştı. Güvenlik nedenleriyle bu tür girişimler reddedilir.

skipping item outside list (mdoc, eqn) Bir It makrosu herhangi bir Bl listesinin dışında gerçekleşiyor veya bir eqn(7) above sınırlayıcısı herhangi bir yığının (pile) dışında gerçekleşiyor. Argümanlarıyla birlikte atılır.

skipping column outside column list (mdoc) Bir Ta makrosu herhangi bir Bl -column bloğunun dışında gerçekleşiyor. Argümanlarıyla birlikte atılır.

skipping end of block that is not open (mdoc, man, eqn, tbl, roff) Çeşitli sözdizimi öğeleri, yalnızca daha önce açılmış olan blokları açıkça kapatmak için kullanılabilir. Bir mdoc(7) blok kapatma makrosu, bir man(7) ME, RE veya UE makrosu, bir eqn(7) sağ sınırlayıcısı veya kapatma süslü parantezi ya da bir denklemin, tablonun veya roff(7) koşullu isteğinin sonu ile karşılaşıldı ancak eşleşen hiçbir blok açık değil. Hatalı istek veya makro atılır.

fewer RS blocks open, skipping (man) RE makrosu bir argümanla çağrılıyor, ancak belirtilen sayıdan daha az sayıda RS bloğu açık. RE makrosu atılır.

inserting missing end of block (mdoc, tbl) Çeşitli mdoc(7) makrolarının yanı sıra tablolar, özel makrolarla açıkça kapatılmayı gerektirir. Hatalı iç içe yerleştirmeyi desteklemeyen bir blok, tüm alt öğeleri düzgün bir şekilde kapatılmadan önce sona eriyor. Açık alt düğümler örtük olarak kapatılır.

appending missing end of block (mdoc, man, eqn, tbl, roff) Belgenin sonunda, açık bir mdoc(7) bloğu, bir man(7) sonraki satır kapsamı veya MT, RS ya da UR bloğu, bir denklem, tablo ya da roff(7) koşullu veya yoksayma bloğu hala açık. Açık blok örtük olarak kapatılır.

escaped character not allowed in a name (roff) Makro, dizge ve yazmaç (register) tanımlayıcıları yazdırılabilir, boşluk olmayan ASCII karakterlerinden oluşur. Kaçış dizileri ile bunları ifade eden karakter ve dizgeler bir adın parçası olamaz. Bir am, as, de, ds, nr veya rr isteğinin ilk argümanı ya da bir rm isteğinin herhangi bir argümanı ya da çağrılmakta olan bir istek veya kullanıcı tanımlı makronun adı bir kaçış dizisi ile sonlandırılıyor. as, ds ve nr durumlarında isteğin hiçbir etkisi yoktur. am, de, rr ve rm durumlarında bu noktaya kadar ayrıştırılanlar isteğin argümanları olarak kullanılır ve girdi satırının geri kalanı kaçış dizisi dahil olmak üzere atılır. Çağrılacak bir istek veya kullanıcı tanımlı bir makro adı için ayrıştırma yapılırken yalnızca kaçış dizisi atılır. Ondan önceki karakterler istek veya makro adı olarak, onu takip eden karakterler ise istek veya makronun argümanları olarak kullanılır.

using macro argument outside macro (roff) $ kaçış dizisi herhangi bir makro tanımının dışında gerçekleşiyor ve boş dizgeye genişliyor.

argument number is not numeric (roff) $ kaçış dizisinin argümanı bir rakam değil; kaçış dizisi boş dizgeye genişliyor.

NOT IMPLEMENTED: Bd -file (mdoc) Güvenlik nedenleriyle, Bd makrosu -file argümanını desteklemez. Hassas bir dosyanın dahil edilmesini talep ederek, kötü niyetli bir belge, yetkili bir kullanıcıyı farkında olmadan dosyayı ekranda görüntülemesi için kandırabilir ve dosya içeriğini çevredekiler için ifşa edebilir. Argüman, onu takip eden dosya adı dahil olmak üzere yoksayılır.

skipping display without arguments (mdoc) Bir Bd blok makrosunun hiçbir argümanı yok. Blok atılır ve blok içeriği, bloktan önce hangi mod aktifse o modda görüntülenir.

missing list type, using -item (mdoc) Bir Bl makrosu liste türünü belirtemiyor.

argument is not numeric, using 1 (roff) Bir ce isteğinin argümanı bir sayı değil.

argument is not a character (roff) Bir char isteğinin ilk argümanı ne tek bir ASCII karakteri ne de tek bir karakter kaçış dizisidir. İstek, tüm argümanları dahil olmak üzere yoksayılır.

missing manual name, using "" (mdoc) Nm makrosuna yapılan ilk çağrıda veya NAME bölümündeki herhangi bir çağrıda gerekli argüman eksik.

uname(3) system call failed, using UNKNOWN (mdoc) Os makrosu argümansız çağrılıyor ve uname(3) sistem çağrısı başarısız oldu. Geçici bir çözüm olarak, mandoc -DOSNAME=""dizge"" ile derlenebilir.

unknown standard specifier (mdoc) Bir St makrosunun bilinmeyen bir argümanı var ve atılıyor.

skipping request without numeric argument (roff, eqn) Bir it isteği ya da bir eqn(7) size veya gsize ifadesi sayısal olmayan veya negatif bir argümana sahip ya da hiç argümana sahip değil. Geçersiz istek veya ifade yoksayılır.

excessive shift (roff) Bir shift isteğinin argümanı, şu anda yürütülmekte olan makronun argüman sayısından daha büyüktür. Tüm makro argümanları silinir ve \n(.$ sıfıra ayarlanır.

NOT IMPLEMENTED: .so with absolute path or ".." (roff) Güvenlik nedenleriyle, mandoc so dosya dahil etme isteklerine yalnızca göreli yollarla ve yalnızca herhangi bir üst dizine çıkmadan izin verir. Hassas bir dosyanın dahil edilmesini talep ederek, kötü niyetli bir belge, yetkili bir kullanıcıyı farkında olmadan dosyayı ekranda görüntülemesi için kandırabilir ve dosya içeriğini çevredekiler için ifşa edebilir. mandoc yalnızca so arkasında göründüğü şekliyle yolu gösterir.

.so request failed (roff) Bir so isteğine hizmet vermek harici bir dosyanın okunmasını gerektirir, ancak dosya açılamadı. mandoc yalnızca so arkasında göründüğü şekliyle yolu gösterir.

skipping all arguments (mdoc, man, eqn, roff) Bir mdoc(7) Bt, Ed, Ef, Ek, El, Lp, Pp, Re, Rs veya Ud makrosu, liste öğesi başlıklarını desteklemeyen bir listedeki bir It makrosu, bir man(7) LP, P veya PP makrosu, bir eqn(7) EQ veya EN makrosu ya da bir roff(7) br, fi veya nf isteği ya da ‘..’ blok kapatma isteği en az bir argümanla çağrılıyor. Tüm argümanlar yoksayılır.

skipping excess arguments (mdoc, man, roff) Bir makro veya istek çok fazla argümanla çağrılıyor:

  • Fo, MT, PD, RS, UR, ft veya sp birden fazla argümanla
  • An -split veya -nosplit sonrasında başka bir argümanla
  • RE birden fazla argümanla veya tamsayı olmayan bir argümanla
  • OP veya de ailesinden bir istek ikiden fazla argümanla
  • Dt üçten fazla argümanla
  • TH beşten fazla argümanla
  • Bd, Bk veya Bl geçersiz argümanlarla Fazla argümanlar yoksayılır.

Unsupported features Desteklenmeyen özellikler input too large (mdoc, man) Şu anda mandoc, keyfi boyut sınırı olan 2^31 bayttan (2 Gigabayt) daha büyük girdi dosyalarıyla başa çıkamaz. Yararlı kılavuzlar her zaman küçük olduğundan, bu pratikte bir sorun değildir. Koşul tespit edilir edilmez ayrıştırma iptal edilir.

unsupported control character (roff) Diğer roff(7) uygulamaları tarafından desteklenen ancak mandoc tarafından desteklenmeyen bir ASCII kontrol karakteri bir girdi dosyasında bulundu. Soru işareti ile değiştirilir.

unsupported escape sequence (roff) Bir girdi dosyası, GNU troff veya Heirloom troff tarafından desteklenen ancak mandoc tarafından desteklenmeyen bir kaçış dizisi içeriyor ve bunun bilgi kaybına veya önemli ölçüde yanlış biçimlendirmeye neden olması muhtemeldir.

unsupported roff request (roff) Bir girdi dosyası, GNU troff veya Heirloom troff tarafından desteklenen ancak mandoc tarafından desteklenmeyen bir roff(7) isteği içeriyor ve bunun bilgi kaybına veya önemli ölçüde yanlış biçimlendirmeye neden olması muhtemeldir.

eqn delim option in tbl (eqn, tbl) Bir tablonun seçenekler satırı denklem sınırlayıcılarını tanımlıyor. Tabloda yer alan herhangi bir denklem kaynak kodu biçimlendirilmeden yazdırılacaktır.

unsupported table layout modifier (tbl) Bir tablo düzeni spesifikasyonu bir ‘m’ değiştiricisi içeriyor. Değiştirici atılır.

ignoring macro in table (tbl, mdoc, man) Bir tablo, bir mdoc(7) veya man(7) makrosunun ya da tanımlanmamış bir makronun çağrısını içeriyor. Makro yoksayılır ve argümanları bir metin satırıymış gibi ele alınır.

skipping tbl in -Tman mode (mdoc, tbl) Bir girdi dosyası TS makrosunu içeriyor. Bu mesaj yalnızca tbl(7) girdisinin desteklenmediği -T man çıktı modunda üretilir.

skipping eqn in -Tman mode (mdoc, eqn) Bir girdi dosyası EQ makrosunu içeriyor. Bu mesaj yalnızca eqn(7) girdisinin desteklenmediği -T man çıktı modunda üretilir.

Bad command line arguments Hatalı komut satırı argümanları bad command line argument -IKMmOTW komut satırı seçeneklerinden birini takip eden argüman geçersiz veya komut satırı argümanı olarak verilen bir dosya açılamıyor.

duplicate command line argument -I komut satırı seçeneği iki kez belirtildi.

option has a superfluous value -O seçeneğinin bir argümanı bir değere sahip ancak değer kabul etmiyor.

missing option value -O seçeneğinin bir argümanı hiçbir argümana sahip değil ancak bir argüman gerektiriyor.

bad option value -O indent veya width seçeneğinin bir argümanı geçersiz bir değere sahip.

duplicate option value Aynı -O seçeneği birden fazla kez belirtilmiş. no such tag -O tag seçeneği belirtildi ancak etiket, görüntülenen kılavuz sayfalarının hiçbirinde bulunamadı.

-Tmarkdown unsupported for man(7) input (man) -T markdown seçeneği belirtildi ancak bir girdi dosyası man(7) dilini kullanıyor. Bu girdi dosyası için hiçbir çıktı üretilmez.

Ayrıca Bakınız

apropos(1), man(1), eqn(7), man(7), mandoc_char(7), mdoc(7), roff(7), tbl(7)

Geçmiş

mandoc yardımcı programı ilk olarak OpenBSD 4.8'de yer almıştır. -I seçeneği OpenBSD 5.2'de ve -aCcfhKklMSsw ise OpenBSD 5.7'de yer almıştır.

Yazarlar

mandoc yardımcı programı Kristaps Dzonsons kristaps@bsd.lv tarafından yazılmıştır ve Ingo Schwarze schwarze@openbsd.org tarafından sürdürülmektedir.

macOS 26.4 August 14, 2021 macOS 26.4