6.45. Man-DB-2.4.3

最后更新于:2022-04-01 22:50:38

# 6.45\. Man-DB-2.4.3 Man-DB 包含查找和显示 man 手册页的程序。 **预计编译时间:** 0.2 SBU**所需磁盘空间:** 9 MB ## 6.45.1\. 安装 Man-DB 对 Man-DB 的源码需要做三个调整。 第一,改变已翻译的 Man-DB 带的 manual 页的位置,使其在传统和 UTF-8 的 locale 环境下均能使用: ``` mv man/de{_DE.88591,} && mv man/es{_ES.88591,} && mv man/it{_IT.88591,} && mv man/ja{_JP.eucJP,} && sed -i 's,\*_\*,??,' man/Makefile.in ``` 第二,使用 `sed` 的替换功能来删除 `man_db.conf` 文件中的 "/usr/man" 行, 来避免在使用像 `whatis` 这样的命令时的冗余结果: ``` sed -i '/\t\/usr\/man/d' src/man_db.conf.in ``` 第三,改变 Man-DB 在运行时应该能够发现的程序的记录,但它们还没有安装: ``` cat >>include/manconfig.h.in <<"EOF" #define WEB_BROWSER "exec /usr/bin/lynx" #define COL "/usr/bin/col" #define VGRIND "/usr/bin/vgrind" #define GRAP "/usr/bin/grap" EOF ``` `col` 是 Util-linux 的一部分, `lynx` 基于文本的浏览器(参见 BLFS 的安装说明), `vgrind` 把程序源码转换为 Groff 的输入,`grap` 在 Groff 文档中对图表排版非常有用。 `vgrind` 和 `grap` 不是查看 manual 页所必须的。它们不是 LFS 的一部分,也不是 BLFS 的一部分,但是在完成 LFS 之后,你应该能够自己安装。 为编译 Man-DB 做准备: ``` ./configure --prefix=/usr --enable-mb-groff --disable-setuid ``` **配置选项的含义:** _`--enable-mb-groff`_ 通知 `man` 在格式化非ISO-8859-1格式的 manual 页时,使用 "ascii8" 和 "nippon" Groff 设备。 _`--disable-setuid`_ 使 `man` 不能给用户 `man` 设置uid位。 编译软件包: ``` make ``` 这个软件包没有附带测试程序。 安装软件包: ``` make install ``` 一些软件包提供这个版本 `man` 无法显示的 UTF-8 编码的 man 手册页。 下面的脚本将会允许它们中的一些转换成为下面表中的编码格式。Man-DB 期望 manual 页的编码格式是下面表中的一项。在显示它们的时 候,可以根据需要转换成实际的 locale 编码,因此它们能够在传统的和 UTF-8 的locale下显示。因为脚本是在系统构建和对公共数据 中限制使用的,所以,我们不必担心错误检测和使用非预期的临时文件名。 ``` cat >>convert-mans <<"EOF" #!/bin/sh -e FROM="$1" TO="$2" shift ; shift while [ $# -gt 0 ] do FILE="$1" shift iconv -f "$FROM" -t "$TO" "$FILE" >.tmp.iconv mv .tmp.iconv "$FILE" done EOF install -m755 convert-mans /usr/bin ``` 一些关于 man 和 info 页的压缩可以在 BLFS 手册中找到([_http://www.linuxfromscratch.org/blfs/view/cvs/postlfs/compressdoc.html_](http://www.linuxfromscratch.org/blfs/view/cvs/postlfs/compressdoc.html))。 ## 6.45.2\. Non-English Manual Pages in LFS 每一种 Linux 的发行版在存储 manual 页的字符编码方面都有自己的方法。比如,RedHat 以 UTF-8 编码存储所有的 manual 页;然而 Debian 使用不同的语言编码(通常是8位的)。这 就导致包在为不同发行版设置 manual 页时不兼容。 LFS采用跟 Debian 一样的方法。这是因为 Man-DB 不能够理解 UTF-8 存储的 man 手册页。Man-DB 比 Man 好在在任意的 locale 下不需要额外的配置就可以使用。最后,我们没有选用 RedHat 的方法,因为它的`groff`文本格式组织的不好。 语言跟字符编码的关联已经列在下面的表中。Man-DB 会在查看的时候自动的将它们转变为 locale 的编码。 **Table 6.1\. manual 页的字符编码表 pages** | Language (code) | Encoding | | --- | --- | | Danish (da) | ISO-8859-1 | | German (de) | ISO-8859-1 | | English (en) | ISO-8859-1 | | Spanish (es) | ISO-8859-1 | | Finnish (fi) | ISO-8859-1 | | French (fr) | ISO-8859-1 | | Irish (ga) | ISO-8859-1 | | Galician (gl) | ISO-8859-1 | | Indonesian (id) | ISO-8859-1 | | Icelandic (is) | ISO-8859-1 | | Italian (it) | ISO-8859-1 | | Dutch (nl) | ISO-8859-1 | | Norwegian (no) | ISO-8859-1 | | Portuguese (pt) | ISO-8859-1 | | Swedish (sv) | ISO-8859-1 | | Czech (cs) | ISO-8859-2 | | Croatian (hr) | ISO-8859-2 | | Hungarian (hu) | ISO-8859-2 | | Japanese (ja) | EUC-JP | | Korean (ko) | EUC-KR | | Polish (pl) | ISO-8859-2 | | Russian (ru) | KOI8-R | | Slovak (sk) | ISO-8859-2 | | Turkish (tr) | ISO-8859-9 | ### 注意 不在上面列表中的语言的 Manual 页是不支持的。挪威语无法使用,因为从 no_NO 到 nb_NO 的locale转变。韩语因为不完整的 patch 也是功能不全的。 of the incomplete Groff patch. 如果 manual 页的编码是 Man-DB 所预期的,manual 页就会被拷贝到 `/usr/share/man/`。例如,法语的 manual 页([_http://ccb.club.fr/man/man-fr-1.58.0.tar.bz2_](http://ccb.club.fr/man/man-fr-1.58.0.tar.bz2)) 可以使用下面的命令安装: ``` mkdir -p /usr/share/man/fr && cp -rv man? /usr/share/man/fr ``` 如果 manual 页是 UTF-8 编码的(例如,针对 "RedHat" 的) ,而不是上面列表中的。它们不得不在安装之前从 UTF-8 转变为列表中的编码。这可以通过 `convert-mans` 来实现。比如,西班牙的 manual 页 ([_http://ditec.um.es/~piernas/manpages-es/man-pages-es-1.55.tar.bz2_](http://ditec.um.es/~piernas/manpages-es/man-pages-es-1.55.tar.bz2)) 可以通过下面的命令来安装: ``` mv man7/iso_8859-7.7{,X} convert-mans UTF-8 ISO-8859-1 man?/*.? mv man7/iso_8859-7.7{X,} make install ``` ### 注意 在转换的过程中需要除去 `man7/iso_8859-7.7` 文件,因为它已经存在于ISO-8859-1中,这是 man-pages-es-1.55 的一个bug。下一个版本可能就不会需要了。 ## 6.45.3\. Man-DB 的内容 **安装的程序:** accessdb, apropos, catman, convert-mans,lexgrog, man, mandb, manpath, whatis, zsoelim ### 简要描述 | | | | --- | --- | | `accessdb` | 将 `whatis` 数据库的内容转储为人类可读形式 | | `apropos` | 搜索 `whatis` 数据库,显示包含给定字符串的系统命令的简短描述。 | | `catman` | 创建或更新预格式化的 manual 页 | | `convert-mans` | 重新格式化 man 手册页,以使 Man-DB 能够显示它们 | | `lexgrog` | 显示一行给定 manual 页的摘要信息。 | | `man` | 格式化并显示请求的 manual 页 | | `mandb` | 创建或更新 `whatis` 数据库 | | `manpath` | 显示 $MANPATH 的内容或在man.conf中设置的搜索路径(如果 $MANPATH 没有设置),以及用户的环境变量。 | | `whatis` | 搜索 `whatis` 数据库,显示包含给定关键字的系统命令的简短描述。 | | `zsoelim` | 读取文件并用提到的 _file_ 的内容来替换 _.so file_ 格式的行。 |
';