手册页和其他在线文档
即使在 Google 时代,我们仍继续参考手册页作为权威资源,因为它们可以从命令行访问,通常包括程序选项的完整详细信息,并显示有用的示例和相关命令。
手册页是对单个命令、驱动程序、文件格式或库例程的简明描述。
它们不涉及更一般的主题,例如“如何安装新设备?”或者“为什么这个系统这么慢?”
man page的组织形式
FreeBSD 和 Linux 将手册页分成几个部分。
其他 UNIX 变体有时对部分的定义略有不同。
man命令:读取man手册内容
man title 格式化特定的手册页,并通过more、less或在 PAGER 环境变量中指定的任何程序将其发送到您的终端。
标题通常是命令、设备、文件名或库例程的名称。
手册各部分按大致数字顺序搜索,但通常首先搜索描述命令的部分(第 1 和 8 部分)。
$ man -k translate
objcopy (1) - copy and translate object files
dcgettext (3) - translate message
tr (1) - translate or delete characters
snmptranslate (1) - translate SNMP OID values into useful information
tr (1p) - translate characters
man手册存放
man手册存放在/usr/share/man目录下,并且用gzip格式压缩存放,以节省空间
如果适当的目录可写,则 man 在 /var/cache/man 或 /usr/share/man 中维护格式化页面的缓存;
然而,这是一个安全风险。大多数系统在安装时预先格式化一次手册页(请参阅 catman)或根本不预先格式化。
man 命令可以搜索多个手册页存储库以查找您请求的手册页。
在 Linux 系统上,您可以使用 manpath 命令找出当前的默认搜索路径。
(base) [root@theThree ~]# manpath
/root/anaconda3/man:/root/perl5/man:/usr/local/ruby/share/man:/application/mysql/man:/usr/local/share/man:/usr/share/man/overrides:/usr/share/man
(base) [root@theThree ~]#
某些系统允许您为手册页设置自定义的系统范围默认搜索路径,如果您需要维护手册页的并行树(例如 OpenPKG 生成的手册页),这会很有用。
然而,要以手册页的形式分发本地文档,使用系统的标准打包机制并将手册页放在标准手册目录中会更简单。