Changeset 913b88f

Timestamp:

03/11/2023 04:05:54 AM (14 months ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

12.0, 12.1, kea, ken/TL2024, ken/tuningfonts, lazarus, lxqt, plabs/newcss, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/llvm18, xry111/xf86-video-removal

Children:

278f297

Parents:

2fa5250

Message:

libpaper: Update the configuration info for libpaper2 (again)

/etc/papersize is essentially useless now. It only provides the
fallback value if the locale does not suggest a paper size. And with
Glibc-2.37 even the "C" locale suggests A4.

See ​https://github.com/rrthomas/libpaper/issues/40.

File:

• general/genlib/libpaper.xml (modified) (1 diff)

general/genlib/libpaper.xml

@@ -120 +120 @@
 
       <para>
-        Create <filename>/etc/papersize</filename> to set the default
-        system paper size.  Issue the following command as the
-        &root; user to set this to 'a4'. You may wish 
-        to use a different size, such as letter.
+        The paper size is automatically determined from the system locale;
+        see <literal>LC_PAPER</literal> in <filename>locale(7)</filename>.
+        If you want to override it, create a <filename>papersize</filename>
+        file in the user configuration directory.  For example:
       </para>
 
-<screen role="root"><userinput>echo "a4" &gt; /etc/papersize</userinput></screen>
+<screen role="nudump"><userinput>mkdir -pv ~/.config &amp;&amp;
+echo "a4" &gt; ~/.config/papersize</userinput></screen>
+
+      <para>
+        If you want to override the paper size globally (for all users),
+        set up the <envar>PAPERSIZE</envar> environment variable.  For
+        example:
+      </para>
+
+<screen role="nodump"><userinput>echo "PAPERSIZE=a4" &gt; /etc/profile.d/libpaper.sh</userinput></screen>
+
+      <para>
+        You may use a different paper size, such as
+        <quote><literal>letter</literal></quote>.
+      </para>
 
     </sect3>