]> git.cameronkatri.com Git - mandoc.git/blobdiff - mandoc.1
"Groff allows the initial macro on a line to be delimited by a space of
[mandoc.git] / mandoc.1
index c0577d56e1c0023f7c6f55d5a39d5bf21d5cfe08..187d7d40f3c61abf112c18a04bdabae891d14c5e 100644 (file)
--- a/mandoc.1
+++ b/mandoc.1
@@ -1,6 +1,6 @@
-.\"    $Id: mandoc.1,v 1.67 2010/06/30 20:57:41 kristaps Exp $
+.\"    $Id: mandoc.1,v 1.74 2010/08/07 17:46:39 kristaps Exp $
 .\"
 .\"
-.\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@bsd.lv>
+.\" Copyright (c) 2009, 2010 Kristaps Dzonsons <kristaps@bsd.lv>
 .\"
 .\" Permission to use, copy, modify, and distribute this software for any
 .\" purpose with or without fee is hereby granted, provided that the above
 .\"
 .\" Permission to use, copy, modify, and distribute this software for any
 .\" purpose with or without fee is hereby granted, provided that the above
@@ -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.
 .\"
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: June 30 2010 $
+.Dd $Mdocdate: August 7 2010 $
 .Dt MANDOC 1
 .Os
 .Sh NAME
 .Dt MANDOC 1
 .Os
 .Sh NAME
@@ -192,6 +192,10 @@ Implies
 .Fl W Ns Cm all
 and
 .Fl f Ns Cm strict .
 .Fl W Ns Cm all
 and
 .Fl f Ns Cm strict .
+.It Fl T Ns Cm pdf
+Produce PDF output.
+See
+.Sx PDF Output .
 .It Fl T Ns Cm ps
 Produce PostScript output.
 See
 .It Fl T Ns Cm ps
 Produce PostScript output.
 See
@@ -303,7 +307,9 @@ PostScript
 Level-2 pages may be generated by
 .Fl T Ns Cm ps .
 Output pages default to letter sized and are rendered in the Times font
 Level-2 pages may be generated by
 .Fl T Ns Cm ps .
 Output pages default to letter sized and are rendered in the Times font
-family.
+family, 11-point.
+Margins are calculated as 1/9 the page length and width.
+Line-height is 1.4m.
 .Pp
 Special characters are rendered as in
 .Sx ASCII Output .
 .Pp
 Special characters are rendered as in
 .Sx ASCII Output .
@@ -316,10 +322,27 @@ arguments are accepted:
 The paper size
 .Ar name
 may be one of
 The paper size
 .Ar name
 may be one of
-.Ar a4
+.Ar a3 ,
+.Ar a4 ,
+.Ar a5 ,
+.Ar legal ,
 or
 .Ar letter .
 or
 .Ar letter .
+You may also manually specify dimensions as
+.Ar NNxNN ,
+width by height in millimetres.
+If an unknown value is encountered,
+.Ar letter
+is used.
 .El
 .El
+.Ss PDF Output
+PDF-1.1 output may be generated by
+.Fl T Ns Cm pdf .
+See
+.Sx PostScript Output
+for
+.Fl O
+arguments and defaults.
 .Ss XHTML Output
 Output produced by
 .Fl T Ns Cm xhtml
 .Ss XHTML Output
 Output produced by
 .Fl T Ns Cm xhtml
@@ -358,11 +381,6 @@ Each input and output format is separately noted.
 .Bl -bullet -compact
 .It
 The
 .Bl -bullet -compact
 .It
 The
-.Sq \e~
-special character doesn't produce expected behaviour in
-.Fl T Ns Cm ascii .
-.It
-The
 .Sq \&Bd \-literal
 and
 .Sq \&Bd \-unfilled
 .Sq \&Bd \-literal
 and
 .Sq \&Bd \-unfilled
@@ -400,11 +418,6 @@ has no effect.
 .It
 Words aren't hyphenated.
 .It
 .It
 Words aren't hyphenated.
 .It
-In normal mode (not a literal block), blocks of spaces aren't preserved,
-so double spaces following sentence closure are reduced to a single space;
-.Xr groff 1
-retains spaces.
-.It
 Sentences are unilaterally monospaced.
 .El
 .Ss HTML/XHTML Compatibility
 Sentences are unilaterally monospaced.
 .El
 .Ss HTML/XHTML Compatibility