=================================================================== RCS file: /cvs/mandoc/mandoc.1,v retrieving revision 1.11 retrieving revision 1.12 diff -u -p -r1.11 -r1.12 --- mandoc/mandoc.1 2009/03/26 16:44:22 1.11 +++ mandoc/mandoc.1 2009/04/02 16:42:35 1.12 @@ -1,4 +1,4 @@ -.\" $Id: mandoc.1,v 1.11 2009/03/26 16:44:22 kristaps Exp $ +.\" $Id: mandoc.1,v 1.12 2009/04/02 16:42:35 kristaps Exp $ .\" .\" Copyright (c) 2009 Kristaps Dzonsons .\" @@ -16,7 +16,7 @@ .\" TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: March 26 2009 $ +.Dd $Mdocdate: April 2 2009 $ .Dt mandoc 1 .Os .\" SECTION @@ -50,7 +50,7 @@ for details. Input format. See .Sx Input Formats for available formats. Defaults to -.Fl m Ns Ar doc . +.Fl m Ns Ar andoc . .\" ITEM .It Fl T Output format. See @@ -89,8 +89,10 @@ By default, .Nm reads .Xr mdoc 7 +or +.Xr man 7 text from stdin, implying -.Fl m Ns Ar mdoc , +.Fl m Ns Ar andoc , and prints 78-column backspace-encoded output to stdout as if .Fl T Ns Ar ascii were provided. @@ -161,6 +163,16 @@ recommended; .Xr man 7 should only be used for legacy manuals. .Pp +A third option, +.Fl m Ns Ar andoc , +which is also the default, determines encoding on-the-fly. If multiple +files are passed in, each has its file-type determined this way. If +multiple files are passed and +.Fl m Ns Ar doc +or +.Fl m Ns Ar an +is specified, then this format is used exclusively. +.Pp The following escape sequences are recognised, although the per-format compiler may not allow certain sequences. .Bl -tag -width Ds -offset XXXX @@ -192,7 +204,7 @@ Parse only: produce no output. Default compiler behaviour may be overriden with the .Fl f flag. -.Bl -tag -width XXXXXXXXXXXX -offset XXXX +.Bl -tag -width XXXXXXXXXXXXXX -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. @@ -200,7 +212,13 @@ scope violations. This can seriously mangle the resul .It Fl f Ns Ar ign-escape Ignore invalid escape sequences. .It Fl f Ns Ar ign-macro -Ignore unknown macros at the start of input lines. +Ignore unknown macros at the start of input lines (default for +.Xr man 7 +parsing). +.It Fl f Ns Ar no-ign-macro +Do not ignore unknown macros at the start of input lines (default for +.Xr mdoc 7 +parsing). .El .\" PARAGRAPH .Pp