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

效果：在所编辑代码中选定一个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，以下代码是连猜带蒙现学现试出来的，不要深究）

String word = textArea.getSelectedText();
if ( (word == null) || (word.length() == 0) ) {
	textArea.selectWord();
	word = textArea.getSelectedText();
}

if ( (word == null) || (word.length() == 0) ) {
	word = Macros.input( view, "Linux man-pages:" );
}

if ( (word != null) && (word.length() > 0) ) {

	File fp;
	String htmlfile;
	String editMode = buffer.getMode().toString();

	// libstdc++ man-pages
	if ( editMode.equals("c++") ) {
		htmlfile = "..\\..\\manpage\\libstdc++\\" + word + ".3.html";
	}

	// system call, glibc
	fp = new File( htmlfile );
	if ( fp.exists() == false ) { 
		for ( var i=1; i<=8; ++i ) {
			htmlfile = "..\\..\\manpage\\pages\\man" + i + "\\" + word + "." + i + ".html";
			fp = new File( htmlfile );
			if ( fp.exists() == true ) {
				break;
			}
		}
	}

	fp = new File( htmlfile );
	if ( fp.exists() == true ) {
		HelpViewer browser = new HelpViewer();
		browser.gotoURL( htmlfile, false, 0 );
	} else {
		Macros.message( view, "man-page \"" + word + "\" not found" );
	}
}

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

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

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

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

-----------------
换用apache stdcxx 作为c++ reference,内容更丰富
把JavaScript The Definitive Guide电子书的reference部分导出,作为js和dom函数参考