# RDoc 2.4.2 Released

**URL:** <https://www.ruby-forum.com/t/rdoc-2-4-2-released/163903>\
**Category:** Ruby\
**Created:** [March 26, 2009, 12:24am UTC](https://www.ruby-forum.com/t/rdoc-2-4-2-released/163903 "2009-03-26T00:24:42Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![miracleofmagick](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/m/71c47a/32.png) [@miracleofmagick](https://www.ruby-forum.com/u/miracleofmagick)\
**Post date:** [March 26, 2009, 12:24am UTC](https://www.ruby-forum.com/t/rdoc-2-4-2-released/163903/1 "2009-03-26T00:24:42Z")

</div>

rdoc version 2.4.2 has been released!

- RDoc Project Page - [http://rubyforge.org/projects/rdoc/](http://rubyforge.org/projects/rdoc/)
- RDoc Documentation - [http://rdoc.rubyforge.org/](http://rdoc.rubyforge.org/)
- RDoc Bug Tracker -  
[http://rubyforge.org/tracker/?atid=2472&group\_id=627&func=browse](http://rubyforge.org/tracker/?atid=2472&group_id=627&func=browse)

RDoc is an application that produces documentation for one or more  
Ruby source  
files. RDoc includes the +rdoc+ and +ri+ tools for generating and  
displaying  
online documentation.

At this point in time, RDoc 2.x is a work in progress and may incur  
further  
API changes beyond what has been made to RDoc 1.0.1. Command-line  
tools are  
largely unaffected, but internal APIs may shift rapidly.

See RDoc for a description of RDoc’s markup and basic use.

Changes:

### 2.4.2 / 2009-03-25

- 2 Minor Enhancements

- 10 Bug Fixes

---

<div class="post-metadata">

**Author:** ![miracleofmagick](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/m/71c47a/32.png) [@miracleofmagick](https://www.ruby-forum.com/u/miracleofmagick)\
**Post date:** [March 26, 2009, 3:20pm UTC](https://www.ruby-forum.com/t/rdoc-2-4-2-released/163903/2 "2009-03-26T15:20:37Z")

</div>

Eric H. [removed\_email\_address@domain.invalid](mailto:removed_email_address@domain.invalid) wrote:

> rdoc version 2.4.2 has been released!

Better and better. But OMM (still using ruby 1.8.6) I still often  
encounter basic methods that show up in “ri” with no description:

$ ri String.tr  
[no description]  
$ ri String.squeeze!  
[no description]

And so on. Not sure why… m.

---

<div class="post-metadata">

**Author:** ![miracleofmagick](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/m/71c47a/32.png) [@miracleofmagick](https://www.ruby-forum.com/u/miracleofmagick)\
**Post date:** [April 25, 2009, 12:38am UTC](https://www.ruby-forum.com/t/rdoc-2-4-2-released/163903/3 "2009-04-25T00:38:18Z")

</div>

On Apr 24, 2009, at 15:28 , Nobuyoshi N. wrote:

> Hi,
> 
> At Thu, 26 Mar 2009 08:20:47 +0900,  
> Eric H. wrote in [ruby-talk:332150]:
> 
> > rdoc version 2.4.2 has been released!
> 
> Any plan to update the bundled rdoc in the repository?

Yes. Eric and I both need to update the repo w/ stuff we’ve released. 😕

---

<div class="post-metadata">

**Author:** ![miracleofmagick](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/m/71c47a/32.png) [@miracleofmagick](https://www.ruby-forum.com/u/miracleofmagick)\
**Post date:** [April 25, 2009, 12:29am UTC](https://www.ruby-forum.com/t/rdoc-2-4-2-released/163903/4 "2009-04-25T00:29:32Z")

</div>

Hi,

At Thu, 26 Mar 2009 08:20:47 +0900,  
Eric H. wrote in [ruby-talk:332150]:

> rdoc version 2.4.2 has been released!

Any plan to update the bundled rdoc in the repository?

---

<div class="post-metadata">

**Author:** ![miracleofmagick](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/m/71c47a/32.png) [@miracleofmagick](https://www.ruby-forum.com/u/miracleofmagick)\
**Post date:** [April 25, 2009, 10:19am UTC](https://www.ruby-forum.com/t/rdoc-2-4-2-released/163903/5 "2009-04-25T10:19:13Z")

</div>

On Apr 24, 2009, at 18:04 , Nobuyoshi N. wrote:

> - base = File.join(RbConfig::CONFIG[‘datadir’], “ri”, VERSION)
> 
> - pre, post = RbConfig::CONFIG[‘RUBY\_INSTALL\_NAME’].split(/ruby/, 2)
> - ri = “#{pre||’’}ri#{post||’’}”
> - rdoc = “#{m[0]}rdoc#{m[1]}”

Hrm. Either ruby svn and rdoc svn have diverged, or something else is  
weird with this patch. For example, ‘m’ is not a local variable in  
this method, and there has been very little activity on the rdoc svn  
side. I’ll poke around, but I think I’m going to have to leave this to  
eric to merge. thanks for the heads up.

---

<div class="post-metadata">

**Author:** ![miracleofmagick](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/m/71c47a/32.png) [@miracleofmagick](https://www.ruby-forum.com/u/miracleofmagick)\
**Post date:** [April 25, 2009, 3:04am UTC](https://www.ruby-forum.com/t/rdoc-2-4-2-released/163903/6 "2009-04-25T03:04:28Z")

</div>

Hi,

At Sat, 25 Apr 2009 07:37:21 +0900,  
Ryan D. wrote in [ruby-talk:334956]:

> > > rdoc version 2.4.2 has been released!
> > 
> > Any plan to update the bundled rdoc in the repository?
> 
> Yes. Eric and I both need to update the repo w/ stuff we’ve released. 😕

FYI, there’re a couple of fixes, specific and non-specific to  
1.9, other than removing trailing spaces.

# Index: lib/rdoc/parser.rb

— lib/rdoc/parser.rb (revision 19930)  
+++ lib/rdoc/parser.rb (working copy)  
@@ -64,15 +64,9 @@ class RDoc::Parser # r20986, r23071

## 

- 
# Shamelessly stolen from the ptools gem (since RDoc cannot depend on
- 
# the gem).

- 
# Return _true_ if the +file+ seems like binary.

def self.binary?(file)

- s = (File.read(file, File.stat(file).blksize) || “”).split(//)
- 
- if s.size \> 0 then
- 

```
 ((s.size - s.grep(" ".."~").size) / s.size.to_f) > 0.30

```

- else
- 

```
 false

```

- end

- s = File.read(file, 1024)
- s.count("^ -~\t\r\n").fdiv(s.size) \> 0.3 || s.index("\x00") unless  
s.empty?  
end  
private\_class\_method :binary?  
Index: lib/rdoc/ri/paths.rb  
===================================================================  
— lib/rdoc/ri/paths.rb (revision 19930)  
+++ lib/rdoc/ri/paths.rb (working copy)  
@@ -29,4 +29,7 @@ module RDoc::RI::Paths # r23070  
VERSION = RbConfig::CONFIG[‘ruby\_version’]

- base = File.join(RbConfig::CONFIG[‘datadir’], “ri”, VERSION)

- pre, post = RbConfig::CONFIG[‘RUBY\_INSTALL\_NAME’].split(/ruby/, 2)
- ri = “#{pre||’’}ri#{post||’’}”
- rdoc = “#{m[0]}rdoc#{m[1]}”
- base = File.join(RbConfig::CONFIG[‘datadir’], ri, VERSION)  
SYSDIR = File.join(base, “system”)  
@@ -33,10 +36,4 @@ # r21312  
SITEDIR = File.join(base, “site”)

- homedir = ENV[‘HOME’] || ENV[‘USERPROFILE’] || ENV[‘HOMEPATH’]
- 
- if homedir then
- HOMEDIR = File.join(homedir, “.rdoc”)
- else
- HOMEDIR = nil
- end

- HOMEDIR = (File.expand\_path("~/.#{rdoc}") rescue nil)

- @output\_dir = File.join Dir.tmpdir,  
“test\_rdoc\_info\_formatting\_#{$$}”

- @output\_dir = File.join Dir.mktmpdir(“test\_rdoc\_”),  
“info\_formatting”  
@output\_file = File.join @output\_dir, ‘rdoc.texinfo’

@@ -21,5 +21,5 @@ class TestRDocInfoFormatting \< MiniTest:

def teardown

- 
# FileUtils.rm\_rf @output\_dir

- FileUtils.rm\_rf File.dirname(@output\_dir)  
end

# Index: test/rdoc/test\_rdoc\_markup\_to\_html\_crossref.rb

— test/rdoc/test\_rdoc\_markup\_to\_html\_crossref.rb (revision 19930)  
+++ test/rdoc/test\_rdoc\_markup\_to\_html\_crossref.rb (revision 23268)  
@@ -85,5 +85,10 @@ class TestRDocMarkupToHtmlCrossref \< Min # r22806  
result.gsub!(/\n/, " ")

- assert\_equal actual\_expected\_result, result

- begin
- 

```
 assert_equal actual_expected_result, result

```

- rescue MiniTest::Assertion =\> e
- 

```
 bt = caller(2)

```

- 

```
 raise e, [e.message, 

```

\*bt.grep(/\A#{Regexp.quote( **FILE** )}:/o)].join("\n"), bt

- end  
end