From 3fbbf7cf943289779300c83214b25a64a4b0bedd Mon Sep 17 00:00:00 2001 From: Matthew Flatt Date: Wed, 16 May 2012 09:23:36 -0600 Subject: [PATCH] add note about `find-executable-path' to `subprocess', etc. --- collects/scribblings/reference/subprocess.scrbl | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/collects/scribblings/reference/subprocess.scrbl b/collects/scribblings/reference/subprocess.scrbl index c0e516ccfa..1154f6c8b9 100644 --- a/collects/scribblings/reference/subprocess.scrbl +++ b/collects/scribblings/reference/subprocess.scrbl @@ -28,9 +28,11 @@ Creates a new process in the underlying operating system to execute @racket[process] from @racketmodname[racket/system]. The @racket[command] argument is a path to a program executable, and -the @racket[arg]s are command-line arguments for the program. On +the @racket[arg]s are command-line arguments for the program. See +@racket[find-executable-path] for locating an executable based on +the @envvar{PATH} environment variable. On Unix and Mac OS X, command-line arguments are passed as byte strings, -and string @racket[args] are converted using the current locale's +and string @racket[arg]s are converted using the current locale's encoding (see @secref["encodings"]). On Windows, command-line arguments are passed as strings, and bytes strings are converted using UTF-8. @@ -344,7 +346,9 @@ function: [(system* [command path-string?] [exact 'exact] [arg string?]) boolean?])]{ Like @racket[system], except that @racket[command] is a filename that -is executed directly (instead of through a shell command), and the +is executed directly (instead of through a shell command; see +@racket[find-executable-path] for locating an executable based on +the @envvar{PATH} environment variable), and the @racket[arg]s are the arguments. The executed file is passed the specified string arguments (which must contain no nul characters). @@ -440,7 +444,7 @@ of a single process.} [(process* [command path-string?] [exact 'exact] [arg string?]) list?])]{ Like @racket[process], except that @racket[command] is a filename that -is executed directly, and the @racket[arg]s are the arguments. On +is executed directly like @racket[system*], and the @racket[arg]s are the arguments. On Windows, as for @racket[system*], the first @racket[arg] can be replaced with @racket['exact].}