RDoc 3.10 發(fā)布了，RDoc是針對Ruby源代碼的文檔系統(tǒng)。跟JavaDoc一樣，RDoc可以讀取原文件，分析源代碼中的語法信息和注釋文本，生成HTML格式的文檔。和JavaDoc不同的是，即便源代碼沒有任何注釋，RDoc也能生成相當漂亮的文檔內(nèi)容。在編寫源程序的同時編寫RDoc可以說易如反掌。Ruby的內(nèi)建庫和標準庫文檔都是用RDoc生成的。應該可以使用ri命令來訪問這些文檔，不過這也取決于你安裝Ruby的方式。

該版本增強了部分功能和修復了一些Bug，包括：

主要增強：

◆ 改善了RDoc HTML輸出。

◆ 支持更多的文檔格式：TomDoc 1.0.0 - RC1和Rd格式。

◆ 現(xiàn)在可以保存和加載選項文件。

小幅改進：

◆ HTML標題現(xiàn)在擁有和標題匹配的id，如“= Hello!”呈現(xiàn)為“ <h1 id="label-Hello%21">Hello!</h1>”。

◆ 類或方法的標簽可以通過添加一個“@”來鏈接到此類或方法的相關內(nèi)容。

◆ 針對HTML輸出，RDoc中SomeClass.method_name和SomeClass#method_name用于遠程方法和屬性，::method_name and#method_name用于本地方法。

◆ 改進了Ruby代碼的語法高亮。

◆ 新增了rdoc-label鏈接機制，允許雙向鏈接。

◆ HTTPS URL中的圖片路徑現(xiàn)在能被轉換成+<img>+ tags形式。

◆ 新增了RDoc::Comment，可對評論進行處理。

另外，該版本還修復了一些Bug，詳細信息參閱：RDoc發(fā)行說明

Rdoc文檔：http://rdoc.rubyforge.org/

下載地址：https://github.com/rdoc/rdoc

【編輯推薦】

1. Ruby on Rails 3.1 正式版發(fā)布
2. JRuby和Java 7 我們可以期待什么
3. 每個程序員都應該學習使用Python或Ruby
4. Perl、PHP、Python、Java和Ruby的比較
5. 初探 Ruby Metaprogramming