ruby.git/lib/rdoc/parser, branch v3_4_9

Sync RDoc 6.14.0

2025-05-22T22:04:47+00:00

[ruby/rdoc] Fix to parse `rb_define_global_const`

2024-12-16T14:55:39+00:00

https://github.com/ruby/ruby/pull/12357

https://github.com/ruby/rdoc/commit/458ecbb7f7

[ruby/rdoc] Deprecate `main` and `title` directives

2024-12-05T11:36:34+00:00

(https://github.com/ruby/rdoc/pull/1218)

* Deprecate :main: directive

* Deprecate :title: direcive

* Update documentation

* Remove :main: directive's usage

* Update test cases

* Add '.rdoc_options' to suggested alternatives

https://github.com/ruby/rdoc/commit/e2d4ac9dad

Sync rdoc

2024-08-05T00:27:45+00:00

[ruby/rdoc] Add new ruby parser that uses Prism

2024-07-31T20:50:00+00:00

(https://github.com/ruby/rdoc/pull/1144)

* Add a new ruby parser RDoc::Parser::PrismRuby

* Add a new ruby parser testcase independent from parser's internal implementation

* unknown meta method

* Use MethodSignatureVisitor only to scan params, block_params and calls_super

* Add calls_super test

* Drop ruby 2.6. Prism requires ruby >= 2.7

* Remove duplicated documentation comment from prism_ruby.rb

* Add test for wrong argument passed to metaprogramming method

* Rename visit_call_[DSL_METHOD_NAME] to make it distinguishable from visit_[NODE_TYPE]_node

* Method receiver switch of true/false/nil to a case statement

* Extract common part of add_method(by def keyword) and add meta_comment method

* Reuse consecutive comments array when collecting comments

* Simplify DSL call_node handling

* Refactor extracting method visibility arguments

https://github.com/ruby/rdoc/commit/fde99f1be6

[ruby/rdoc] Improve rubocop setup

2024-07-17T20:43:08+00:00

(https://github.com/ruby/rdoc/pull/1139)

* Rename rake rubocop to rake format_generated_files

* Add rubocop rules to ensure spaces are applied consistently

* Improve rubocop related CI workflows

https://github.com/ruby/rdoc/commit/27932d001c

[ruby/rdoc] Drop reimplementation of Ripper lex state

2024-07-15T22:22:11+00:00

(https://github.com/ruby/rdoc/pull/1118)

* Drop reimplementation of Ripper lex state

This code was for ruby 2.4 compatibility, but rdoc dropped support for
ruby 2.4 about three years ago, in f480b970c.  This code was almost half
of the lines of code in rdoc/parser/ripper_state_lex.

* Remove unused Ripper constants and const_defined?

This was mostly copied from the diff in @st0012's PR comment.  The
remaining constants have been updated to get their value directly from
Ripper.

Co-authored-by: Stan Lo 

* Use Ripper::EXPR_LABEL directly

Since this is only used from outside RipperStateLex, there's no longer
any benefit to using the indirect reference rather than just going
straight to Ripper.

---------

https://github.com/ruby/rdoc/commit/dd8c216263

Co-authored-by: Stan Lo

[ruby/rdoc] Fix some typos (https://github.com/ruby/rdoc/pull/1129)

2024-07-01T02:08:37+00:00

* constist ==> consist

* Tidyness ==> Tidiness

* Currentry ==> Currently

* valus ==> values

https://github.com/ruby/rdoc/commit/8412705721

[ruby/rdoc] Don't document aliases with trailing `:nodoc` directive

2024-02-09T01:07:17+00:00

Attribute readers and writers can be marked as `:nodoc` to keep them
undocumented:

```ruby
attr_reader :name # :nodoc:
```

For aliases this behaviour should be the same:

```ruby
alias_method :old :new # :nodoc:
```

https://github.com/ruby/rdoc/commit/30f14e8271

[ruby/rdoc] Visibility should begin from `public` for each scope

2024-01-07T11:39:46+00:00

Even for singleton class definition such as `class << self` that
shares the same container with the outer scope, its visibility is
separated and set to `public` by default.

https://github.com/ruby/rdoc/commit/baf26363b9