写C代码时,用惯了doxygen,现在写lua代码,也特别地希望用doxygen,上官网看了看,真发现有lua的filter

git clone https://github.com/alecchen/doxygen-lua.git 这个源即可获取,不过貌似人家没有管Windows什么事,perl脚本,所有东西都是Linux的

好在我们有cygwin,在cygwin中安装上perl和doxygen后,依然不能按照他说的办法安装,错误信息大约是找不到 Install.pm之类的,

经研究发现,其实是可以这样的:

  • cp -r doxygen-lua/lib/Doxygen /lib/perl5/5.10/ 将整个Doxygen文件夹拷贝到perl的库文件夹中
  • perldoc Doxygen::Lua 如果有输出帮助信息,说明拷贝正确
  • cp doxygen-lua/bin/lua2dox /usr/bin/  这是最终要用到的脚本,放path中去
  • 在Doxyfile中加上这么一句:FILTER_PATTERNS = *.lua=lua2dox 即可

验证:

  • cd doxygen-lua/example
  • 修改  FILTER_PATTERNS = *.lua=../bin/lua2dox => FILTER_PATTERNS = *.lua=lua2dox
  • doxygen  执行doxygen
  • 查看html

貌似脚本的功能有限。而且我觉得既然是Lua的Filter,就应该用Lua来写,这样也好让人加入,现在用perl,让我这个完全不懂perl的情何以堪啊~~

Logo

开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!

更多推荐