Changeset fedbe2f

Timestamp:

01/27/2024 11:50:40 AM (4 months ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

12.1, ken/TL2024, lazarus, rahul/power-profiles-daemon, trunk, xry111/llvm18

Children:

23b54336

Parents:

eaf3d74b

Message:

treewide: Use <ulink> instead of <filename> for referring man pages

Sync with LFS.

Note that in BLFS many man pages are even not referred via <filename>
and these references need to be found and fixed manually.

Files:

• general.ent (modified) (1 diff)
• general/genlib/libpaper.xml (modified) (1 diff)
• general/sysutils/acpid.xml (modified) (2 diffs)
• general/sysutils/pm-utils.xml (modified) (1 diff)
• introduction/important/building-notes.xml (modified) (1 diff)
• postlfs/shells/tcsh.xml (modified) (1 diff)
• postlfs/shells/zsh.xml (modified) (1 diff)
• x/installing/xorg-config.xml (modified) (1 diff)
• x/lib/xdg-desktop-portal.xml (modified) (2 diffs)

general.ent

@@ -104 +104 @@
 <!ENTITY w3m-url              "http://w3m.sourceforge.net/">
 <!ENTITY sysprof-url          "https://wiki.gnome.org/Apps/Sysprof">
+<!ENTITY man                  "https://man.archlinux.org/man/">
 
 <!-- Convenience entities -->

general/genlib/libpaper.xml

@@ -117 +117 @@
       <para>
         The paper size is automatically determined from the system locale;
-        see <literal>LC_PAPER</literal> in <filename>locale(7)</filename>.
+        see <literal>LC_PAPER</literal> in <ulink role='man'
+        url='&man;locale.7'>locale(7)</ulink>.
         If you want to override it, create a <filename>papersize</filename>
         file in the user configuration directory.  For example:

general/sysutils/acpid.xml

@@ -40 +40 @@
         may conflict with this package.  For example, &logind;
         (read the documentation for <option>Handle*=</option> in
-        <filename>logind.conf(5)</filename> for details) and
+        <ulink role='man' url='&man;logind.conf.5'>logind.conf(5)</ulink>
+        for details) and
         <xref linkend='upower'/> (used by many desktop environments such as
         GNOME, KDE, and XFCE for handling ACPI events).  If you've installed
@@ -49 +50 @@
         by default, so the handling of these events by &logind; should be
         disabled first if handling these events with acpid
-        (again, read <filename>logind.conf(5)</filename> for details).
+        (again, read <ulink role='man'
+        url='&man;logind.conf.5'>logind.conf(5)</ulink> for details).
       </para>
     </note>

general/sysutils/pm-utils.xml

@@ -40 +40 @@
         documentation for <filename>suspend.target</filename> and
         <filename>hibernate.target</filename> in the man page
-        <filename>systemd.special(7)</filename> for more details.
+        <ulink role='man'
+        url='&man;systemd.special.7'>systemd.special(7)</ulink> for more
+        details.
       </para>
     </note>

introduction/important/building-notes.xml

@@ -438 +438 @@
 
     <para revision="systemd">
-      Read the man pages <filename>systemd-run(1)</filename> and
-      <filename>systemd.resource-control(5)</filename> for the detailed
-      explanation of parameters in the command.
+      Read the man pages <ulink role='man'
+      url='&man;systemd-run.1'>systemd-run(1)</ulink> and
+      <ulink role='man'
+  url='&man;systemd.resource-control.5'>systemd.resource-control(5)</ulink>
+      for the detailed explanation of parameters in the command.
     </para>
 

postlfs/shells/tcsh.xml

@@ -136 +136 @@
         <filename>~/.login</filename>, and <filename>~/.logout</filename>. More
         information on these files can be found in the
-        <filename>tcsh(1)</filename> man page.
+        <ulink role='man' url='&man;tcsh.1'>tcsh(1)</ulink> man page.
       </para>
 

postlfs/shells/zsh.xml

@@ -199 +199 @@
         <filename>/etc/zsh/zlogout</filename>.
         You can find more information on these in the
-        <filename>zsh(1)</filename> and related manual pages.
+        <ulink role='man' url='&man;zsh.1'>zsh(1)</ulink> and related
+        manual pages.
       </para>
 

x/installing/xorg-config.xml

@@ -516 +516 @@
         driver, add them into the <literal>Device</literal> section as well.
         The options supported by the modesetting driver are documented in
-        the man page <filename>modesetting(4)</filename>.
+        the man page <ulink role='man'
+        url='&man;modesetting.4'>modesetting(4)</ulink>.
       </para>
 

x/lib/xdg-desktop-portal.xml

@@ -170 +170 @@
         <filename>/usr/share/xdg-desktop-portal/portals.conf</filename>.
         Several other locations can be searched for configuration files. See
-        <filename>portals.conf(5)</filename>.
+        <ulink role='man' url='&man;portals.conf.5'>portals.conf(5)</ulink>.
       </para>
 
@@ -193 +193 @@
         The various configuration files are used to choose the backend
         depending of various conditions. See
-        <filename>portals.conf(5)</filename> for details.
+        <ulink role='man' url='&man;portals.conf.5'>portals.conf(5)</ulink>
+        for details.
       </para>
     </sect3>