1berry/ruby
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Clarify in the documentation that RubyVM::AbstractSyntaxTree is not stable API

Browse Source 
* See [Feature #14844].
This commit is contained in:
Benoit Daloze 2019-12-14 12:16:58 +01:00
parent 4cc83f9ac6
commit b4b22b9278
1 changed files with 10 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
ast.rb
View File

@ -9,6 +9,16 @@ class RubyVM
# This class is MRI specific as it exposes implementation details
# of the MRI abstract syntax tree.
#
# This class is experimental and its API is not stable, therefore it might
# change without notice. As examples, the order of children nodes is not
# guaranteed, the number of children nodes might change, there is no way to
# access children nodes by name, etc.
#
# If you are looking for a stable API or an API working under multiple Ruby
# implementations, consider using the +parser+ gem or Ripper. If you would
# like to make RubyVM::AbstractSyntaxTree stable, please join the discussion
# at https://bugs.ruby-lang.org/issues/14844.
#
module AbstractSyntaxTree
# call-seq: