ruby / rdoc

RDoc produces HTML and online documentation for Ruby projects.
https://ruby.github.io/rdoc/
Other
844 stars 440 forks source link

6.5.0 fails to properly parse ruby-3.2.0 source directory #959

Open gromnitsky opened 1 year ago

gromnitsky commented 1 year ago
$ ruby -v
ruby 3.2.0 (2022-12-25 revision a528908271) [x86_64-linux]

$ gem install rdoc -v 6.5.0
$ gem install rdoc -v 6.4.0

$ wget https://cache.ruby-lang.org/pub/ruby/3.2/ruby-3.2.0.tar.gz
$ tar xf ruby-3.2.0.tar.gz
$ cd ruby-3.2.0

Then, testing with v6.5.0 yields:

$ rdoc _6.5.0_ -r -o 650
$ find 650 -type f | wc -l
81

which is obviously not quite right.

But with v6.4.0 everything seems to work fine:

$ rdoc _6.4.0_ -r -o 640
$ find 640 -type f | wc -l
11227
mfa777 commented 3 months ago

I can reproduce this issue.

Ruby version: 3.3.4

rdoc Version 6.4.0:

rdoc _6.4.0_ -o doc334
Parsing sources...
100% [952/952]  yjit.rb

Generating Darkfish format into ruby-3.3.4/doc334...

  Files:        952

  Classes:     1236 ( 295 undocumented)
  Modules:      227 (  71 undocumented)
  Constants:   2328 ( 606 undocumented)
  Attributes:  1448 ( 241 undocumented)
  Methods:    11061 (1583 undocumented)

  Total:      16300 (2796 undocumented)
   82.85% documented

  Elapsed: 42.2s

rdoc Version 6.7.0

rdoc -o doc334
Parsing sources...
100% [73/73]  doc/yjit/yjit_hacking.md

Generating Darkfish format into ruby-3.3.4/doc334...

  Files:      73

  Classes:     2 (0 undocumented)
  Modules:     2 (1 undocumented)
  Constants:   1 (0 undocumented)
  Attributes:  2 (0 undocumented)
  Methods:     7 (0 undocumented)

  Total:      14 (1 undocumented)
   92.86% documented

  Elapsed: 6.1s