1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2022-11-09 12:17:21 -05:00

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

* See [Feature #14844].
This commit is contained in:
Benoit Daloze 2019-12-14 12:16:58 +01:00
parent 4cc83f9ac6
commit b4b22b9278

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: