A bit more precision and nicer wording in the descriptions

of -Ofragment and -Tman; using input from jmc@ and kristaps@.

1 files changed, 21 insertions, 8 deletions

diff --git a/usr.bin/mandoc/mandoc.1 b/usr.bin/mandoc/mandoc.1
index 914c2a9b7e8..46ea4a8932f 100644
--- a/usr.bin/mandoc/mandoc.1
+++ b/usr.bin/mandoc/mandoc.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: mandoc.1,v 1.49 2011/10/09 17:59:56 schwarze Exp $
+.\"	$OpenBSD: mandoc.1,v 1.50 2011/10/09 21:37:04 schwarze Exp $
 .\"
 .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
 .\"
@@ -260,10 +260,19 @@ The following
 arguments are accepted:
 .Bl -tag -width Ds
 .It Cm fragment
-Do not emit doctype, html, and body elements.
+Omit the
+.Aq !DOCTYPE
+declaration and the
+.Aq html ,
+.Aq head ,
+and
+.Aq body
+elements and only emit the subtree below the
+.Aq body
+element.
 The
 .Cm style
-argument shall be unused.
+argument will be ignored.
 This is useful when embedding manual content within existing documents.
 .It Cm includes Ns = Ns Ar fmt
 The string
@@ -323,14 +332,18 @@ formatters.
 If
 .Xr mdoc 7
 is passed as input, it is translated into
-.Xr man 7 ;
-if the input format is
+.Xr man 7 .
+If the input format is
 .Xr man 7 ,
-it is parsed and re-outputted.
-In either case, the
+the input is copied to the output, expanding any
 .Xr roff 7
 .Sq so
-macros are processed prior to producing output.
+requests.
+The parser is also run, and as usual, the
+.Fl W
+level controls which
+.Sx DIAGNOSTICS
+are displayed before copying the input to the output.
 .Ss PDF Output
 PDF-1.1 output may be generated by
 .Fl T Ns Cm pdf .