linux-man手册使用-ubuntu设置man帮助文档显示中文-man手册少章节

man手册添加与安装

发现系统中缺少很多手册页,或者man命令无法使用,在联网的情况下使用以下命令搞定:
注意:在联网的情况下可以使用如下命令,因为是在线安装,如果不能联网,需要先联网。

sudo apt-get install manpages
sudo apt-get install manpages-de
sudo apt-get install manpages-de-dev
sudo apt-get install manpages-dev
sudo apt-get install glibc-doc manpages-posix-dev manpages-posix    

man命令基本介绍

Linux提供了丰富的帮助手册,当你需要学习某个命令或者不知道如何使用时,只需要使用一下man命令就可以查看到命令非常详细的帮助文档.
使用格式:
man [名称]
man [章节] [名称]

man printf  # 查看printf命令的帮助
man 1 printf # 意思是从man手册的第一章里面去找printf命令的帮助
man 3 printf # 从第手册的第3章去找帮助,(第3章讲的是库函数,所以这里查看到的是printf函数的帮助)
# 更多列举:
# 查看命令帮助
man ls
man sleep
# 查看库函数帮助
man 3 sleep

linux man手册共有9个章节,每个章节的内容各不相同:

章节	内容
1	Standard commands （标准命令）[使用者在shell中可以操作的指令或可执行程序]
2	System calls （系统调用）[ 系统核心可以调用的函数与工具等 ]
3	Library functions （库函数） [ 一些常用的函数与函数库,大部分是C的函数库 ]
4	Special devices （设备说明）[ 设备文件的说明,通常是在/dev下的文件 ]
5	File formats （文件格式）[ 查看配置文件的帮助或者某些文件的格式]
6	Games and toys （游戏和娱乐）
7	Miscellaneous （杂项）[例如:linux文件系统,网络协议,ASCII code等等的说明 ]
8	Administrative Commands （管理员命令）[ 系统管理员可以使用的管理命令 ]
9	其他(linux特定的),跟kernel有关的文件

mam命令中的常用按键操作:

按键	作用
空格键	向后翻一页
PgUp	向上翻一页
PgDn	向下翻一页
home	直接前往到第一页
end	直接前往最后一页
/	从上往下搜索关键词,例如:/OPTIONS ,就是搜索OPTIONS
?	从下往上搜索关键词,例如: ?linux
n	定位到下一个搜索到的关键词
N	定位到上一个搜索到的关键词
q	退出man手册

man手册各模块的意义:

模块名称	含义
NAME	命令的名称
SYNOPSIS	参数的使用方法
DESCRIPTION	介绍说明
EXAMPLES	实例 演示+简单说明
OVERVIEW	概述
DEFAULTS	默认功能
OPTIONS	可用选项的说明
ENVIRONMENT	环境变量
FILES	用到的文件
SEE ALSO	相关资料
HISTORY	维护历史

man 常用参数:

# 查看在哪些章节有指定命令的帮助[格式: man -f 命令 ]
man -f open # 查看open命令在那几个章节中有帮助文档
whatis open  # 功能和man -f open相同
#查看和命令相关的说有命令和帮助手册的章节[格式: man -k 命令 ]
man -k open
man -k close
# 和man -k 功能差不多的命名 [ apropos ]
apropos open
apropos close

参数	描述
-a	显示所有匹配项
-d	显示man查找手册文件时候,显示搜索路径信息,手册页内容
-f	同命令whatis ，将在whatis数据库查找以关键字开同的帮助索引信息
-h	显示帮助信息
-k	同命令apropos 将搜索whatis数据库，模糊查找关键字
-t	使用troff 命令格式化输出手册页 默认：groff输出格式页
-w	不带搜索title 打印manpath变量 带title关键字 打印找到手册文件路径,默认搜索一个文件后停止
-W	和- w相同
section	搜索领域【限定手册类型】默认查找所有手册
-c	显示使用 cat 命令的手册信息
-C	指定man 命令搜索配置文件 默认是man.config
-K	搜索一个字符串在所有手册页中,速度很慢
-M	指定搜索手册的路径
-P xxx	使用程序[xxx]显示手册页面 默认是less ,例如: man -P more open # 使用more显示
-B xxx	使用[xxx]程序显示HTML手册页 默认是less
-H xxx	使用[xxx]程序读取HTML手册，用txt格式显示，默认是cat
-p str	指定通过groff格式化手册之前，先通过其它程序格式化手册

