LLVM对注释的新增支持 @ WWDC 2013
来源:互联网 发布:韩子高网络剧下 编辑:程序博客网 时间:2024/06/10 15:43
很久之前我就在想:“我应该按照什么格式写注释,才能像Apple官方API那样按住Option键并点击函数名可以跳出文档说明”,如下图:
我理所当然地认为这个功能应该是根据现有注释的格式来进行排版的,于是按住Command键点进去想学习下,结果大失所望:
按照这个很基本、很普通的格式来写注释,是得不到期望的结果的。所幸在今年WWDC的Session 402中提到相关支持——What's New in the LLVM Compiler:
通过如上格式的注释,我们可以通过Option加上点击得到Quick Help:
此外,还可以在代码自动完成时看到相应注释:
方便在细节之处,有木有!?当函数名很长、只有最后一两个参数不同的时候(看不到完整函数名),再也不用瞎猜了。
这下让程序员们更有动力去编写更优美的注释了,但如果每次都手工添加上面那么多、又注重格式的注释,显然有点得不偿失。刚好Session 402的PDF文档里面(往上数第二张图)提到了Doxygen这款工具。
在网上搜索了下,参考了两篇文章(链接一、链接二)。通过下载写好的Doxygen Helper,解压后双击安装到Service:
然后在键盘设置中为Xcode添加相应的快捷键:
接着打开Xcode 5,如果快捷键无效,可以再往下看:
在服务里开启相应功能,如果需要可以重启下Xcode,就可以使用快捷键来创建注释了:
显然,新的LLVM在做词法分析时还是支持了比较经典的几种注释格式的。赞一个!
到此,LLVM已经在代码的可维护性和可读性上为我们提供了更多便利。考虑到使用了Doxygen,并且有提供类似SDK基础服务的话,可以参考这篇文章,利用Doxygen将自动生成的注释文档化:
—— Jason Lee @ Hangzhou
- LLVM对注释的新增支持 @ WWDC 2013
- LLVM在警告方面的改进 @ WWDC 2013
- LLVM在静态分析上的增强 @ WWDC 2013
- 新增对PNG格式图片的支持
- WWDC 上讲到的 Objective C / LLVM 改进
- VC2010新增加对多线程的支持类
- Entity Framework 4.0新增对T-SQL的支持
- Entity Framework 4.0新增对T-SQL的支持
- Flash11新增加了SWF对LZMA压缩的支持
- Go1.3中新增对Native Client的支持
- PNaCl:Google通过LLVM增强对Chrome中原生应用的支持
- PNaCl:Google通过LLVM增强对Chrome中原生应用的支持
- Eclipse CDT 对 Doxygen 型注释的支持
- wwdc 2013
- 我的网站新增加了个域名,谢谢大家对我的支持
- Visual.Assist.X.V10.7.1908采用DLL覆盖破解技术. 新增了对VS2012的支持
- OVM-V1.5 发布,新增对 VMware ESXI 节点的支持
- 对x264_param_t 的注释
- Mahout Canopy聚类
- 树状数组
- 如何用好google
- 理解背包问题
- 封装,继承,多态 。你可以把编程当女朋友看待! 但是,你绝对不可以拿女朋友当编程看待。
- LLVM对注释的新增支持 @ WWDC 2013
- 记录Nginx如何启动、停止、重启、升级操作命令
- 在表单提交前进行验证的几种方式
- java常用实用类---String类
- oracle spfile pfile小结
- 说说JDK中的String.valueOf()传null的诡异处理
- linux nginx安装
- libnl-1.1 移植到ARM Linux
- 发一个 启动各类android系统应用的intent action 的链接