jedit中根据所选词自动显示linux man-page的macro

[pi1ot]

效果：在所编辑代码中选定一个c函数名，使用热键调用本macro（我用ctrl-k），即可显示其man-page帮助信息:

[img]/upload/attachment/135106/e91e53fa-522a-3fe3-a7a5-43f26d44f118.png
[/img]

做法如下：

1、在www.kernel.org下载全部man-page的online html版本，地址是http://www.kernel.org/
doc/man-pages/，用 wget -r -k 参数可以一次性下载，总共2000个文件左右，不到30M。也可以下载kernel.org
上的文本打包版本下来，自己写个script用man2html遍历转成html

2、man-pages文件路径和命名极有规律，统统是 .../man{i}/{keyword}.{i}.html格式，所以写个简单的
beanshell macro就可以根据所选字符串定位到具体html文件，最后再用jedit自带的help viewer显示就可以，代码如下
（声明：本人不懂java，以下代码是连猜带蒙现学现试出来的，不要深究）

[code="java"]String word = textArea.getSelectedText();
if ( word==null || word=="" ) {
word = Macros.input( view, "Linux man-pages:" );
}
if ( word != null ) {
String htmlfile;
// 从man1尝试到man8
for ( var i=1; i<=8; ++i ) {
htmlfile = "..\\..\\Techdocs\\manpage\\pages\\man" + i + "\\" +
word + "." + i + ".html";
File fp = new File( htmlfile );
if ( fp.exists() == true ) {
break;
}
}
// 显示
File fp = new File( htmlfile );
if ( fp.exists() == true ) {
HelpViewer browser = new HelpViewer();
browser.gotoURL( htmlfile, false, 0 );
} else {
Macros.message( view, "man-page not found" );
}
}[/code]

另存以上代码为为man_page.bsh，放到jedit/macros目录，rescan macros后即可使用，再分配一个shortcut热
键就更方便了

3、注意：jedit的help viewer默认根路径为jedit所安装目录的./doc下，所以要根据你存放man-pages的实际情况修改以
上代码中第九行的 htmlfile 路径部分，多用几个 "../"就能绕出去

4、如果觉得help viewer太土，可以装jedit infoviewer插件，用infoviewer显示html

[pi1ot]

记录一下 libstdc++ man page 转换流程
1、下载libstdc++-doc
2、在linux平台解压为文本文件，windows不支持文件名含":"
3、循环调用man2html转换为html
4、使用脚本去掉全部"std::"文件名前缀
5、删掉不需要的"__"前缀帮助和文件名含":"的帮助
6、修改以上脚本根据selected text调用显示html