LLVM对注释的新增支持 @ WWDC 2013

本文介绍了LLVM在WWDC 2013中新增的注释支持,允许开发者通过特定格式的注释实现快速帮助功能。通过Option键点击函数名,可以显示详细文档。同时,推荐了Doxygen工具,它能自动化生成注释,提升代码的可维护性和可读性。在Xcode中配置Doxygen服务后,开发者可以更高效地编写注释。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

很久之前我就在想:“我应该按照什么格式写注释,才能像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

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值