From 92eac8539e39eea598feba8192947d35e02cb909 Mon Sep 17 00:00:00 2001 From: Ingo Schwarze Date: Sun, 9 Oct 2011 21:37:06 +0000 Subject: A bit more precision and nicer wording in the descriptions of -Ofragment and -Tman; using input from jmc@ and kristaps@. --- mandoc.1 | 31 ++++++++++++++++++++++--------- 1 file changed, 22 insertions(+), 9 deletions(-) (limited to 'mandoc.1') diff --git a/mandoc.1 b/mandoc.1 index 1ee67923..0dd7c29e 100644 --- a/mandoc.1 +++ b/mandoc.1 @@ -1,4 +1,4 @@ -.\" $Id: mandoc.1,v 1.96 2011/10/06 23:05:55 kristaps Exp $ +.\" $Id: mandoc.1,v 1.97 2011/10/09 21:37:06 schwarze Exp $ .\" .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: October 6 2011 $ +.Dd $Mdocdate: October 9 2011 $ .Dt MANDOC 1 .Os .Sh NAME @@ -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 . -- cgit v1.2.3-56-ge451