Ruby on Rails 中文 Wiki
Rails2_0新特性_源代码注释

这里所说的注释并不是您在 Java或C# 中所看到那样密集的注释 – 这里将介绍一个记录 todo 的方法,以及其他有助于思维提示 的经验。请看下面一段代码:

class ContactsController < ApplicationController

  # TODO: 添加动态支持
  # OPTIMIZE: 优化这行代码
  # FIXME: 这里有问题
  def index
    ...
  end
end

利用新的 rake 任务,我们现在可以吐出一列注释:

rake notes
app/controllers/contacts_controller.rb:
  * [ 3] [TODO] 添加动态支持
  * [ 4] [OPTIMIZE] 优化这行代码
  * [ 5] [FIXME] 这里有问题

您也只能调用一系列特定类别的rake记录如: rake notes:todo, rake notes:optimize 以及 rake notes:fixme。

提示:JD 知道如何将这个rake任务安装在稳定的(非edge) Rails应用程序上,感谢JD!

cd lib/tasks && \
  wget http://dev.rubyonrails.org/export/7553/trunk/railties/lib/tasks/annotations.rake

感谢 Yudi 提供本系列文档

原文作者是 Ryan Daigle, 请访问他的博客

本条目被以下条目链接: