Documented -mandoc behaviour.

2 files changed, 25 insertions, 9 deletions

diff --git a/main.c b/main.c
index e6275b3c..6f36aa9c 100644
--- a/main.c
+++ b/main.c
@@ -1,4 +1,4 @@
-/* $Id: main.c,v 1.20 2009/04/02 16:37:40 kristaps Exp $ */
+/* $Id: main.c,v 1.21 2009/04/02 16:42:35 kristaps Exp $ */
 /*
  * Copyright (c) 2008, 2009 Kristaps Dzonsons <kristaps@openbsd.org>
  *
@@ -268,8 +268,6 @@ man_init(struct curparse *curp)
 	/* Set command defaults. */
 	pflags = MAN_IGN_MACRO;
 
-	if (curp->fflags & IGN_MACRO)
-		pflags |= MAN_IGN_MACRO;
 	if (curp->fflags & NO_IGN_MACRO)
 		pflags &= ~MAN_IGN_MACRO;
 
diff --git a/mandoc.1 b/mandoc.1
index 27c663fc..474a4cf0 100644
--- a/mandoc.1
+++ b/mandoc.1
@@ -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 <kristaps@openbsd.org>
 .\"
@@ -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 resulting tree.
 .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