- Timestamp:
- 10/25/2008 09:38:03 PM (16 years ago)
- Branches:
- 10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 12.2, 12.2-rc1, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/loongarch-12.2, xry111/mips64el, xry111/multilib, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc
- Children:
- 6da4dd7
- Parents:
- 7f89db8
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
chapter06/man-db.xml
r7f89db8 rbc81164 41 41 <sect2 role="installation"> 42 42 <title>Installation of Man-DB</title> 43 44 <!-- <para>Two adjustments need to be made to the sources of Man-DB.</para>45 46 <para>The first change is a <command>sed</command> substitution to delete47 the <quote>/usr/man</quote> and <quote>/usr/local/man</quote> lines in48 the <filename>man_db.conf</filename> file to prevent redundant results49 when using programs such as <command>whatis</command>:</para> -->50 43 51 44 <para>LFS creates <filename>/usr/man</filename> and … … 116 109 <sect2> 117 110 <title>Non-English Manual Pages in LFS</title> 118 <!-- 119 <para>Some packages provide UTF-8 manual pages, which previous versions of 120 <application>Man-DB</application> were unable to display correctly because 121 the expected (8-bit) encoding for each language was hard-coded in the 122 source of <application>Man-DB</application>. 123 <application>Man-DB</application> now uses the extension of the directory 124 name in order to determine the encoding of the manual pages stored within. 125 If no extension exists, <application>Man-DB</application> uses a built-in 126 table (see below) to determine the encoding. E.g., because of "UTF-8" in 127 the directory name, it knows that all manual pages residing in 128 <filename class="directory">/usr/share/man/fr.UTF-8</filename> are UTF-8 129 encoded and, according to the built-in table, expects all manual pages 130 residing in <filename class="directory">/usr/share/man/ru</filename> to 131 be encoded using KOI8-R.</para> 132 133 <para>Linux distributions have different policies concerning the character 134 encoding in which manual pages are stored in the filesystem. E.g., RedHat 135 stores all manual pages in UTF-8, while Debian previously used 136 language-specific (mostly 8-bit) encodings. Many other distributions simply 137 ignore the problem all together. LFS also used the legacy encodings in 138 previuos versions of the book. This was chosen because of the ease of 139 configuration associated with <application>Man-DB</application>. 140 Additionally, <application>Man-DB</application> provided support for 141 Chinese and Japanese locales, and limited support for Korean, whereas 142 <application>Man</application> did not at that time.</para> 143 144 <para>In contrast, the setup in Fedora Core expects all manual pages 145 to be UTF-8 encoded, and stored in directories without suffixes. 146 Disagreement about the expected encoding of manual pages amongst 147 distribution vendors, has led to confusion for upstream package maintainers. 148 Some packages contain, UTF-8 manual pages, while others ship with manual 149 pages in legacy encodings. Unlike the 150 <application>Man</application>/<application>Groff</application> setup in 151 Fedora Core, <application>Man-DB</application> can make very good decisions 152 about the on disk encoding and present the information to the user in their 153 prefered format, without complex configurations.</para> 154 155 <para><application>Man-DB</application> has, for the most part, made this 156 problem completely transparent to end users, as long as the manual pages 157 are installed into the correct directory. There may be times, however, 158 where one encoding is preferred over the other. For this purpose, the 159 <command>convert-mans</command> script was written. It will convert manual 160 pages to another encoding before (or after) installation. Install the 161 <command>convert-mans</command> script with the following 162 instructions:</para> 163 --> 111 164 112 <para>Some packages provide non-English manual pages. They are displayed 165 113 correctly only if their location and encoding matches the expectation of
Note:
See TracChangeset
for help on using the changeset viewer.