suzanne.soy/racket
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

add note about find-executable-path' to subprocess', etc.

Browse Source
This commit is contained in:
Matthew Flatt 2012-05-16 09:23:36 -06:00
parent 65313a82a7
commit 3fbbf7cf94
1 changed files with 8 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
collects/scribblings/reference/subprocess.scrbl
View File

@ -28,9 +28,11 @@ Creates a new process in the underlying operating system to execute
@racket[process] from @racketmodname[racket/system]. @racket[process] from @racketmodname[racket/system].
The @racket[command] argument is a path to a program executable, and 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, 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 encoding (see @secref["encodings"]). On Windows, command-line
arguments are passed as strings, and bytes strings are converted using arguments are passed as strings, and bytes strings are converted using
UTF-8. UTF-8.
@ -344,7 +346,9 @@ function:
[(system* [command path-string?] [exact 'exact] [arg string?]) boolean?])]{ [(system* [command path-string?] [exact 'exact] [arg string?]) boolean?])]{
Like @racket[system], except that @racket[command] is a filename that 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 @racket[arg]s are the arguments. The executed file is passed the
specified string arguments (which must contain no nul specified string arguments (which must contain no nul
characters). characters).
@ -440,7 +444,7 @@ of a single process.}
[(process* [command path-string?] [exact 'exact] [arg string?]) list?])]{ [(process* [command path-string?] [exact 'exact] [arg string?]) list?])]{
Like @racket[process], except that @racket[command] is a filename that 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 Windows, as for @racket[system*], the first @racket[arg] can be
replaced with @racket['exact].} replaced with @racket['exact].}