diff options
| author |   Kristaps Dzonsons <kristaps@bsd.lv> | 2009-03-08 18:02:36 +0000 |
|---|---|---|
| committer | Kristaps Dzonsons <kristaps@bsd.lv> | 2009-03-08 18:02:36 +0000 |
| commit | 3c63611ee89298b92b89ee5a72e03ddf82e2059f (patch) | |
| tree | fb23a285271560c4502791d265d2916405469a89 /mdoctree.1 | |
| parent | f4174d477ac34e47067d4a9e45cc192f7271973a (diff) | |
| download | mandoc-3c63611ee89298b92b89ee5a72e03ddf82e2059f.tar.gz mandoc-3c63611ee89298b92b89ee5a72e03ddf82e2059f.tar.zst mandoc-3c63611ee89298b92b89ee5a72e03ddf82e2059f.zip | |
Updated manuals.
Added -fign-scope and -fign-escape.
Diffstat (limited to 'mdoctree.1')
| -rw-r--r-- | mdoctree.1 | 47 |
1 files changed, 34 insertions, 13 deletions
@@ -1,4 +1,4 @@ -.\" $Id: mdoctree.1,v 1.4 2009/02/23 13:05:06 kristaps Exp $ +.\" $Id: mdoctree.1,v 1.5 2009/03/08 18:02:36 kristaps Exp $ .\" .\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se> .\" @@ -16,7 +16,7 @@ .\" TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: February 23 2009 $ +.Dd $Mdocdate: March 8 2009 $ .Dt mdoctree 1 .Os .\" SECTION @@ -26,7 +26,8 @@ .\" SECTION .Sh SYNOPSIS .Nm mdoctree -.Op Fl v +.Op Fl vV +.Op Fl f Ns Ar options... .Op Fl W Ns Ar err... .Op Ar infile .\" SECTION @@ -39,11 +40,19 @@ manual pages and prints its syntax tree. It's commonly used to see the syntax tree of a document when building new .Xr mdoc 3 utilities. The arguments are as follows: -.Bl -tag -width "\-Werr... " +.Bl -tag -width XXXXXXXXXXXX .\" ITEM .It Fl v Print verbose parsing output. .\" ITEM +.It Fl V +Print version and exit. +.\" ITEM +.It Fl f Ns Ar option... +Override default compiler behaviour. See +.Sx Compiler Options +for details. +.\" ITEM .It Fl W Ns Ar err... Print warning messages. May be set to .Fl W Ns Ar all @@ -78,20 +87,32 @@ input, documented at .Xr mdoc 7 and .Xr mdoc.samples 7 , -into an abstract syntax tree. -.\" PARAGRAPH -.Pp -By default, -.Nm -reads from stdin and prints the syntax tree to stdout. +into an abstract syntax tree. By default, it reads from stdin and +prints the syntax tree to stdout. .\" PARAGRAPH .Pp .Ex -std mdoctree +.\" SUB-SECTION +.Ss Compiler Options +Default compiler behaviour may be overriden with the +.Fl f +flag. The available options are as follows: +.Bl -tag -width XXXXXXXXXXXX -offset XXXX +.It Fl f Ns Ar ign-scope +When rewinding the scope of a block macro, forces the compiler to ignore +scope violations. This can seriously mangle the resulting tree. +.It Fl f Ns Ar ign-escape +Ignore invalid escape sequences. +.El .\" PARAGRAPH .Pp -.Nm -is -.Ud +As with the +.Fl W +flag, multiple +.Fl f +options may be grouped and delimited with a comma. Using +.Fl f Ns Ar ign-scope,ign-escape , +for example, will try to ignore scope and character-escape errors. .\" SECTION .Sh EXAMPLES To validate this manual page: |