前言在Linux編寫或者編譯C代碼的時(shí)候，直接使用man命令就可以查看該函數(shù)的使用手冊(cè)，非常方便，如：但是一般卻沒有C++的函數(shù)手冊(cè)，怎么把C++的幫助手冊(cè)也裝在機(jī)器上呢？本文借助C++手冊(cè)的安裝，說明如何自助安裝man手冊(cè)。man原理安裝C++手冊(cè)下載安裝的第一步自然是先下載手冊(cè)。
可以先進(jìn)入下面一個(gè)鏡像網(wǎng)站：http://gcc.gnu.org/mirrors.html
進(jìn)入之后發(fā)現(xiàn)有很多站點(diǎn)，隨意進(jìn)入一個(gè)，假設(shè)進(jìn)入：http://mirror.linux-ia64.org/gnu/gcc
找到libstdc++/doxygen，即可選擇下載你需要的手冊(cè)。注意選擇帶有man的壓縮包，如我選擇下載的是：libstdc++-api.20140403.man.tar.bz2
安裝所謂安裝也不過是將下載好的手冊(cè)文件解壓到指定位置。還記得在《速查手冊(cè)-man》介紹各個(gè)手冊(cè)的區(qū)別嗎？由于我們的是庫函數(shù)手冊(cè)，因此最好把它放在3處。$ tar -xvf libstdc++-api.20140403.man.tar.bz2
解壓后的文件會(huì)在libstdc++-api.20140403.man下，為了避免和其他的手冊(cè)文件混在一起，我們重新創(chuàng)建一個(gè)目錄：$ mkdir -p /usr/local/cpp/man #可能需要root權(quán)限執(zhí)行
$ cp -rf ./libstdc++-api.20140403.man/man3 /usr/local/cpp/man/
但是我們發(fā)現(xiàn)此時(shí)仍然找不到手冊(cè)：$ man std::cout
No manual entry for std::cout
原因也很簡單，這和我們執(zhí)行普通命令類似（參考《為什么執(zhí)行自己的程序要在前面加./》），它在要搜索的路徑中找不到我們的手冊(cè)。那我們?cè)谀睦锾砑拥哪兀?/span>
我們可以通過man命令查看man手冊(cè)的FILES部分：$ man man
FILES
/etc/man_db.conf
man-db configuration file.
所以對(duì)于我的機(jī)器來說，我需要在/etc/man_db.conf中添加路徑
找到MANDATORY_MANPATH相關(guān)行，添加新行：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
$ /size #左斜杠可以搜索，這里搜索size
看起來好像也沒那么方便啊……
這里說明一下，C++中有命名空間的概念，不同的類中可能有相同名稱的成員函數(shù)，因此直接查看某個(gè)函數(shù)的手冊(cè)，也是很難準(zhǔn)確找到的。突然覺得下載一個(gè)html或者pdf的手冊(cè)好像也挺方便的了，可自行體驗(yàn)。在線手冊(cè)在線手冊(cè)的好處就是，它能比較清晰地看到各個(gè)版本的C++相關(guān)特性。這里主要推薦兩個(gè)https://en.cppreference.com/ 英文
https://zh.cppreference.com/ 中文
www.cplusplus.com
對(duì)于linux命令和C庫函數(shù)，基本使用man進(jìn)行查看，但是對(duì)于C++,不管你用不用，反正我是用在線的。當(dāng)然了，如果你使用chrome瀏覽器的話，還可以配置一下，地址欄輸入C即可直接搜索。設(shè)置方法：
找到設(shè)置-管理搜索引擎，添加內(nèi)容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
如果你已經(jīng)在這兩個(gè)網(wǎng)站搜索過，你還可以在其他搜索引擎中看到這樣的內(nèi)容：這個(gè)時(shí)候你只需要編輯里面的關(guān)鍵字，設(shè)置成自己喜歡的就可以了，如C。添加之后，在chrome地址欄輸入c，按tab鍵，即可出現(xiàn)：手邊手冊(cè)要么就是買一本大頭手冊(cè)《C++標(biāo)準(zhǔn)庫》。
|
