summaryrefslogtreecommitdiff
path: root/doc/groff.texinfo
diff options
context:
space:
mode:
Diffstat (limited to 'doc/groff.texinfo')
-rw-r--r--doc/groff.texinfo50
1 files changed, 46 insertions, 4 deletions
diff --git a/doc/groff.texinfo b/doc/groff.texinfo
index 5595fa82a..037646ec1 100644
--- a/doc/groff.texinfo
+++ b/doc/groff.texinfo
@@ -805,6 +805,7 @@ Similarly, we say @samp{gpic}, @samp{geqn}, etc.
* Environment::
* Macro Directories::
* Font Directories::
+* Paper Size::
* Invocation Examples::
@end menu
@@ -1292,7 +1293,7 @@ directories during the installation process.
@c =====================================================================
-@node Font Directories, Invocation Examples, Macro Directories, Invoking groff
+@node Font Directories, Paper Size, Macro Directories, Invoking groff
@section Font Directories
@cindex font directories
@cindex directories for fonts
@@ -1350,7 +1351,49 @@ directories during the installation process.
@c =====================================================================
-@node Invocation Examples, , Font Directories, Invoking groff
+@node Paper Size, Invocation Examples, Font Directories, Invoking groff
+@section Paper Size
+@cindex paper size
+@cindex size, paper
+@cindex landscape page orientation
+@cindex orientation, landscape
+@cindex page orientation, landscape
+
+In groff, the page size for @code{gtroff} and for output devices are
+handled separately. @xref{Page Layout}, for vertical manipulation of
+the page size. @xref{Line Layout}, for horizontal changes.
+
+A default paper size can be set in the device's @file{DESC} file. Most
+output devices also have a command line option @option{-p} to override
+the default paper size and option @option{-l} to use landscape
+orientation. @xref{DESC File Format}, for a description of the
+@code{papersize} keyword which takes the same argument as @option{-p}.
+
+@pindex papersize.tmac
+@pindex troffrc
+A convenient shorthand to set a particular paper size for @code{gtroff}
+is command line option @option{-dpaper=@var{size}}. This defines string
+@code{paper} which is processed in file @file{papersize.tmac} (loaded in
+the start-up file @file{troffrc} by default). Possible values for
+@var{size} are the same as the predefined values for the
+@code{papersize} keyword (but only in lowercase) except
+@code{a7}-@code{d7}. An appended @samp{l} (ell) character denotes
+landscape orientation.
+
+For example, use the following for PS output on A4 paper in landscape
+orientation:
+
+@Example
+groff -Tps -dpaper=a4l -P-pa4 -P-l -ms foo.ms > foo.ps
+@endExample
+
+Note that it is up to the particular macro package to respect default
+page dimensions set in this way (most do).
+
+
+@c =====================================================================
+
+@node Invocation Examples, , Paper Size, Invoking groff
@section Invocation Examples
@cindex invocation examples
@cindex examples of invocation
@@ -2010,8 +2053,7 @@ line) and 6.5@tie{}inch otherwise.
@item -rLT=@var{length}
Set title length to @var{length}. If not specified, the title length
-defaults to 78@tie{}en in nroff mode (this is 78@tie{}characters per
-line) and 6.5@tie{}inch otherwise.
+defaults to the line length.
@item -rP@var{nnn}
Page numbering starts with @var{nnn} rather than with@tie{}1.