summaryrefslogtreecommitdiffstats
path: root/mdocml.1
blob: 2bae03d20b69d8a60aa58f4ece8d50e942055a08 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
.\"
.Dd $Mdocdate$
.Dt mdocml 1
.Os
.\" SECTION
.Sh NAME
.Nm mdocml
.Nd mdoc macro compiler
.\" SECTION
.Sh SYNOPSIS
.Nm mdocml
.Op Fl f Ns Ar filter
.Op Fl v
.Op Fl W Ns Ar err...
.Op Ar infile
.\" SECTION
.Sh DESCRIPTION
The
.Nm
utility interfaces the
.Xr mdoc 3
library to scan, parse, validate and output mdoc-macro documents.
Arguments follow:
.Bl -tag -width "\-Werr... "
.\" ITEM
.It Fl f Ns Ar filter
Pipe the parsed syntax tree into an output filter.  May be either
.Ar tree
for the parse tree or
.Ar term
for a terminal-encoded, formatted manual page.
.\" ITEM
.It Fl v
Print verbose parsing output.
.\" ITEM
.It Fl W Ns Ar err...
Print warning messages.  May be set to 
.Fl W Ns Ar all
for all warnings, 
.Ar compat
for groff/troff-compatibility warnings, or
.Ar syntax
for syntax warnings.  If
.Fl W Ns Ar error 
is specified, warnings are considered errors and cause utility
termination.  Multiple 
.Fl W
arguments may be comma-separated, such as
.Fl W Ns Ar error,all .
.\" ITEM
.It Ar infile
Read input from
.Ar infile ,
which may be 
.Dq \-
for stdin.
.El
.\" PARAGRAPH
.Pp
Parsing and validation rules are drawn entirely from the 
.Xr mdoc 7
and
.Xr mdoc.samples 7 
manuals.
.\" PARAGRAPH
.Pp
By default,
.Nm
reads from stdin and only validates its input.
.\" PARAGRAPH
.Pp
.Ex -std mdocml
.\" PARAGRAPH
.Pp
.Nm
is
.Ud
.\" SECTION
.Sh EXAMPLES
To validate this manual page:
.\" PARAGRAPH
.Pp
.D1 % mdocml \-Wall,error mdocml.1 
.\" SECTION
.Sh SEE ALSO
.Xr groff 1 ,
.Xr mdoc.samples 7 ,
.Xr mdoc 7 ,
.Xr mdoc 3
.\" 
.Sh AUTHORS
The
.Nm
utility was written by 
.An Kristaps Dzonsons Aq kristaps@kth.se .
.\" SECTION
.Sh CAVEATS
See
.Xr mdoc 3
for a list of bugs, caveats, and incomplete macros.