mandoc/mandoc.1 - diff

Return to mandoc.1 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mandoc.1 between version 1.237 and 1.244

version 1.237, 2019/02/23 18:53:54

version 1.244, 2020/06/15 18:05:18

Line 1

.\" $Id$

.\" $OpenBSD$

.\"

.\" Permission to use, copy, modify, and distribute this software for any

.\" purpose with or without fee is hereby granted, provided that the above

Line 222 reads from standard input.

.Pp

The options

.Fl fhklw

are also supported and are documented in man(1).

are also supported and are documented in

.Xr man 1 .

.Fl f

and

Line 409 The file

Line 410 The file

is used for an external style-sheet.

This must be a valid absolute or

relative URI.

.It Cm tag Ns Op = Ns Ar term

Same syntax and semantics as for

.Sx ASCII Output .

This is implemented by passing a

.Ic 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

.Bd -literal -offset 3n

MANPAGER='lynx -force_html' man -T html -O tag=MANPAGER man

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

.Ed

.Pp

This argument does not work with

.Xr more 1

.Xr less 1 .

.It Cm toc

If an input file contains at least two non-standard sections,

print a table of contents near the beginning of the output.

Line 442 This is useful for distributing manual sources to lega

Line 460 This is useful for distributing manual sources to lega

lacking

.Xr mdoc 7

formatters.

Embedded

.Xr eqn 7

and

.Xr tbl 7

code is not supported.

.Pp

If the input format of a file is

.Xr man 7 ,

Line 697 No input files have been read.

Line 720 No input files have been read.

.It 6

An operating system error occurred, for example exhaustion

of memory, file descriptors, or process table entries.

Such errors cause

Such errors may cause

.Nm

to exit at once, possibly in the middle of parsing or formatting a file.

.El

Line 777 fields.

Line 800 fields.

.Pp

Message levels have the following meanings:

.Bl -tag -width "warning"

.It Cm 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.

.It Cm badarg

Invalid command line arguments were specified.

No input files have been read and no output is produced.

.It Cm unsupp

An input file uses unsupported low-level

.Xr roff 7

Line 825 Messages of the

Line 855 Messages of the

.Cm error ,

and

.Cm unsupp

levels except those about non-existent or unreadable input files

levels are hidden unless their level, or a lower level, is requested using a

are hidden unless their level, or a lower level, is requested using a

.Fl W

option or

.Fl T Cm lint

Line 1066 macro lacks the mandatory section argument.

Line 1095 macro lacks the mandatory section argument.

The section number in a

.Ic \&Dt

line is invalid, but still used.

.It Sy "missing date, using today's date"

.It Sy "filename/section mismatch"

.Pq 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

.Ic \&Dt

.Ic \&TH

macro contains a

.Ar section

argument that starts with a different non-zero digit.

The

.Ar section

argument is used as provided anyway.

Consider checking whether the file name or the argument need a correction.

.It Sy "missing date, using \(dq\(dq"

.Pq mdoc, man

The document was parsed as

.Xr mdoc 7

Line 1699 The meaning of blank input lines is only well-defined

Line 1742 The meaning of blank input lines is only well-defined

In fill mode, line breaks of text input lines are not supposed to be

significant.

However, for compatibility with groff, blank lines in fill mode

are replaced with

are formatted like

.Ic \&sp

requests.

To request a paragraph break, use

.Ic \&Pp

instead of a blank line.

.It Sy "tab in filled text"

.Pq mdoc , man

The meaning of tab characters is only well-defined in non-fill mode:

Line 2237 or

Line 2283 or

macro or of an undefined macro.

The macro is ignored, and its arguments are handled

as if they were a text line.

.El

.Ss Bad command line arguments

.Bl -ohang

.It Sy "bad command line argument"

The argument following one of the

.Fl IKMmOTW

command line options is invalid, or a

.Ar file

given as a command line argument cannot be opened.

.It Sy "duplicate command line argument"

The

.Fl I

command line option was specified twice.

.It Sy "option has a superfluous value"

An argument to the

.Fl O

option has a value but does not accept one.

.It Sy "missing option value"

An argument to the

.Fl O

option has no argument but requires one.

.It Sy "bad option value"

An argument to the

.Fl O

.Cm indent

.Cm width

option has an invalid value.

.It Sy "duplicate option value"

The same

.Fl O

option is specified more than once.

.It Sy "no such tag"

The

.Fl O Cm tag

option was specified but the tag was not found in any of the displayed

manual pages.

.El

.Sh SEE ALSO

.Xr apropos 1 ,

CVSweb