archive/ruby
1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2025-09-15 16:44:01 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

merge revision(s) 57352: [Backport #13132]

Browse source 
doc: improve documentation for Binding [ci skip]

	* remove explicit return from code examples
	* grammar fixes
	* other small fixes

	Patch by: Marcus Stollsteimer <sto.mar@web.de>

	[ruby-core:79082] [Bug #13132]

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/branches/ruby_2_3@58184 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
This commit is contained in:
nagachika 2017-03-27 17:35:38 +00:00
parent 909331e26e
commit e88d0b324b
2 changed files with 20 additions and 19 deletions
Download patch file Download diff file Expand all files Collapse all files

29
proc.c
View file

@ -335,7 +335,7 @@ rb_binding_new(void)
* environment. See also the description of class +Binding+. * environment. See also the description of class +Binding+.
* *
* def get_binding(param) * def get_binding(param)
* return binding * binding
* end * end
* b = get_binding("hello") * b = get_binding("hello")
* eval("param", b) #=> "hello" * eval("param", b) #=> "hello"
@ -357,7 +357,7 @@ rb_f_binding(VALUE self)
* reporting syntax errors. * reporting syntax errors.
* *
* def get_binding(param) * def get_binding(param)
* return binding * binding
* end * end
* b = get_binding("hello") * b = get_binding("hello")
* b.eval("param") #=> "hello" * b.eval("param") #=> "hello"
@ -431,7 +431,7 @@ check_local_id(VALUE bindval, volatile VALUE *pname)
* call-seq: * call-seq:
* binding.local_variables -> Array * binding.local_variables -> Array
* *
* Returns the +symbol+ names of the binding's local variables * Returns the names of the binding's local variables as symbols.
* *
* def foo * def foo
* a = 1 * a = 1
@ -440,7 +440,7 @@ check_local_id(VALUE bindval, volatile VALUE *pname)
* end * end
* end * end
* *
* This method is short version of the following code. * This method is the short version of the following code:
* *
* binding.eval("local_variables") * binding.eval("local_variables")
* *
@ -461,7 +461,7 @@ bind_local_variables(VALUE bindval)
* call-seq: * call-seq:
* binding.local_variable_get(symbol) -> obj * binding.local_variable_get(symbol) -> obj
* *
* Returns a +value+ of local variable +symbol+. * Returns the value of the local variable +symbol+.
* *
* def foo * def foo
* a = 1 * a = 1
@ -469,7 +469,7 @@ bind_local_variables(VALUE bindval)
* binding.local_variable_get(:b) #=> NameError * binding.local_variable_get(:b) #=> NameError
* end * end
* *
* This method is short version of the following code. * This method is the short version of the following code:
* *
* binding.eval("#{symbol}") * binding.eval("#{symbol}")
* *
@ -506,18 +506,19 @@ bind_local_variable_get(VALUE bindval, VALUE sym)
* bind = binding * bind = binding
* bind.local_variable_set(:a, 2) # set existing local variable `a' * bind.local_variable_set(:a, 2) # set existing local variable `a'
* bind.local_variable_set(:b, 3) # create new local variable `b' * bind.local_variable_set(:b, 3) # create new local variable `b'
* # `b' exists only in binding. * # `b' exists only in binding
*
* p bind.local_variable_get(:a) #=> 2 * p bind.local_variable_get(:a) #=> 2
* p bind.local_variable_get(:b) #=> 3 * p bind.local_variable_get(:b) #=> 3
* p a #=> 2 * p a #=> 2
* p b #=> NameError * p b #=> NameError
* end * end
* *
* This method is a similar behavior of the following code * This method behaves similarly to the following code:
* *
* binding.eval("#{symbol} = #{obj}") * binding.eval("#{symbol} = #{obj}")
* *
* if obj can be dumped in Ruby code. * if +obj+ can be dumped in Ruby code.
*/ */
static VALUE static VALUE
bind_local_variable_set(VALUE bindval, VALUE sym, VALUE val) bind_local_variable_set(VALUE bindval, VALUE sym, VALUE val)
@ -543,7 +544,7 @@ bind_local_variable_set(VALUE bindval, VALUE sym, VALUE val)
* call-seq: * call-seq:
* binding.local_variable_defined?(symbol) -> obj * binding.local_variable_defined?(symbol) -> obj
* *
* Returns a +true+ if a local variable +symbol+ exists. * Returns +true+ if a local variable +symbol+ exists.
* *
* def foo * def foo
* a = 1 * a = 1
@ -551,7 +552,7 @@ bind_local_variable_set(VALUE bindval, VALUE sym, VALUE val)
* binding.local_variable_defined?(:b) #=> false * binding.local_variable_defined?(:b) #=> false
* end * end
* *
* This method is short version of the following code. * This method is the short version of the following code:
* *
* binding.eval("defined?(#{symbol}) == 'local-variable'") * binding.eval("defined?(#{symbol}) == 'local-variable'")
* *
@ -1034,7 +1035,7 @@ iseq_location(const rb_iseq_t *iseq)
* prc.source_location -> [String, Fixnum] * prc.source_location -> [String, Fixnum]
* *
* Returns the Ruby source filename and line number containing this proc * Returns the Ruby source filename and line number containing this proc
* or +nil+ if this proc was not defined in Ruby (i.e. native) * or +nil+ if this proc was not defined in Ruby (i.e. native).
*/ */
VALUE VALUE
@ -2386,7 +2387,7 @@ rb_obj_method_location(VALUE obj, ID id)
* meth.source_location -> [String, Fixnum] * meth.source_location -> [String, Fixnum]
* *
* Returns the Ruby source filename and line number containing this method * Returns the Ruby source filename and line number containing this method
* or nil if this method was not defined in Ruby (i.e. native) * or nil if this method was not defined in Ruby (i.e. native).
*/ */
VALUE VALUE
@ -3016,7 +3017,7 @@ Init_Proc(void)
* @secret = n * @secret = n
* end * end
* def get_binding * def get_binding
* return binding() * binding
* end * end
* end * end
* *

2
version.h
View file

@ -1,6 +1,6 @@
#define RUBY_VERSION "2.3.3" #define RUBY_VERSION "2.3.3"
#define RUBY_RELEASE_DATE "2017-03-28" #define RUBY_RELEASE_DATE "2017-03-28"
#define RUBY_PATCHLEVEL 293 #define RUBY_PATCHLEVEL 294
#define RUBY_RELEASE_YEAR 2017 #define RUBY_RELEASE_YEAR 2017
#define RUBY_RELEASE_MONTH 3 #define RUBY_RELEASE_MONTH 3