我的主目录中存储了一个名为 ~/foo.1 的手册页。如何阅读 $HOME/foo.1 手册页文件?如何使用 man 命令将名为 ~/foo.1 的文件作为联机帮助页读取?
troff 是 AT&T 为 Unix 操作系统开发的文档处理系统。troff 排版系统包括称为宏的命令集,这些命令在开始处理文档之前运行。
教程详情 | |
---|---|
难度级别 | 简单的 |
根权限 | 不 |
要求 | 曼/诺夫 |
美东时间。阅读时间 | 2分钟 |
这些宏包括设置页眉和页脚、定义新命令以及通常影响输出的格式。在 Linux 下,所有新手册页都应使用 groff an.tmac 包进行标记。groff (GNU troff) 软件是一个排版软件包,它读取与格式化命令混合的纯文本并生成格式化输出。
选项#1:使用 man 命令
语法是:
男人。/文件名 man $HOME / foo.1 man ~ / foo.1 man / path / to / foo.1 man / path / to / your-man-page-here
选项#2:使用 nroff 命令
nroff 脚本使用 groff 模拟 nroff 命令,语法为:
nroff -man foo.1 nroff -man $HOME / foo.1 nroff -man /路径/到/foo.1 nroff -man /路径/到/ your-man-page-here
选项#3:设置 MANPATH shell 变量
man 命令搜索环境变量 MANPATH。它是一个以冒号分隔的目录列表,类似于手册页的 PATH 变量。要查看当前手册页路径,请运行:
$ manpath
示例输出:
/usr/local/share/man:/usr/share/man/overrides:/usr/share/man/en:/usr/share/man
man 命令使用一种复杂的方法来查找手册页文件,该方法基于调用选项和环境变量、/etc/man.config 配置文件以及一些内置约定和启发式方法。如果设置了 MANPATH,man 将使用它作为搜索手册页文件的路径。它会覆盖配置文件和自动搜索路径,但会被 -M 调用选项覆盖。
例子
输入以下命令
$ export MANPATH="$(manpath):/path/to/your/man1/"
$ man 1 foo
也可以看看
- 如何:Linux / UNIX 创建联机帮助页
- nroff、manpath 和 man 命令手册页。