From 05d84070e41f1f6d4922092d4c28b87b056ba246 Mon Sep 17 00:00:00 2001
From: nobu <nobu@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>
Date: Mon, 9 Nov 2009 23:23:23 +0000
Subject: * process.c (rb_f_exec, rb_f_system, rb_f_spawn): mentioned about  
 the shell to be used when the command line is single string.   See
 [ruby-core:26652]

git-svn-id: http://svn.ruby-lang.org/repos/ruby/trunk@25703 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
---
 process.c | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

(limited to 'process.c')

diff --git a/process.c b/process.c
index 3cd39c8a8..28b79b11c 100644
--- a/process.c
+++ b/process.c
@@ -1729,13 +1729,17 @@ rb_exec_arg_fixup(struct rb_exec_arg *e)
  *  Replaces the current process by running the given external _command_.
  *  _command..._ is one of following forms.
  *
- *    commandline                 : command line string which is passed to a shell
+ *    commandline                 : command line string which is passed to the standard shell
  *    cmdname, arg1, ...          : command name and one or more arguments (no shell)
  *    [cmdname, argv0], arg1, ... : command name, argv[0] and zero or more arguments (no shell)
  *
  *  If single string is given as the command,
  *  it is taken as a command line that is subject to shell expansion before being executed.
  *
+ *  The standard shell means always <code>"/bin/sh"</code> on Unix-like systems,
+ *  <code>ENV["RUBYSHELL"]</code> or <code>"cmd.exe"</code> on Windows NT series, and
+ *  similar.
+ *
  *  If two or more +string+ given,
  *  the first is taken as a command name and
  *  the rest are passed as parameters to command with no shell expansion.
@@ -2915,7 +2919,7 @@ rb_spawn(int argc, VALUE *argv)
  *  Executes _command..._ in a subshell.
  *  _command..._ is one of following forms.
  *
- *    commandline                 : command line string which is passed to a shell
+ *    commandline                 : command line string which is passed to the standard shell
  *    cmdname, arg1, ...          : command name and one or more arguments (no shell)
  *    [cmdname, argv0], arg1, ... : command name, argv[0] and zero or more arguments (no shell)
  *
@@ -2937,6 +2941,8 @@ rb_spawn(int argc, VALUE *argv)
  *
  *     config.h main.rb
  *     *
+ *
+ *  See <code>Kernel.exec</code> for the standard shell.
  */
 
 static VALUE
@@ -2992,7 +2998,7 @@ rb_f_system(int argc, VALUE *argv)
  *      name => val : set the environment variable
  *      name => nil : unset the environment variable
  *    command...:
- *      commandline                 : command line string which is passed to a shell
+ *      commandline                 : command line string which is passed to the standard shell
  *      cmdname, arg1, ...          : command name and one or more arguments (no shell)
  *      [cmdname, argv0], arg1, ... : command name, argv[0] and zero or more arguments (no shell)
  *    options: hash
@@ -3200,6 +3206,7 @@ rb_f_system(int argc, VALUE *argv)
  *  Internally, +spawn+ uses an extra file descriptor to resolve such cyclic
  *  file descriptor mapping.
  *
+ *  See <code>Kernel.exec</code> for the standard shell.
  */
 
 static VALUE
-- 
cgit