修改man手册默认语言-显示中文

修改方法:
方法一:

1. 终端输入sudo apt-get install manpages-zh
2. 安装后修改配置文件sudo gedit /etc/manpath.config
3. 将所有的/usr/share/man替换为/usr/share/man/zh_CN
4. 保存即可。

方法二:

1. 终端输入sudo apt-get install manpages-zh
2. sudo vi ~/.bashrc
3. 在~/.bashrc下添加"alias cman=‘man -M /usr/share/man/zh_CN’"

#首先执行命令安装中文的man包,ubuntu源里面已经包含了中文的man包，所以不用从其他地方down了
sudo apt-get install manpages-zh
#一般默认都是安装在 "/usr/share/man/zh_CN"下的
dpkg -L manpages-zh | less # 查看中文man手册安装在哪里
#所以在执行完上一步安装成功后,就可以先式一下中文包是否能用
man -M /usr/share/man/zh_CN  open  # 查看open命令的中文帮助
man open # 查看open命令的英文帮助
# 如果常用的如open,printf,这些命令不能查看中文手册,看看是否是指定的路径不正确
# 或者没有安装成功,还有可能是语言包,或者编码的问题,有的需要将man手册的编码转一下,转为UTF-8的

#接下来,修改手册显示中文的方式有很多种
# 1.直接修改man的配置文件 使用你习惯的文本编辑器,vi,gedit(有图形界面才可以使用的)
sudo vi /etc/manpath.config
# 使用 ":1,$s#/usr/share/man#/usr/share/man/zh_CN#g" 
#将manpath.config中的所有/usr/share/man替换为/usr/share/man/zh_CN
#保存退出后,再使用man显示的就是中文手册,
#但是这样有个缺点,就是中文手册中查不到的命令就无法查询手册了,中文手册有限
# 例如: perror 和sendto之类的函数就无法查询
#解决方案:
#将前面修改的配置文件使用vi替换回去:1,$s#/usr/share/man/zh_CN#/usr/share/man#g
sudo vi ~/.bashrc
#在.bashrc中添加:
alias cman='man -M /usr/share/man/zh_CN'
source ~/.bashrc
#这样在查询中文手册时使用cman, cman查询不到了就使用man查询英文手册

其他设置方式:
例如CentOS系统:

1. 下载中文man包:

源码的网址：https://src.fedoraproject.org/repo/pkgs/man-pages-zh-CN
找到源码包:https://src.fedoraproject.org/repo/pkgs/man-pages-zh-CN/manpages-zh-1.5.1.tar.gz/13275fd039de8788b15151c896150bc4/manpages-zh-1.5.1.tar.gz

#首先要有英文版的man
yum  install -y man
yum groupinstall -y "Chinese Support"  #（看看有没有安装中文支持包）
#两种下载方式:
curl https://src.fedoraproject.org/repo/pkgs/man-pages-zh-CN/manpages-zh-1.5.1.tar.gz/13275fd039de8788b15151c896150bc4/manpages-zh-1.5.1.tar.gz
#或者
wget http://manpages-zh.googlecode.com/files/manpages-zh-1.5.tar.gz

2. 解压-编译-安装

tar zxvf manpages-zh-1.5.1.tar.gz
cd manpages-zh-1.5.1
./configure --disable-zhtw #默认安装 
make && make install
vi ~/.bash_profile
#在.bash_profile中增加:
alias cman='man -M /usr/local/zhman/share/man/zh_CN' 
source ~/.bash_profile #更新bash_profile 使其生效

#如果不行则
vim /etc/sysconfig/i18n #里面内容清空
#新增如下内容 增加-->
LANG="zh_CN.GB18030"
LANGUAGE="zh_CN.GB18030:zh_CN.GB2312:zh_CN"
SUPPORTED="zh_CN.UTF-8:zh_CN:zh:en_US.UTF-8:en_US:en"
SYSFONT="lat0-sun16"