Skip to content

Conversation

@tompng
Copy link
Member

@tompng tompng commented Jan 24, 2026

Fixes #398, #782, #816, #1555, #885, #1373, #1553

Although generated HTML has huge difference, many many bugs are fixed with RDoc::Parser::PrismRuby parser.
Diffs are mostly: many bugfixes, crossrefs, trailing whitespaces in syntax highlight, and perhaps few new bugs.
Old parser can be used with RDOC_USE_RIPPER_PARSER=1

@tompng tompng deployed to fork-preview-protection January 24, 2026 20:43 — with GitHub Actions Active
@matzbot
Copy link
Collaborator

matzbot commented Jan 24, 2026

🚀 Preview deployment available at: https://39dda6de.rdoc-6cd.pages.dev (commit: 2445ddc)

# Here is the <tt>:call-seq:</tt> directive given for this method:
#
# :call-seq:
# \:call-seq:
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

RDoc::Parser::Ruby specially handles :call-seq:.

# This is a call-seq
#   :call-seq: foo(x)
#
# This is a code block in RDoc::Parser::Ruby,
# but a second call-seq in RDoc::Prism::PrismRuby
#   :call-seq: foo(y)
#
# Code block in both parser
#   \:call-seq: foo(z)

def foo(*); end

Indented directives are allowed because indented :include: have special meaning.

# include a file with all lines indented
#   :include: file.rb

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

:stopdoc: can prevent indexing a class documented in another file

2 participants