222 Commits
Author SHA1 Message Date
Claude Fable 5 b3d3e01fdf [DOC] Fix typos in doc/
- doc/language/options.md: preceeding -> preceding
- doc/maintainers.md: maintanance -> maintenance
- doc/syntax/layout.rdoc: enconding -> encoding (File.read keyword
  in the line-continuation example)
- doc/distribution/windows.md: followings are -> the following are
2026-07-23 12:08:57 +09:00
Jeremy Evans 815710fc27 [DOC] Update documentation of refinement super
Method lookup for refinement super starts with the next active
refinement at the super call site, excluding the current refinment,
if such a refinement exists. This has been the behavior since Ruby
2.7, and it is now confirmed to be the desired behavior.
2026-06-23 23:17:34 -07:00
Jeremy Evans a4c655e202 [DOC] Update refinement documentation
This removes the discussion of included modules in refinements,
since support for that was removed in Ruby 3.2.

This switches the method lookup description to be ancestor-based
instead of class-based, so it better reflects how the process
actually works.

Also discuss how super inside a refined module method is not allowed
if the method was called via super from a refinement method.
2026-05-15 17:14:01 -07:00
Stefan Friesel 40272b1de6 [DOC] Fix grammar issues in layout.rdoc
Correct grammatical errors in the layout documentation.
2026-05-14 00:48:58 +09:00
sato.kei 8cc42fcfc2 [DOC] Fix wrong hash key in calling_methods.rdoc example 2026-04-16 10:58:43 +09:00
Nobuyoshi Nakada 2856aa67df [DOC] State that an interpolated string in %W is not split
It is split statically at the parse time, not the whole string is
built then split.
2026-01-26 10:09:35 +09:00
Victor Shepelev d7d1109099 Describe base code layout rules (#15696)
* Describe base code layout rules

* Enhance optional keyword explanation

* Change the logical operators description
2025-12-23 19:09:41 +02:00
Victor Shepelev ec4ca91319 Small documentation adjustments for new/updated features (#15634)
* Document Range#to_set

* Update Thread#raise and Fiber#raise signatures and docs

* Add reference to String#strip to character_selectors.rdoc

* Update *nil docs when calling methods

* Enhance Array#find and #rfind docs

* Add a notice to Kernel#raise about cause:
2025-12-20 13:07:38 +02:00
Koichi Sasada 2aaea665bb fix typo s/sharable/shareable/ 2025-12-05 03:10:50 +09:00
Stan Lo 4cd6661e18 Reorganize page documentations (#15154)
Re-organize page docs
2025-11-27 20:12:24 +00:00
Sebastian Dufner a2c12d3ffe Documentation: Added the |(pipe)/OR operator to syntax/methods.
It was not documented as an operator that can be overriden, which is confusing because it makes you think it can't be.
2025-11-27 15:48:10 +09:00
Nobuyoshi Nakada fed528a995 [DOC] Remove the name from same file references 2025-11-23 17:56:11 +09:00
Earlopain d66b37e3d8 Remove alternation pattern matching handling from the prism compiler
Since https://github.com/ruby/ruby/pull/15212 these are proper syntax
errors, so no need to handle this explicitly anymore.

Also updated the example in the docs for this
2025-11-17 10:11:40 -05:00
Burdette Lamar 75d25a42e6 [DOC] Tweaks for String#to_c 2025-11-08 10:08:09 -05:00
Astra 7bc7246956 [DOC] Update refinements.rdoc
removes documentation for the activation order of `include` and `prepend` inside a refinement
2025-10-29 10:47:11 +09:00
Burdette Lamar 306df12949 [DOC] New .md file to replace doc/globals.rdoc 2025-08-11 22:02:59 -04:00
Masafumi Koba bbd5d3348b Fix tiny typo in syntax/exceptions.rdoc 2025-04-24 21:15:27 +09:00
Joshua Young 99503ab975 Escape Binding reference in pattern matching docs 2025-03-21 10:36:13 +09:00
Yutaro Ohno 482b5307f2 [DOC] Correct output in calling_methods.rdoc 2025-03-13 13:43:36 +09:00
Nobuyoshi Nakada e9593eb967 [DOC] Fix an error example
`%q{c}` after another string literal is parsed as RHS of modulo, `q`
method call with a block.
2025-01-07 09:56:54 +09:00
Earlopain 89c505dc47 Move string escape sequence documention further down
If someone looks at documention for strings,
I don't think escape sequences is what they look
for in majority of the cases.
2025-01-07 07:56:48 +09:00
Earlopain b0d291ec83 Fix link to strings in literals.rdoc
Since https://github.com/ruby/ruby/commit/5e1001f754b34e1f0cc67563512c6036b6eb75ab, the string link is broken

Instead of changing the anchor reference, I changed the header directly,
to keep in line with other titles
2025-01-07 07:56:48 +09:00
Nobuyoshi Nakada b4ec22fe6c [DOC] Exclude 'Method' from RDoc's autolinking 2025-01-02 12:23:49 +09:00
ydah b8fe5550e7 s/backslashs/backslashes/ 2024-12-22 18:09:02 +09:00
tomoya ishida 477c505ac0 [DOC] Fix output examples containing old Hash#inspect format
The inspect format was intentionally changed as an outcome of
[Bug #20433] [ruby-core:118668], but some documentation update
was missing, as [Bug #20962] pointed out. Update some output
examples that clearly use Hash#inspect.
2024-12-18 12:08:15 -05:00
Victor Shepelev 1ac28224e0 [DOC] Adjust argument unpacking docs and document **nil (#12228)
[DOC] Rewrite argument unpacking docs and document **nil
2024-12-15 21:53:39 +02:00
Nobuyoshi Nakada 1fd2437b63 [DOC] Move the comma outside the <tt> tag 2024-12-13 11:59:58 +09:00
masatoshi_moritsuka 6b46060fc2 doc: Remove description of experimental warnings related pattern matching from documentation
Ruby 3.2.0 has been released and all experimental warnings about pattern matching have been removed.
Experimental warnings about pattern matching are no longer output, so I remove description about it from documentation as well.

cf. https://bugs.ruby-lang.org/issues/18585
cf. db6b23c76c
cf. https://twitter.com/k_tsj/status/1606956336037900289?s=20&t=-_PSYLhYPtYsB9FZhtXl5A
2024-09-25 07:06:42 +09:00
BurdetteLamar 07a0aa9be6 [DOC] Fix link 2024-09-10 14:07:04 -04:00
Burdette Lamar f5579c9278 [DOC] Include keywords.rdoc in doc/syntax/ (#11414) 2024-08-21 12:06:48 -04:00
Tanaka Akira 5e1001f754 [DOC] document line continuation.
Document details of escape sequences including line continuation.

[Bug #20518]
2024-06-07 21:55:42 +09:00
Tanaka Akira 61af722d4e fix typos. 2024-06-03 14:37:32 +09:00
Tanaka Akira ca2170e69f [DOC] percent literals can be nested. 2024-06-03 12:24:55 +09:00
Nobuyoshi Nakada b911d2222f [Bug #20482] [DOC] Clarify about pattern maching guard clause
Guard clauses can only be used in `case` pattern matching statements,
not in `=>`/`in` operators.
2024-05-12 16:23:00 +09:00
crazeteam b2b665eba5 [DOC] remove repetitive words in comments
Signed-off-by: crazeteam <lilujing@outlook.com>
2024-03-27 07:52:18 +09:00
Pierre Merlin ec4333c970 [DOC] exceptions.rdoc : Add heads up about ensure not returning implicitly
There is a weird gotcha I already forgot twice.... and regret not to have found in doc.
See https://dev.to/okuramasafumi/be-sure-ensure-doesn-t-return-value-implicitly-8gp
2024-03-15 22:23:50 +09:00
ydah 926277bf82 s/ therefor/therefore/ 2024-02-15 17:01:02 +09:00
Peter Zhu be92bf4ff4 [DOC] Fix == and === in control_expressions.rdoc 2023-12-26 17:32:38 -05:00
Nobuyoshi Nakada c452fe17ac [Bug #20087] [DOC] Uninitialized instance variable is not warned now 2023-12-27 01:10:30 +09:00
Hiroshi SHIBATA c903cddf55 Typofix under doc directory 2023-12-25 11:17:51 +09:00
Doug Orleans 1822acdf33 [DOC] remove reference to pre-3.0 splat operator behavior 2023-12-19 22:11:11 +09:00
Kouhei Yanagita b84e6fe93e [DOC] Mention the omission of a superclass when reopening a class 2023-10-22 20:12:16 +09:00
Nicholas BrowningandNobuyoshi Nakada 53a373078d doc: initial operators commit
docs: expand on operator documentaion

Include more specific details around logical operators.

doc: update link with proper syntax

doc: remove ambiguous language from operators doc

doc: remove link to source code file

doc: cleaning up some language, and removing some mistakes in understanding

doc: revert example to prior state

doc: fix spacing

doc: Update doc/syntax/operators.rdoc

align example with typical format

Co-authored-by: Nobuyoshi Nakada <nobu@ruby-lang.org>

doc: Update doc/syntax/operators.rdoc

align format of other examples with rest of documentation

Co-authored-by: Nobuyoshi Nakada <nobu@ruby-lang.org>

Update doc/syntax/operators.rdoc

align format of other examples with rest of documentation

Co-authored-by: Nobuyoshi Nakada <nobu@ruby-lang.org>

doc: include `and` & `or` operators

doc(operators): remove accute language
2023-09-20 23:52:52 +09:00
Ivanov-Anton b89b7d8fdc [DOC] Fix a magic comment in the section for experimental_copy 2023-07-18 19:23:27 +09:00
Jemma Issroff 1272865a8e Fix broken wiki links (#8002)
Since [Misc #19679] migrated the wiki, these links should be updated
to their new locations.
2023-06-29 17:00:40 -04:00
Burdette Lamar 932dd9f10e [DOC] Regexp doc (#7923) 2023-06-20 09:28:21 -04:00
Jeremy Evans 618a04d211 Document throw/catch in the control expressions document [ci skip]
This are implemented as Kernel methods and not keywords, but I
still think they are worth documenting with the other control
flow expressions.
2023-05-26 07:58:40 -07:00
Nobuyoshi Nakadaandsawa e7342e76df [Bug #19485] [DOC] Mention tabs in indentation of heredoc identifier
Co-Authored-By: sawa (Tsuyoshi Sawada) <sawadatsuyoshi@gmail.com>
2023-03-19 18:10:55 +09:00
zverok ce0f3de032 [DOC] Update pattern matching docs for 3.2
* Remove section about experimental status
* Add references to core objects that can deconstruct
2023-02-19 22:32:52 +02:00
Kouhei Yanagita 619af4fd64 [DOC] Add an example of the splat operator with a non-array object (#7098) 2023-02-15 12:43:55 +09:00