Linux内核---53.安装kernel API的man手册

参考：http://hi.baidu.com/handsoul/blog/item/eb2f59f11d55e8d90a46e0b2.html

系统环境：ubuntu-10.04.1-desktop-i386

1、下载一个内核源代码
2、安装make mandocs的两个依赖：
一个是xmlto,它的作用是：Convert xml to many other formats
下载地址：http://download.chinaunix.net/download/0012000/11917.shtml
一个是docbook-xls:作用是：XML stylesheets for Docbook-xml transformations
下载地址：http://sourceforge.net/projects/docbook/files/docbook-xsl/1.71.1/

这个软件docbook-xsl最好用sudo apt-get install docbook-xsl安装，因为其实xmlto不止依赖docbook-xsl软件，还有其他的软件不清楚(我估计应该是docbook-xsl-doc-html软件)。而软件xmlto最好自己下载tar安装软件包，因为用apt-get安装的话要下载355MB其他相关extra packages，网速太慢。
yun@yun-desktop:/work/kernel/docbook-xsl-1.76.1$ sudo apt-get install docbook-xsl
yun@yun-desktop:/work/kernel/xmlto-0.0.18$ ./configure 
yun@yun-desktop:/work/kernel/xmlto-0.0.18$ make
yun@yun-desktop:/work/kernel/xmlto-0.0.18$ sudo make install
3、解压内核源代码，到内核源码的根目录
yun@yun-desktop:/work/kernel/linux-3.2.9$ make mandocs
yun@yun-desktop:/work/kernel/linux-3.2.9$ sudo make installmandocs
[sudo] password for yun: 
  GEN     /work/kernel/linux-3.2.9/Documentation/DocBook//v4l2.xml
mkdir -p /usr/local/man/man9/
install Documentation/DocBook/man/*.9.gz /usr/local/man/man9/
切记这句命令的installmandocs中间没有空格
查看软件安装在/usr/local/share/man/的man9中。
编译时间长，希望虚拟机执行完自己关机的话，命令后面跟个poweroff，让虚拟机自己慢慢执行,执行完自动关机。

例如：make installmandocs;sudo poweroff           

注意：命令之间有分号
4、测试下：
yun@yun-desktop:/work/kernel/linux-3.2.9$ man printk

【转】http://blog.163.com/yun_2527/blog/static/3527186120122242516589/

 xmlto-0.0.18.tar.bz2.zip   (下载后改名为 xmlto-0.0.18.tar.bz2 )