man 手册规范 & troff文件使用

本文介绍了Linux man手册页的存放位置、文档领域的分类方式,如man1用于用户命令,man5用于配置文件说明。此外,讨论了man页面的命名规则,例如`passwd.1`代表`passwd`命令的文档。内容还包括man文件的压缩形式、POSIX程序员和X Windows程序的特定目录以及man页面的规范格式,强调遵循标准以利于文档管理和查询。
摘要由CSDN通过智能技术生成
在Linux下有许多命令,他们都有自己的帮助文档,有一天我们自己的的程序也需要帮助类似的帮助文档的时候应该如何来编写呢 ? 相对这方面的资料较少,这里总结下。

  • man 的帮助文件位置:

存放目录:

首先是目录以及存放规范,linux文档经常放在:MANPATH环境变量指定的目录中。一般在:/usr/share/man 这个目录里面。这个目录下面结构还有定义的:

remon@debian:/usr/share/man$ ls -l
total 212
drwxr-xr-x 5 root root  4096 Feb 15 15:50 cs
drwxr-xr-x 6 root root  4096 Jul 26 22:25 de
drwxr-xr-x 5 root root  4096 Jul 26 22:01 es
drwxr-xr-x 4 root root  4096 Jul 26 22:01 fi
drwxr-xr-x 7 root root  4096 Jul 26 22:25 fr
drwxr-xr-x 3 root root  4096 Jul 26 22:01 gl
drwxr-xr-x 5 root root  4096 Jul 26 22:01 hu
drwxr-xr-x 5 root root  4096 Jul 26 22:01 id
drwxr-xr-x 5 root root  4096 Feb 15 15:50 it
drwxr-xr-x 5 root root  4096 Feb 15 15:50 ja
drwxr-xr-x 5 root root  4096 Feb 15 15:50 ko
drwxr-xr-x 2 root root 57344 Jul 26 22:34 man1
drwxr-xr-x 2 root root  4096 Jul 26 22:01 man2
drwxr-xr-x 2 root root 20480 Jul 26 22:29 man3
drwxr-xr-x 2 root root  4096 Jul 26 22:29 man4
drwxr-xr-x 2 root root 12288 Jul 27 03:01 man5
drwxr-xr-x 2 root root  4096 Jul 26 22:27 man6
drwxr-xr-x 2 root root 12288 Jul 26 22:29 man7
drwxr-xr-x 2 root root 20480 Jul 27 03:01 man8
drwxr-xr-x 5 root root  4096 Feb 15 15:50 pl
drwxr-xr-x 5 root root  4096 Jul 26 22:01 pt
drwxr-xr-x 5 root root  4096 Jul 26 22:01 pt_BR
drwxr-xr-x 5 root root  4096 Feb 15 15:50 ru
drwxr-xr-x 5 root root  4096 Feb 15 15:50 sv
drwxr-xr-x 5 root root  4096 Feb 15 15:50 tr
drwxr-xr-x 5 root root  4096 Feb 15 15:50 zh_CN
drwxr-xr-x 5 root root  4096 Feb 15 15:50 zh_TW

man[*]这类目录表示意思。linux帮助文档,一个特别的有意思的是,按照文档表示不同类型,分领域的(也就是分类别),过会我们会说这个类别按照什么分了。还有就是类似:zh_CN pl.ISO8859-2这些。文档还分语言.地域.字符编码 。可以支持统一命令,多个语言版本的文档,并且地域可以不一样,还可以指定字符集。如:zh_TW.big5 这个意思就是:中文_台湾地区.使用big5字符集编码的文档。


文档领域区分方法(就是类别)

我们看下下面的表格:

领域 描述 说明
1 用户命令 可由任何人启动的,如env、cat、man、touch文档
2 系统调用或内核函数 即由内核提供的函数 如link、sethostname、mkdir
3 库程序 即库函数 如acosh、asctime、btree、locale
4 与设备有关的信息 即/dev目录下的特殊文件 如zero null sda
5 文件格式描述 如/etc/passwd 文件格式描述说明在这个分类下
6 游戏 游戏的帮助文件
7 其他 包括 宏命
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值