diff options
| author |   Kristaps Dzonsons <kristaps@bsd.lv> | 2008-11-28 11:21:12 +0000 |
|---|---|---|
| committer | Kristaps Dzonsons <kristaps@bsd.lv> | 2008-11-28 11:21:12 +0000 |
| commit | 150a3223f299b39b75bd39a9f1dea3ee0193bb63 (patch) | |
| tree | 4613c9846fd01dad1a8d1e6e9648108926021d46 /mdocml.1 | |
| parent | 32bc4a1e0a8ab255cd10e101dc9778b0c143f2f8 (diff) | |
| download | mandoc-150a3223f299b39b75bd39a9f1dea3ee0193bb63.tar.gz mandoc-150a3223f299b39b75bd39a9f1dea3ee0193bb63.tar.zst mandoc-150a3223f299b39b75bd39a9f1dea3ee0193bb63.zip | |
Initial pushing to mbuf.
Diffstat (limited to 'mdocml.1')
| -rw-r--r-- | mdocml.1 | 46 |
1 files changed, 35 insertions, 11 deletions
@@ -3,26 +3,32 @@ .\" The following requests are required for all man pages. .\" .\" Remove `\&' from the line below. -.Dd $Mdocdate: November 27 2008 $ +.Dd $Mdocdate: November 28 2008 $ .Dt mdocml 1 .Os .\" -.Op foo .Sh NAME .Nm mdocml .Nd compile manpage source into mark-up language .\" .Sh SYNOPSIS .Nm mdocml -.Op Fl W +.Op Fl vW +.Op Fl f Ar filter .Op Fl o Ar outfile .Op Ar infile .\" .Sh DESCRIPTION The .Nm -utility compiles manpage source into a mark-up language. Its arguments -are as follows: +utility parses +.Xr mdoc +formatted manual source and passes results into the output filter +dictated by +.Fl f Ar filter . +The only current output filter is +.Ar validate , +the default. The arguments are as follows: .Bl -tag -width "\-o outfile" .It Fl o Ar outfile Place output in @@ -36,9 +42,17 @@ Read input from which may be .Qq \- for standard input. The default is standard input. +.It Fl v +Print messages (output depends on filter). .It Fl W -Print warnings. +Print warnings (output depends on filter). .El +.Ss Validate Filter +The validate filter, specified by +.Fl f Ar validate , +is the default filter. It produces no output, so specifying +.Fl o Ar outfile +results in an empty file. .\" The following requests should be uncommented and used where appropriate. .\" This next request is for sections 2, 3, and 9 function return values only. .\" .Sh RETURN VALUES @@ -63,14 +77,24 @@ utility was written by .An Kristaps Dzonsons Aq kristaps@kth.se . .\" .Sh CAVEATS -The +Most caveats of .Nm -engine doesn't understand +stem from ambiguities in +.Xr mdoc 7 +or the necessary limitations of converting an ad hoc language into +structured ones: +.Bl -enum -compact -offset indent +.It +The engine doesn't understand .Sq \&Xo and .Sq \&Xc troff macros. -.Pp -.Em All -macro arguments may be quoted, instead of only some. +.It +All macro arguments may be quoted, instead of only some. +.It +Blank lines raise warnings. +.It +Non-ascii characters may cause issues. +.El .\" .Sh BUGS |