diff options
author | Benoit Daloze <eregontp@gmail.com> | 2019-12-14 12:16:58 +0100 |
---|---|---|
committer | Benoit Daloze <eregontp@gmail.com> | 2019-12-14 12:21:40 +0100 |
commit | b4b22b9278007b106fe40c0191f8dcf5e7e8c0f2 (patch) | |
tree | b94586c4e41bc6066c892c3fdf0d0875bdbabb31 /ast.rb | |
parent | 4cc83f9ac60d18ba330dc7f8e92eae1ffce67322 (diff) |
Clarify in the documentation that RubyVM::AbstractSyntaxTree is not stable API
* See [Feature #14844].
Diffstat (limited to 'ast.rb')
-rw-r--r-- | ast.rb | 10 |
1 files changed, 10 insertions, 0 deletions
@@ -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: |