version 1.100, 2011/12/25 19:35:44 |
version 1.105, 2014/06/23 22:03:30 |
|
|
.\" $Id$ |
.\" $Id$ |
.\" |
.\" |
.\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv> |
.\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv> |
|
.\" Copyright (c) 2012, 2014 Ingo Schwarze <schwarze@openbsd.org> |
.\" |
.\" |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" Permission to use, copy, modify, and distribute this software for any |
.\" purpose with or without fee is hereby granted, provided that the above |
.\" purpose with or without fee is hereby granted, provided that the above |
|
|
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm mandoc |
.Nm mandoc |
.Op Fl V |
.Op Fl V |
|
.Sm off |
|
.Op Fl I Cm os Li = Ar name |
|
.Sm on |
.Op Fl m Ns Ar format |
.Op Fl m Ns Ar format |
.Op Fl O Ns Ar option |
.Op Fl O Ns Ar option |
.Op Fl T Ns Ar output |
.Op Fl T Ns Ar output |
|
|
.Pp |
.Pp |
The arguments are as follows: |
The arguments are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
|
.Sm off |
|
.It Fl I Cm os Li = Ar name |
|
.Sm on |
|
Override the default operating system |
|
.Ar name |
|
for the |
|
.Xr mdoc 7 |
|
.Sq \&Os |
|
macro. |
.It Fl m Ns Ar format |
.It Fl m Ns Ar format |
Input format. |
Input format. |
See |
See |
Line 334 for font style specification and available command-lin |
|
Line 347 for font style specification and available command-lin |
|
Translate input format into |
Translate input format into |
.Xr man 7 |
.Xr man 7 |
output format. |
output format. |
This is useful for distributing manual sources to legancy systems |
This is useful for distributing manual sources to legacy systems |
lacking |
lacking |
.Xr mdoc 7 |
.Xr mdoc 7 |
formatters. |
formatters. |
|
|
.Sh DIAGNOSTICS |
.Sh DIAGNOSTICS |
Standard error messages reporting parsing errors are prefixed by |
Standard error messages reporting parsing errors are prefixed by |
.Pp |
.Pp |
.Sm off |
.D1 Nm Ns : Ar file : Ns Ar line : Ns Ar column : level : |
.D1 Ar file : line : column : \ level : |
|
.Sm on |
|
.Pp |
.Pp |
where the fields have the following meanings: |
where the fields have the following meanings: |
.Bl -tag -width "column" |
.Bl -tag -width "column" |
Line 505 points to the first character of the word. |
|
Line 516 points to the first character of the word. |
|
The message level, printed in capital letters. |
The message level, printed in capital letters. |
.El |
.El |
.Pp |
.Pp |
|
The |
|
.Ar line |
|
and |
|
.Ar column |
|
fields are omitted when meaningless. |
|
.Pp |
Message levels have the following meanings: |
Message levels have the following meanings: |
.Bl -tag -width "warning" |
.Bl -tag -width "warning" |
|
.It Cm syserr |
|
Opening or reading an input file failed, so the parser cannot |
|
even be started and no output is produced from that input file. |
.It Cm fatal |
.It Cm fatal |
The parser is unable to parse a given input file at all. |
The parser is unable to parse a given input file at all. |
No formatted output is produced from that input file. |
No formatted output is produced from that input file. |
|
|
The |
The |
.Nm |
.Nm |
utility may also print messages related to invalid command line arguments |
utility may also print messages related to invalid command line arguments |
or operating system errors, for example when memory is exhausted or |
or operating system errors, for example when memory is exhausted. |
input files cannot be read. |
Such messages may not carry the prefix described above. |
Such messages do not carry the prefix described above. |
|
.Sh COMPATIBILITY |
.Sh COMPATIBILITY |
This section summarises |
This section summarises |
.Nm |
.Nm |
Line 637 lists render similarly. |
|
Line 656 lists render similarly. |
|
The |
The |
.Nm |
.Nm |
utility was written by |
utility was written by |
.An Kristaps Dzonsons , |
.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv . |
.Mt kristaps@bsd.lv . |
|
.Sh CAVEATS |
.Sh CAVEATS |
In |
In |
.Fl T Ns Cm html |
.Fl T Ns Cm html |