linux自助安装man手册，就是这么简单！

╰半橙微兮° 2023-05-29 11:47 2阅读 0赞

## 前言 ##

在Linux编写或者编译C代码的时候，直接使用man命令就可以查看该函数的使用手册，非常方便，如：

man 3 sleep

但是一般却没有C++的函数手册，怎么把C++的帮助手册也装在机器上呢？

本文借助C++手册的安装，说明如何自助安装man手册。

## man原理 ##

如果你还不习惯使用man命令或者不清楚man命令的作用，那么建议你先看看这篇《[linux必学命令-man][linux_-man]》。

## 安装C++手册 ##

主要步骤如下：

*  下载手册
 *  安装手册
 *  使用手册

下载

安装的第一步自然是先下载手册。  
可以先进入下面一个镜像网站：

http://gcc.gnu.org/mirrors.html

进入之后发现有很多站点，随意进入一个，假设进入：

http://mirror.linux-ia64.org/gnu/gcc

找到libstdc++/doxygen，即可选择下载你需要的手册。注意选择带有man的压缩包，如我选择下载的是：

libstdc++-api.20140403.man.tar.bz2

安装

所谓安装也不过是将下载好的手册文件解压到指定位置。还记得在《[速查手册-man][linux_-man]》介绍各个手册的区别吗？由于我们的是库函数手册，因此最好把它放在3处。

于是，我们解压：

$ tar -xvf libstdc++-api.20140403.man.tar.bz2

解压后的文件会在libstdc++-api.20140403.man下，为了避免和其他的手册文件混在一起，我们重新创建一个目录：

$ mkdir -p /usr/local/cpp/man \#可能需要root权限执行

此时将其拷贝到上面的目录下：

$ cp -rf ./libstdc++-api.20140403.man/man3 /usr/local/cpp/man/

但是我们发现此时仍然找不到手册：

$ man std::cout  
No manual entry for std::cout

原因也很简单，这和我们执行普通命令类似（参考《[为什么执行自己的程序要在前面加./][.]》），它在要搜索的路径中找不到我们的手册。那我们在哪里添加的呢？  
我们可以通过man命令查看man手册的FILES部分：

$ man man  
FILES  
/etc/man\_db.conf  
man-db configuration file.

所以对于我的机器来说，我需要在/etc/man\_db.conf中添加路径  
找到MANDATORY\_MANPATH相关行，添加新行：

MANDATORY\_MANPATH /usr/local/cpp/man

这样就可以了。

我们来试一下：

$ man std::count  
No manual entry for std::count

为什么还是没有呢？，你查看一下/usr/local/cpp/man/man3下的文件都是什么名字就明白了：

$ ls /usr/local/cpp/man/man3/\* |more  
std::iostream.3

原来还要带上命名空间和头文件的名字，例如：

$ man std::map

然后再使用搜索功能：

$ /size \#左斜杠可以搜索，这里搜索size

看起来好像也没那么方便啊……  
这里说明一下，C++中有命名空间的概念，不同的类中可能有相同名称的成员函数，因此直接查看某个函数的手册，也是很难准确找到的。

突然觉得下载一个html或者pdf的手册好像也挺方便的了，可自行体验。

## 在线手册 ##

在线手册的好处就是，它能比较清晰地看到各个版本的C++相关特性。这里主要推荐两个

https://en.cppreference.com/ 英文  
https://zh.cppreference.com/ 中文  
www.cplusplus.com

从中搜索就可以啦。

对于linux命令和C库函数，基本使用man进行查看，但是对于C++,不管你用不用，反正我是用在线的。

当然了，如果你使用chrome浏览器的话，还可以配置一下，地址栏输入C即可直接搜索。

设置方法：  
找到设置-管理搜索引擎，添加内容

中文版：

https://zh.cppreference.com/mwiki/index.php?title=Special:%E6%90%9C%E7%B4%A2&search=%s

英文版：

https://en.cppreference.com/mwiki/index.php?title=Special:Search&search=%s

添加内容如下图：

![format_png][]

如果你已经在这两个网站搜索过，你还可以在其他搜索引擎中看到这样的内容：

![format_png 1][]

这个时候你只需要编辑里面的关键字，设置成自己喜欢的就可以了，如C。

添加之后，在chrome地址栏输入c，按tab键，即可出现：

![format_png 2][]

## 手边手册 ##

