ec2f64e018
* the default papersize is now determined from system locale (LC_PAPER) * /etc/papersize is no longer owned by the groff package OBS-URL: https://build.opensuse.org/package/show/M17N/groff?expand=0&rev=25
87 lines
3.4 KiB
Diff
87 lines
3.4 KiB
Diff
From d4f65688290a2362af9a66ecb3ae93beb591fbf9 Mon Sep 17 00:00:00 2001
|
|
From: Michal Vyskocil <mvyskocil@suse.cz>
|
|
Date: Thu, 29 Sep 2011 09:19:01 +0200
|
|
Subject: [PATCH] documentation for the locale keyword
|
|
|
|
---
|
|
doc/groff.texinfo | 28 +++++++++++++++++++++++++++-
|
|
man/groff_font.man | 8 +++++++-
|
|
2 files changed, 34 insertions(+), 2 deletions(-)
|
|
|
|
diff --git a/doc/groff.texinfo b/doc/groff.texinfo
|
|
index 7b09e0f..1cff7b4 100644
|
|
--- a/doc/groff.texinfo
|
|
+++ b/doc/groff.texinfo
|
|
@@ -16530,7 +16530,7 @@ types @code{A0}-@code{A7}, @code{B0}-@code{B7}, @code{C0}-@code{C7},
|
|
significant for @var{string} if it holds predefined paper types.
|
|
Alternatively, @var{string} can be a file name (e.g.@:
|
|
@file{/etc/papersize}); if the file can be opened, @code{groff} reads
|
|
-the first line and tests for the above paper sizes. Finally,
|
|
+the first line and tests for the above paper sizes. Or,
|
|
@var{string} can be a custom paper size in the format
|
|
@code{@var{length},@var{width}} (no spaces before and after the comma).
|
|
Both @var{length} and @var{width} must have a unit appended; valid
|
|
@@ -16540,6 +16540,32 @@ which starts with a digit is always treated as a custom paper format.
|
|
@code{papersize} sets both the vertical and horizontal dimension of the
|
|
output medium.
|
|
|
|
+Finally, @var{string} can be a keyword @code{locale}. In this case groff will
|
|
+determine the default paper size from the country code of @code{LC_PAPER}. For
|
|
+most of combinations (including @code{LC_PAPER=C} or @code{POSIX}) a4 is used.
|
|
+In case of countries listed in Common Language Data Repository 2.0 of Unicode
|
|
+Consorcium - US (@code{US}), Canada (@code{CA}), Belize (@code{BZ}), Chile
|
|
+(@code{CL}), Colombia (@code{CO}), Costa Rica (@code{CR}), El Salvador
|
|
+(@code{SV}), Guatemala (@code{GT}), Panama (@code{PA}), Philippines
|
|
+(@code{PH}), Puerto Rico (@code{PR}), Mexico (@code{MX}), Nicaragua (@code{NI})
|
|
+and the Venezula (@code{VE}) size letter is used. The value of @code{LC_PAPER}
|
|
+is usually derived from @code{LANG} or @code{LC_ALL} and needs to be changed
|
|
+only if your main locale does not match the expected default paper size. Then
|
|
+you need to put the correct LC_PAPER variable into your environment.
|
|
+
|
|
+@example
|
|
+@group
|
|
+# the locale keyword is in devpts
|
|
+shell> grep papersize /usr/share/groff/current/font/devps/DESC
|
|
+papersize locale
|
|
+# default locale is US producing a letter papersize
|
|
+shell> locale | grep LC_PAPER
|
|
+LC_PAPER="en_US.UTF-8"
|
|
+# let's use a4 (German default) in this case
|
|
+shell> LC_PAPER=de_DE.UTF-8 groff -Tps ...
|
|
+@end group
|
|
+@end example
|
|
+
|
|
More than one argument can be specified; @code{groff} scans from left to
|
|
right and uses the first valid paper specification.
|
|
|
|
diff --git a/man/groff_font.man b/man/groff_font.man
|
|
index 64bd212..29a7136 100644
|
|
--- a/man/groff_font.man
|
|
+++ b/man/groff_font.man
|
|
@@ -150,7 +150,7 @@ can be a file name (e.g.\& `/etc/papersize'); if the file can be opened,
|
|
.B groff
|
|
reads the first line and tests for the above paper sizes.
|
|
.
|
|
-Finally,
|
|
+or,
|
|
.I string
|
|
can be a custom paper size in the format
|
|
.IB length , width
|
|
@@ -172,7 +172,13 @@ format.
|
|
.B papersize
|
|
sets both the vertical and horizontal dimension of the output medium.
|
|
.
|
|
+Finally
|
|
+.I string
|
|
+can be a keyword locale, so
|
|
+.B groff
|
|
+will determine the papersize from system locale (LC_PAPER).
|
|
.IP
|
|
+.
|
|
More than one argument can be specified;
|
|
.B groff
|
|
scans from left to right and uses the first valid paper specification.
|
|
--
|
|
1.7.6.3
|
|
|