summaryrefslogtreecommitdiffstats
path: root/doc/groff.html.node/Paper-Format.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/groff.html.node/Paper-Format.html')
-rw-r--r--doc/groff.html.node/Paper-Format.html101
1 files changed, 101 insertions, 0 deletions
diff --git a/doc/groff.html.node/Paper-Format.html b/doc/groff.html.node/Paper-Format.html
new file mode 100644
index 0000000..f6f9e72
--- /dev/null
+++ b/doc/groff.html.node/Paper-Format.html
@@ -0,0 +1,101 @@
+<!DOCTYPE html>
+<html>
+<!-- Created by GNU Texinfo 7.0.3, https://www.gnu.org/software/texinfo/ -->
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+<!-- This manual documents GNU troff version 1.23.0.
+
+Copyright © 1994-2023 Free Software Foundation, Inc.
+
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.3 or
+any later version published by the Free Software Foundation; with no
+Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
+copy of the license is included in the section entitled "GNU Free
+Documentation License". -->
+<title>Paper Format (The GNU Troff Manual)</title>
+
+<meta name="description" content="Paper Format (The GNU Troff Manual)">
+<meta name="keywords" content="Paper Format (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Invoking-groff.html" rel="up" title="Invoking groff">
+<link href="Invocation-Examples.html" rel="next" title="Invocation Examples">
+<link href="Font-Directories.html" rel="prev" title="Font Directories">
+<style type="text/css">
+<!--
+div.example {margin-left: 3.2em}
+span.r {font-family: initial; font-weight: normal; font-style: normal}
+-->
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Paper-Format">
+<div class="nav-panel">
+<p>
+Next: <a href="Invocation-Examples.html" accesskey="n" rel="next">Invocation Examples</a>, Previous: <a href="Font-Directories.html" accesskey="p" rel="prev">Font Directories</a>, Up: <a href="Invoking-groff.html" accesskey="u" rel="up">Invoking <code class="code">groff</code></a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Request-Index.html" title="Index" rel="index">Index</a>]</p>
+</div>
+<hr>
+<h3 class="section" id="Paper-Format-1">2.5 Paper Format</h3>
+<a class="index-entry-id" id="index-paper-format"></a>
+<a class="index-entry-id" id="index-format_002c-paper"></a>
+<a class="index-entry-id" id="index-paper-size"></a>
+<a class="index-entry-id" id="index-size_002c-paper"></a>
+<a class="index-entry-id" id="index-landscape-page-orientation"></a>
+<a class="index-entry-id" id="index-orientation_002c-landscape"></a>
+<a class="index-entry-id" id="index-page-orientation_002c-landscape"></a>
+
+<p>In <code class="code">groff</code>, the page dimensions for the formatter GNU <code class="code">troff</code>
+and for output devices are handled separately. See <a class="xref" href="Page-Layout.html">Page Layout</a>, for
+vertical manipulation of the page size, and See <a class="xref" href="Line-Layout.html">Line Layout</a>, for
+horizontal changes.
+<a class="index-entry-id" id="index-papersize_002etmac"></a>
+<a class="index-entry-id" id="index-troffrc-1"></a>
+The <samp class="file">papersize</samp> macro package, normally loaded by <samp class="file">troffrc</samp> at
+startup, provides an interface for configuring page dimensions by
+convenient names, like &lsquo;<samp class="samp">letter</samp>&rsquo; or &lsquo;<samp class="samp">a4</samp>&rsquo;; see
+<cite class="cite">groff_tmac<span class="r">(5)</span></cite>. The default used by the formatter depends on
+its build configuration, but is usually one of the foregoing, as
+geographically appropriate.
+</p>
+<p>It is up to each macro package to respect the page dimensions configured
+in this way.
+</p>
+<p>For each output device, the size of the output medium can be set in its
+<samp class="file">DESC</samp> file. Most output drivers also recognize a command-line
+option <samp class="option">-p</samp> to override the default dimensions and an option
+<samp class="option">-l</samp> to use landscape orientation. See <a class="xref" href="DESC-File-Format.html"><samp class="file">DESC</samp> File Format</a>, for
+a description of the <code class="code">papersize</code> keyword, which takes an argument
+of the same form as <samp class="option">-p</samp>. The output driver&rsquo;s man page, such as
+<cite class="cite">grops<span class="r">(1)</span></cite>, may also be helpful.
+</p>
+<p><code class="code">groff</code> uses the command-line option <samp class="option">-P</samp> to pass options to
+postprocessors; for example, use the following for PostScript output on
+A4 paper in landscape orientation.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff -Tps -dpaper=a4l -P-pa4 -P-l -ms foo.ms &gt; foo.ps
+</pre></div></div>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Invocation-Examples.html">Invocation Examples</a>, Previous: <a href="Font-Directories.html">Font Directories</a>, Up: <a href="Invoking-groff.html">Invoking <code class="code">groff</code></a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Request-Index.html" title="Index" rel="index">Index</a>]</p>
+</div>
+
+
+
+</body>
+</html>