要么就是买一本大头手册《C++标准库》。

当然也可以在公众号【编程珠玑】后台回复【C++标准库】获取电子版，仅供学习交流。

## 总结 ##

本文旨在引导如何自助安装手册，其步骤也简洁明了：

*  下载手册
 *  解压手册
 *  放到特定位置
 *  让man能够找到

你一般是如何查看函数的帮助手册的，欢迎留言分享。

首发：公众号【编程珠玑】

作者：守望先生

ID：shouwangxiansheng

推荐阅读：

[C++与C中的const关键字有何差别？][C_C_const]

[学Linux到底学什么？][Linux]

[作为一个C/C++工程师，聊聊对Python的看法][C_C_Python]

[为什么执行自己的程序要在前面加./][.]

关注公众号【编程珠玑】，获取更多Linux/C/C++/算法/计算机基础/工具等原创技术文章。后台免费获取经典电子书和视频资源

![format_png 3][]

[linux_-man]: http://mp.weixin.qq.com/s?__biz=MzI2OTA3NTk3Ng==&mid=2649284160&idx=1&sn=2004ffb753bcbec2fa61022a3a2faf8e&chksm=f2f9ad27c58e24317b3bfb082ea863755204302010d9e3522d7b4cc59b7799383e09e24a1fc4&scene=21#wechat_redirect
[.]: http://mp.weixin.qq.com/s?__biz=MzI2OTA3NTk3Ng==&mid=2649285059&idx=1&sn=3da7c7d8f108698b755d3fc251c33428&chksm=f2f992a4c58e1bb2fcb676fbf6f2f238a6d935677629fb66d1c989c608617d8c3b5f4d50a8fb&scene=21#wechat_redirect
[format_png]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X2pwZy93ZEp2VG5JQ2xmdHk5YUdLdVZNQmw3NUZOT0ZYZzhpYWliQlJmVWlieTBpYURDSjVoSU9YYVJoejJWRVVPQ1BRd0lLQlhLME1RVE5Vc0JvVlZnOGtpY3BUbG1nLzY0MA?x-oss-process=image/format,png
[format_png 1]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X2pwZy93ZEp2VG5JQ2xmdHk5YUdLdVZNQmw3NUZOT0ZYZzhpYWliSUhnUnJLSWE4RE4xYlVEZVl3UzhKREw1MWx5WGhPUkpSeTlhbXlKYldkYWlhblp0N2M1ZHVGZy82NDA?x-oss-process=image/format,png
[format_png 2]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X2pwZy93ZEp2VG5JQ2xmdHk5YUdLdVZNQmw3NUZOT0ZYZzhpYWliODVncG5QOE0wSUYza1NiQUF3WUs4emp6ZUNSa2RDanRNdWliY0FaV3J6NmljZTdjQkEzOUUwSWcvNjQw?x-oss-process=image/format,png
[C_C_const]: http://mp.weixin.qq.com/s?__biz=MzI2OTA3NTk3Ng==&mid=2649285188&idx=1&sn=466f1615439b1c5be4321ad4ac6656ec&chksm=f2f99123c58e1835db31e73444e1457ebe9966112ef0b102426e7d4bc9f2a9fc598e861c5900&scene=21#wechat_redirect
[Linux]: http://mp.weixin.qq.com/s?__biz=MzI2OTA3NTk3Ng==&mid=2649285042&idx=1&sn=1403b4da83346df98150321f52d49ac8&chksm=f2f992d5c58e1bc355b4775d8a68a557990bd6160ba0f2eee610d8412c06cbdbac29650b436c&scene=21#wechat_redirect
[C_C_Python]: http://mp.weixin.qq.com/s?__biz=MzI2OTA3NTk3Ng==&mid=2649285161&idx=1&sn=71f687873e05c19fd9aab6196a666691&chksm=f2f9914ec58e1858f345c07cfab990dc300779cabc8a9e345a09df359a79f8993bff10694505&scene=21#wechat_redirect
[format_png 3]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X2pwZy93ZEp2VG5JQ2xmdlJaOUh1RFd2cjRZMkRoaWJ6c1NXTkwxZlhRaWMwUEIxSFZsYkdNcVFHVEVTdW5oblRTc0E2cDg1VnM3OHV4dzV2RXcwYjBoRFhQT3RRLzY0MA?x-oss-process=image/format,png