normal	2014-09-26 05:18:22 +0900 (Fri, 26 Sep 2014)

  New Revision: 47713

  http://svn.ruby-lang.org/cgi-bin/viewvc.cgi?view=revision&revision=47713

  Log:
    man/ruby.1: document stack size env variables
    
    [Feature #10197]

  Modified files:
    trunk/ChangeLog
    trunk/man/ruby.1
Index: ChangeLog
===================================================================
--- ChangeLog	(revision 47712)
+++ ChangeLog	(revision 47713)
@@ -1,3 +1,8 @@ https://github.com/ruby/ruby/blob/trunk/ChangeLog#L1
+Fri Sep 26 05:12:10 2014  Eric Wong  <e@8...>
+
+	* man/ruby.1: document stack size env variables
+	  [Feature #10197]
+
 Thu Sep 25 19:37:34 2014  Eric Wong  <e@8...>
 
 	* io.c (free_io_buffer): new function for a common pattern
Index: man/ruby.1
===================================================================
--- man/ruby.1	(revision 47712)
+++ man/ruby.1	(revision 47713)
@@ -482,6 +482,34 @@ as below. https://github.com/ruby/ruby/blob/trunk/man/ruby.1#L482
 % gem help
 .Ed
 .Pp
+.Sh STACK SIZE ENVIRONMENT
+Stack size environment variables are implementation-dependent and
+subject to change with different versions of Ruby.  The VM stack is used
+for pure-Ruby code and managed by the virtual machine.  Machine stack is
+used by the operating system and its usage is dependent on C extensions
+as well as C compiler options.  Using lower values for these may allow
+applications to keep more Fibers or Threads running; but increases the
+chance of SystemStackError exceptions and segmentation faults (SIGSEGV).
+These environment variables are available since Ruby 2.0.0.
+All values are specified in bytes.
+.Pp
+.Bl -hang -compact -width "RUBY_THREAD_MACHINE_STACK_SIZE"
+.It Ev RUBY_THREAD_VM_STACK_SIZE
+VM stack size used at thread creation.
+default: 131072 (32-bit CPU) or 262144 (64-bit)
+.Pp
+.It Ev RUBY_THREAD_MACHINE_STACK_SIZE
+Machine stack size used at thread creation.
+default: 524288 or 1048575
+.Pp
+.It Ev RUBY_FIBER_VM_STACK_SIZE
+VM stack size used at fiber creation.
+default: 65536 or 131072
+.Pp
+.It Ev RUBY_FIBER_MACHINE_STACK_SIZE
+Machine stack size used at fiber creation.
+default: 262144 or 524288
+.Pp
 .Sh SEE ALSO
 .Bl -hang -compact -width "http://www.ruby-lang.org/123"
 .It https://www.ruby-lang.org/

--
ML: ruby-changes@q...
Info: http://www.atdot.net/~ko1/quickml/