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

"under <platform>" -> "on <platform>"; "X" -> "Unix"

Browse Source 
I originally picked "under" as the preposition to go before
 a platform name, but obviously you should build "on" a
 platform, and "under" suddenly annoys me. The choice of "on"
 is now codified in the documentation style guide. Meanwhile,
 "Unix" insted of "X" seems more clear and consistent in the
 `racket/gui' docs.

 More usefully, this patch also fixes a few out-of-date
 platform-specific claims.
This commit is contained in:
Matthew Flatt 2011-06-17 18:43:11 -06:00
parent 5a5800d513
commit f34a31cac9
86 changed files with 404 additions and 404 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
collects/browser/browser.scrbl
View File

@ -578,7 +578,7 @@ The @litchar{MZSCHEME} forms are disabled unless the web page is a
@defmodule[browser/external]
@defproc[(send-url [str null] [separate-window? void #t]) null]{
Like @net-send-url from @racket[net/sendurl], but under Unix, the user
Like @net-send-url from @racket[net/sendurl], but on Unix, the user
is prompted for a browser to use if none is recorded in the
preferences file.
}
@ -588,7 +588,7 @@ The @litchar{MZSCHEME} forms are disabled unless the web page is a
}
@defproc[(update-browser-preference [url (or/c string? false/c)]) void?]{
Under Unix, prompts the user for a browser preference and records the
On Unix, prompts the user for a browser preference and records the
user choice as a framework preference (even if one is already
recorded). If @racket[url] is not @racket[#f], it is used in the
dialog to explain which URL is to be opened; if it is @racket[#f], the

30
collects/dynext/dynext.scrbl
View File

@ -50,9 +50,9 @@ A parameter that determines the executable for the compiler.
The default is set by searching for an executable using the
@envvar{PATH} environment variable, or using the @envvar{CC} or
@envvar{MZSCHEME_DYNEXT_COMPILER} environment variable if either is
defined (and the latter takes precedence). Under windows, the search
defined (and the latter takes precedence). On Windows, the search
looks for @filepath{cl.exe}, then @filepath{gcc.exe}, then
@filepath{bcc32.exe} (Borland). Under Unix, it looks for
@filepath{bcc32.exe} (Borland). On Unix, it looks for
@filepath{gcc}, then @filepath{cc}. A @scheme[#f] value indicates that
no compiler could be found.}
@ -64,12 +64,12 @@ no compiler could be found.}
A parameter that determines strings passed to the compiler as flags.
See also @scheme[expand-for-compile-variant].
Under Windows, the default is @scheme[(list "/c" "/O2" "/MT"
On Windows, the default is @scheme[(list "/c" "/O2" "/MT"
_3m-flag-thunk)] for @filepath{cl.exe}, or @scheme[(list "-c" "-O2"
"-fPIC" _3m-flag-thunk)] for @filepath{gcc.exe} and
@filepath{bcc32.exe}, where @scheme[_3m-flag-thunk] returns
@scheme[(list "-DMZ_PRECISE_GC")] for the 3m variant and null for the
CGC variant. Under Unix, the default is usually @scheme[(list "-c"
CGC variant. On Unix, the default is usually @scheme[(list "-c"
"-O2" "-fPIC" _3m-flag-thunk)]. If the @envvar{CFLAGS} or
@envvar{MZSCHEME_DYNEXT_COMPILER_FLAGS} environment variable is
defined (the latter takes precedence), then its value is parsed as a
@ -84,9 +84,9 @@ A parameter the processes include-path inputs to the compiler; the
parameter values takes an include directory path and returns a list of
strings for the command line.
Under Windows, the default converts @scheme["dir"] to @scheme[(list
On Windows, the default converts @scheme["dir"] to @scheme[(list
"/Idir")] for @filepath{cl.exe}, @scheme[(list "-Idir")] for
@filepath{gcc.exe} and @filepath{bcc32.exe}. Under Unix, the default
@filepath{gcc.exe} and @filepath{bcc32.exe}. On Unix, the default
converts @scheme["dir"] to @scheme[(list "-Idir")]. If the
@envvar{CFLAGS} environment variable is defined, then its value is
parsed as a list of flags that is appended before the defaults.}
@ -109,9 +109,9 @@ A parameter that processes outputs specified for the compiler; the
parameter's value takes an output file path and returns a list of
strings for the command line.
Under Windows, the default converts @scheme["file"] to @scheme[(list
On Windows, the default converts @scheme["file"] to @scheme[(list
"/Fofile")] for @filepath{cl.exe}, or to @scheme[(list "-o" "file")]
for @filepath{gcc.exe} and @filepath{bcc32.exe}. Under Unix, the
for @filepath{gcc.exe} and @filepath{bcc32.exe}. On Unix, the
default converts @scheme["file"] to @scheme[(list "-o" "file")].}
@ -210,10 +210,10 @@ A parameter that determines the executable used as a linker.
The default is set by searching for an executable using the
@envvar{PATH} environment variable, or by using the @envvar{LD} or
@envvar{MZSCHEME_DYNEXT_LINKER} environment variable if it is defined
(and the latter takes precedence). Under Windows, it looks for
(and the latter takes precedence). On Windows, it looks for
@filepath{cl.exe}, then @filepath{ld.exe} (gcc), then
@filepath{ilink32.exe} (Borland). Under Cygwin, Solaris, FreeBSD 2.x,
or HP/UX, it looks for @filepath{ld}. Under other Unix variants, it
@filepath{ilink32.exe} (Borland). On Cygwin, Solaris, FreeBSD 2.x,
or HP/UX, it looks for @filepath{ld}. On other Unix variants, it
looks for @filepath{cc}. @scheme[#f] indicates that no linker could be
found.}
@ -224,9 +224,9 @@ found.}
A parameter that determines flags provided to the linker. See also
@scheme[expand-for-link-variant].
Under Windows, default is @scheme[(list "/LD")] for @filepath{cl.exe},
On Windows, default is @scheme[(list "/LD")] for @filepath{cl.exe},
@scheme[(list "--dll")] for @filepath{ld.exe}, and @scheme[(list
"/Tpd" "/c")] for @filepath{ilink32.exe}. Under Unix, the default
"/Tpd" "/c")] for @filepath{ilink32.exe}. On Unix, the default
varies greatly among platforms. If the @envvar{LDFLAGS} or
@envvar{MZSCHEME_DYNEXT_LINKER_FLAGS} (the latter takes precedence)
environment variable is defined, then its value is parsed as a list of
@ -248,10 +248,10 @@ A parameter that processes linker output arguments; the parameter
value takes an output file path and returns a list of strings for the
command line.
Under Windows, the default converts @scheme["file"] to @scheme[(list
On Windows, the default converts @scheme["file"] to @scheme[(list
"/Fefile")] for @filepath{cl.exe}, something like @scheme[(list "-e"
"_dll_entry@12" "-o" "file")] for @filepath{ld.exe}, and something
complex for @filepath{ilink32.exe}. Under Unix, the default converts
complex for @filepath{ilink32.exe}. On Unix, the default converts
@scheme["file"] to @scheme[(list "-o" "file")].}
@defparam[current-standard-link-libraries

2
collects/file/scribblings/gzip.scrbl
View File

@ -31,7 +31,7 @@ outputting the same format as the @exec{gzip} utility. The
the compressed stream. The @scheme[timestamp] number is also embedded
in the output stream, as the modification date of the original file
(in Unix seconds, as @scheme[file-or-directory-modify-seconds] would
report under Unix).}
report on Unix).}
@defproc[(deflate [in input-port?]

2
collects/frtime/doc.txt
View File

@ -209,7 +209,7 @@ numeric keypad; the right paddle moves with the mouse. The 'r' key
resets the score.
net-pong-*.ss : A networked version of the pong/air-hockey game.
Currently known to work under Linux. To play, open the client on one
Currently known to work on Linux. To play, open the client on one
machine and the server on another. Execute both (and require if
necessary, depending on language level). Evaluate (self) on each.
Results will be something like:

2
collects/games/scribblings/games.scrbl
View File

@ -7,7 +7,7 @@
@title{@bold{Games}: Fun Examples}
The @exec{PLT Games} executable (or @exec{plt-games} under Unix) lets
The @exec{PLT Games} executable (or @exec{plt-games} on Unix) lets
you select one of the games distributed by PLT or other games
installed as sub-collections of the @filepath{games} collection (see
@secref["new-games"]).

4
collects/graphics/graphics-posn-less-unit.rkt
View File

@ -1110,7 +1110,7 @@
(opt-lambda (filename [type 'unknown/mask])
(check 'draw-pixmap-posn
(andp path-string? file-exists?) filename "filename"
(lambda (x) (memq x '(gif xbm xpm bmp pict unknown unknown/mask gif/mask))) type "file type symbol")
(lambda (x) (memq x '(gif xbm xpm bmp unknown unknown/mask gif/mask))) type "file type symbol")
(let* ([bitmap (make-object mred:bitmap% filename type)])
(lambda (viewport)
(check 'draw-pixmap-posn
@ -1155,7 +1155,7 @@
(opt-lambda (filename [kind 'xpm])
(check 'save-pixmap
(andp path-string? (orp relative-path? absolute-path?)) filename "filename"
(lambda (x) (memq x '(xpm xbm bmp pict))) kind "file type symbol")
(lambda (x) (memq x '(xpm xbm bmp))) kind "file type symbol")
(let ([bm (viewport-bitmap viewport)])
(send bm save-file filename kind)))))

5
collects/graphics/scribblings/graphics.scrbl
View File

@ -508,7 +508,7 @@ The lower left of the string begins at @racket[p].}
@defproc[(((draw-pixmap-posn [file path-string?]
[type (one-of/c 'unknown 'unknown/mask
'gif 'gif/mask 'jpeg 'png 'png/mask
'xbm 'xpm 'bmp 'pict)
'xbm 'xpm 'bmp)
'unknown/mask])
[viewport viewport?])
[p posn?]
@ -521,8 +521,7 @@ The lower left of the string begins at @racket[p].}
Draws a pixmap into @racket[viewport] with its upper left corner at
position @racket[p]. If @racket[type] is @racket['unknown] or
@racket['unknown/mask], then the content of the file is examined to
determine the type. All formats are supported on all platforms,
except @racket['pict] which is only supported under Mac OS X. The
determine the type. The
@racket['gif/mask], @racket['png/mask], and @racket['unknown/mask]
types draw the bitmap with a transparent background if
@racket[filename] refers to a GIF/PNG file with a transparent

7
collects/handin-server/scribblings/server-setup.scrbl
View File

@ -437,11 +437,8 @@ This directory contains the following files and sub-directories:
will be listed and accessible.}
]
The server can be run within either Racket or GRacket, but
@racketmodname[handin-server/utils] requires GRacket (which means that
@racket[checker] modules will likely require the server to run under
GRacket). Remember that if you're not using the (default) 3m garbage
collector you don't get memory accounting.
Remember that if you're not using the (default) 3m variant of Racket,
you don't get memory accounting.
The server currently provides no mechanism for a graceful shutdown,
but terminating the server is no worse than a network outage. (In

2
collects/make/make.scrbl
View File

@ -358,7 +358,7 @@ The arguments are as follows:
is a thunk. This procedure should invoke the thunk to make the
file, but it may add parameterizations before the final build. For
example, the @filepath{readline} installer used to add an
AIX-specific compile flag in this step when compiling under AIX.}
AIX-specific compile flag in this step when compiling on AIX.}
@item{@scheme[3m-too?]--- a boolean. If true, when the 3m variant is
installed, use the equivalent to @exec{raco ctool --xform} to transform

3
collects/mrlib/scribblings/gif.scrbl
View File

@ -45,8 +45,7 @@ images is collected and quantized at once, to produce a single
colortable; a drawback to this approach is that it uses more memory,
and it allows less color variation among animation frames. Even when
@scheme[one-at-a-time?] is @scheme[#f], the result of each thunk in
@scheme[bitmaps] is converted to a byte-string one at a time
(which helps avoid bitmap-count limits under Windows).
@scheme[bitmaps] is converted to a byte-string one at a time.
If @scheme[one-at-a-time?] is true, then the bitmaps are quantized and
written to the file one at a time; that is, for each thunk in

2
collects/mrlib/scribblings/path-dialog.scrbl
View File

@ -86,7 +86,7 @@ The @scheme[filters] argument is one of:
@item{@scheme[#f] --- no patterns and no filter input box.}
@item{@scheme[#t] --- use a generic @scheme["All"] filter, which is
@scheme["*.*"] under Windows and @scheme["*"] on other
@scheme["*.*"] on Windows and @scheme["*"] on other
platforms.}
]

4
collects/mzlib/scribblings/os.scrbl
View File

@ -24,8 +24,8 @@ Truncates or extends the given @scheme[file] so that it is
does not have sufficient privilege to truncate the file, the
@scheme[exn:fail] exception is raised.
@bold{WARNING:} under Unix, the implementation assumes that the
system's @scheme[ftruncate] function accepts a @tt{long long} second
@bold{WARNING:} on Unix, the implementation assumes that the
platform's @tt{ftruncate} function accepts a @tt{long long} second
argument.}

4
collects/net/scribblings/dns.scrbl
View File

@ -51,8 +51,8 @@ for @scheme["ollie.cs.rice.edu"] might be @scheme["cs.rice.edu"].}
@defproc[(dns-find-nameserver) (or/c string? false/c)]{
Attempts to find the address of a nameserver on the present system.
Under Unix, this procedure parses @filepath{/etc/resolv.conf} to
extract the first nameserver address. Under Windows, it runs
On Unix and Mac OS X, this procedure parses @filepath{/etc/resolv.conf} to
extract the first nameserver address. On Windows, it runs
@exec{nslookup.exe}.}
@; ----------------------------------------

8
collects/net/scribblings/sendurl.scrbl
View File

@ -22,14 +22,14 @@ manner. For some platforms and configurations, the
@scheme[separate-window?] parameter determines if the browser creates
a new window to display the URL or not.
Under Windows, @scheme[send-url] normally uses @scheme[shell-execute]
On Windows, @scheme[send-url] normally uses @scheme[shell-execute]
to launch a browser. (If the URL appears to contain a fragment, it may
use an intermediate redirecting file due to a bug in IE7.)
Under Mac OS X, @scheme[send-url] runs @exec{osascript} to start the
On Mac OS X, @scheme[send-url] runs @exec{osascript} to start the
user's chosen browser.
Under Unix, @scheme[send-url] uses a user-preference, or when none is
On Unix, @scheme[send-url] uses a user-preference, or when none is
set, it will look for a known browser. See the description of
@scheme[external-browser] for details.
@ -76,7 +76,7 @@ old temporary files are still deleted as described above.}
A parameter that can hold a procedure to override how a browser is
started, or @scheme[#f] to use the default platform-dependent command.
Under Unix, the command that is used depends on the
On Unix, the command that is used depends on the
@scheme['external-browser] preference. If the preference is unset,
@scheme[send-url] uses the first of the browsers from
@scheme[unix-browser-list] for which the executable is found.

2
collects/r5rs/r5rs.scrbl
View File

@ -83,7 +83,7 @@ Before starting a read-eval-print loop, an initialization file is
loaded, if it exists. The file is the same as the file reported by
@racket[(find-system-path 'init-file)], but with the characters
@litchar{racket} in the filename replaced by @litchar{pltr5rs}. For
example, under Unix, the file is @filepath{~/.pltr5rsrc}.
example, on Unix, the file is @filepath{~/.pltr5rsrc}.
By default, @exec{plt-r5rs} departs from @|r5rs| conformance in one
crucial way: the names of pre-defined functions cannot be redefined at

2
collects/readline/readline.scrbl
View File

@ -82,7 +82,7 @@ prompt; otherwise, it displays a prompt as determined by
Adds @racket[(require readline/rep)] to the result of
@racket[(find-system-path 'init-file)], which is
@filepath{~/.racketrc} under Unix. Consequently, @|readline| will be
@filepath{~/.racketrc} on Unix. Consequently, @|readline| will be
loaded whenever Racket is started in interactive mode. The
declaration is added only if it is not already present, as determined
by @racket[read]ing and checking all top-level expressions in the

4
collects/scribblings/draw/gl-context-intf.scrbl
View File

@ -9,8 +9,8 @@ A @scheme[gl-context<%>] object represents a context for drawing with
the target drawing context.
Only canvas @scheme[dc<%>] and @scheme[bitmap-dc%] objects containing
a bitmap from @racket[make-gl-bitmap] support OpenGL (always under
Windows and Mac OS X, sometimes under X). Normal @racket[dc<%>]
a bitmap from @racket[make-gl-bitmap] support OpenGL (always on
Windows and Mac OS X, sometimes on Unix). Normal @racket[dc<%>]
drawing and OpenGL drawing can be mixed in a @scheme[bitmap-dc%], but
a canvas that uses the @racket['gl] style to support OpenGL does not
reliably support normal @racket[dc<%>] drawing; use a bitmap if you

4
collects/scribblings/draw/libs.scrbl
View File

@ -3,13 +3,13 @@
@title[#:tag "libs"]{Platform Dependencies}
Under Windows and Mac OS X, the Racket distribution includes all
On Windows and Mac OS X, the Racket distribution includes all
necessary libraries that are not part of a stock installation of the
operating system, and the libraries are included in any distribution
created with @exec{raco distribute} (see @secref[#:doc '(lib
"scribblings/raco/raco.scrbl") "exe-dist"]).
Under Unix, the following system libraries must be installed. Numbers
On Unix, the following system libraries must be installed. Numbers
in square brackets indicate a version that is tried first, and if that
fails, the name without the version is tried.

2
collects/scribblings/draw/post-script-dc-class.scrbl
View File

@ -24,7 +24,7 @@ If @scheme[interactive] is true, the user is given a dialog for
setting printing parameters (see @scheme[get-ps-setup-from-user]);
the resulting configuration is installed as the current
configuration). If the user chooses to print to a file (the only
possibility under Windows and Mac OS X), another dialog is given to
possibility on Windows and Mac OS X), another dialog is given to
select the filename. If the user hits cancel in either of these
dialogs, then @method[dc<%> ok?] returns @scheme[#f].

13
collects/scribblings/draw/ps-setup-class.scrbl
View File

@ -34,8 +34,9 @@ filename unless @racket[copy-filename?] is true.
@defmethod[(get-command)
string?]{
Gets the printer command used to print a file in X. The default is
@scheme["lpr"]. This value is not used by other platforms.
Historically, gets the printer command used to print a file on
Unix. The default is @scheme["lpr"]. This value is not currently used
by any platforms.
}
@ -164,8 +165,8 @@ The translation is not scaled by the numbers returned from
@defmethod[(set-command [command string?])
void?]{
Sets the printer command used to print a file under X. See
@method[ps-setup% get-command].
Historically, sets the printer command that was used to print a file
on Unix. See @method[ps-setup% get-command].
}
@ -227,7 +228,7 @@ The margins are in unscaled @scheme[post-script-dc%] units, which
Sets the printing mode controlling where output is sent. See
@method[ps-setup% get-mode].
Under Windows and Mac OS X, if @scheme['preview] or @scheme['printer]
On Windows and Mac OS X, if @scheme['preview] or @scheme['printer]
is provided, @|MismatchExn|.
}
@ -250,7 +251,7 @@ Sets the name of the current paper type. See @method[ps-setup%
@defmethod[(set-preview-command [command string?])
void?]{
Sets the command used to view a PostScript file under X. See
Sets the command used to view a PostScript file on Unix. See
@method[ps-setup% get-preview-command].
}

20
collects/scribblings/drracket/files.scrbl
View File

@ -49,10 +49,10 @@ original file's name:
@itemize[
@item{Under Unix and Mac OS X, a @filepath{~} is added to the end of
@item{On Unix and Mac OS X, a @filepath{~} is added to the end of
the file's name.}
@item{Under Windows, the file's extension is replaced with
@item{On Windows, the file's extension is replaced with
@filepath{.bak}.}
]
@ -67,13 +67,13 @@ autosave file's name is generated from the original file's name:
@itemize[
@item{Under Unix and Mac OS X, a @filepath{#} is added to the start
@item{On Unix and Mac OS X, a @filepath{#} is added to the start
and end of the file's name, then a number is added after the
ending @filepath{#}, and then one more @filepath{#} is appended
after the number. The number is selected to make the autosave
filename unique.}
@item{Under Windows, the file's extension is replaced with a number
@item{On Windows, the file's extension is replaced with a number
to make the autosave filename unique.}
]
@ -96,27 +96,27 @@ depends on the platform and user:
@itemize[
@item{Under Unix, preferences are stored in a
@item{On Unix, preferences are stored in a
@indexed-file{.racket} subdirectory in the user's home
directory, in a file @indexed-file{racket-prefs.rktd}.}
@item{Under Windows, preferences are stored in a file
@item{On Windows, preferences are stored in a file
@indexed-file{racket-prefs.rktd} in a sub-directory
@indexed-file{Racket} in the user's application-data folder as
specified by the Windows registry; the application-data folder is
usually @indexed-file{Application Data} in the user's profile
directory, and that directory is usually hidden in the Windows GUI.}
@item{Under Mac OS X, preferences are stored in
@item{On Mac OS X, preferences are stored in
@indexed-file{org.racket-lang.prefs.rktd} in the user's preferences
folder.}
]
A lock file is used while modifying the preferences file, and it is
created in the same directory as the preferences file. Under Windows,
the lock file is named @indexed-file{_LOCKracket-prefs.rktd}; under Unix,
it is @indexed-file{.LOCK.racket-prefs.rktd}; under Mac OS X, it is
created in the same directory as the preferences file. On Windows,
the lock file is named @indexed-file{_LOCKracket-prefs.rktd}; on Unix,
it is @indexed-file{.LOCK.racket-prefs.rktd}; on Mac OS X, it is
@indexed-file{.LOCK.org.racket-lang.prefs.rktd}.
If the user-specific preferences file does not exist, and the file

6
collects/scribblings/drracket/interface-essentials.scrbl
View File

@ -118,7 +118,7 @@ annotations:
the context the macro is used in.
@index['("alpha renaming")]{Additionally}, right-clicking (or
Control-clicking under Mac OS X) on a variable activates a
Control-clicking on Mac OS X) on a variable activates a
pop-up menu that lets you jump from binding location to bound
location and vice versa, @as-index{@"\u03B1"-rename} the
variable, or tack the arrows so they do not disappear.}
@ -130,7 +130,7 @@ annotations:
expression.}
@item{@bold{Require Annotations:} Right-clicking (or
Control-clicking under Mac OS X) on the argument to
Control-clicking on Mac OS X) on the argument to
@racket[require] activates a pop-up menu that lets you open the
file that contains the @racket[require]d module.
@ -322,7 +322,7 @@ separate tabs} causes DrRacket to open files in new tabs in the
frontmost window, rather than opening a new window for the file.
The key bindings Control-Pageup and Control-Pagedown move between
tabs. Under Mac OS X, Command-Shift-Left and Command-Shift-Right also
tabs. On Mac OS X, Command-Shift-Left and Command-Shift-Right also
move between tabs.
@; ----------------------------------------------------------------------

4
collects/scribblings/drracket/keybindings.scrbl
View File

@ -38,7 +38,7 @@ key. Depending on your keyboard, Meta may be called ``Left,''
``Right,'' or have a diamond symbol, but it's usually on the bottom
row next to the space bar. M-@nonterm{key} can also be performed as a
two-character sequence: first, strike and release the Escape key, then
strike @nonterm{key}. Under Windows and Mac OS X, Meta is only
strike @nonterm{key}. On Windows and Mac OS X, Meta is only
available through the Escape key.
DEL is the Delete key.
@ -49,7 +49,7 @@ On most keyboards, ``<'' and ``>'' are shifted characters. So, to
get M->, you actually have to type Meta-Shift->. That is, press and
hold down both the Meta and Shift keys, and then strike ``>''.
Under Windows, some of these keybindings are actually standard menu
On Windows, some of these keybindings are actually standard menu
items. Those keybindings will behave according to the menus, unless
the @onscreen{Enable keybindings in menus} preference is unchecked.

6
collects/scribblings/drracket/menus.scrbl
View File

@ -81,10 +81,10 @@
search are displayed in a separate window.}
@item{@defmenuitem{Close} Closes this DrRacket window. If this window
is the only open DrRacket window, then DrRacket quits, except under
is the only open DrRacket window, then DrRacket quits, except on
Mac OS X.}
@item{{@onscreen{Quit} or @onscreen{Exit}} Exits DrRacket. (Under Mac
@item{{@onscreen{Quit} or @onscreen{Exit}} Exits DrRacket. (On Mac
OS X, this menu item is in the Apple menu.)}
]
@ -167,7 +167,7 @@ case-sensitive and case-insensitive search.}
insertion point, using the manuals as a source of completions.}
@item{@defmenuitem{Preferences...} Opens the preferences dialog. See
@secref["prefs-explanation"]. (Under Mac OS X, this menu item is in
@secref["prefs-explanation"]. (On Mac OS X, this menu item is in
the Apple menu.)} ]
@; ----------------------------------------

2
collects/scribblings/drracket/prefs.scrbl
View File

@ -71,7 +71,7 @@ The @onscreen{Editing} panel consists of several sub-panels:
@item{@PrefItem{Treat command key as meta} --- If checked,
DrRacket will use the command key for some Emacs-like
keybindings, instead of using it for menu shortcuts. This
option is only available under Mac OS X.}
option is only available on Mac OS X.}
@item{@PrefItem{Color syntax interactively} --- If checked,
DrRacket colors your syntax as you type.}
@item{@PrefItem{Search using anchors} --- If checked, DrRacket's

2
collects/scribblings/foreign/types.scrbl
View File

@ -460,7 +460,7 @@ accessible through @scheme[saved-errno]. If @scheme[save-errno] is
@scheme['windows], then the value of
@as-index{@tt{GetLastError}}@tt{()} is saved for later use via
@scheme[saved-errno]; the @scheme['windows] option is available only
under Windows (on other platforms @scheme[saved-errno] will return
on Windows (on other platforms @scheme[saved-errno] will return
0). If @scheme[save-errno] is @scheme[#f], no error value is saved
automatically. The error-recording support provided by
@scheme[save-errno] is needed because the Racket runtime system

8
collects/scribblings/gui/button-class.scrbl
View File

@ -32,9 +32,9 @@ Creates a button with a string label, bitmap label, or both.
specifies the location of the image relative to the text on the button.
If @litchar{&} occurs in @scheme[label] (when @scheme[label] includes a
string), it is specially parsed; under Windows and X, the character
string), it is specially parsed; on Windows and Unix, the character
following @litchar{&} is underlined in the displayed control to
indicate a keyboard mnemonic. (Under Mac OS X, mnemonic underlines are
indicate a keyboard mnemonic. (On Mac OS X, mnemonic underlines are
not shown.) The underlined mnemonic character must be a letter or a
digit. The user can effectively click the button by typing the
mnemonic when the control's top-level-window contains the keyboard
@ -43,12 +43,12 @@ keyboard focus is currently in a control that handles normal
alphanumeric input. The @litchar{&} itself is removed from
@scheme[label] before it is displayed for the control; a @litchar{&&}
in @scheme[label] is converted to @litchar{&} (with no mnemonic
underlining). Under Mac OS X, a parenthesized mnemonic character is
underlining). On Mac OS X, a parenthesized mnemonic character is
removed (along with any surrounding space) before the label is
displayed, since a parenthesized mnemonic is often used for non-Roman
languages. Finally, any text after a tab character is removed on all
platforms. Mnemonic keyboard events are handled by
@method[top-level-window<%> on-traverse-char] (but not under Mac OS
@method[top-level-window<%> on-traverse-char] (but not on Mac OS
X).
The @scheme[callback] procedure is called (with the event type

4
collects/scribblings/gui/canvas-intf.scrbl
View File

@ -275,9 +275,9 @@ If the canvas was created with the @indexed-scheme['transparent] style,
@defmethod[(set-resize-corner [on? any/c])
void?]{
Under Mac OS X, enables or disables space for a resize tab at the
On Mac OS X, enables or disables space for a resize tab at the
canvas's lower-right corner when only one scrollbar is visible. This
method has no effect under Windows or X, and it has no effect when
method has no effect on Windows or Unix, and it has no effect when
both or no scrollbars are visible. The resize corner is disabled by
default, but it can be enabled when a canvas is created with the
@scheme['resize-corner] style.

2
collects/scribblings/gui/clipboard-client-class.scrbl
View File

@ -24,7 +24,7 @@ Creates a clipboard client that supports no data formats.
Adds a new data format name to the list supported by the clipboard
client.
The @scheme[format] string is typically four capital letters. (Under
The @scheme[format] string is typically four capital letters. (On
Mac OS X, only four characters for @scheme[format] are ever used.)
For example, @scheme["TEXT"] is the name of the UTF-8-encoded string
format. New format names can be used to communicate application- and

8
collects/scribblings/gui/clipboard-intf.scrbl
View File

@ -6,15 +6,15 @@
A single @scheme[clipboard<%>] object, @indexed-scheme[the-clipboard],
manages the content of the system-wide clipboard for cut and paste.
Under X, a second @scheme[clipboard<%>] object,
On Unix, a second @scheme[clipboard<%>] object,
@indexed-scheme[the-x-selection-clipboard], manages the content of the
system-wide X selection. If the @ResourceFirst{selectionAsClipboard}
system-wide X11 selection. If the @ResourceFirst{selectionAsClipboard}
preference (see @|mrprefsdiscuss|) is set to a non-zero true value,
however, then @scheme[the-clipboard] is always the same as
@scheme[the-x-selection-clipboard], and the system-wide X clipboard
@scheme[the-x-selection-clipboard], and the system-wide X11 clipboard
is not used.
Under Windows and Mac OS X, @scheme[the-x-selection-clipboard] is
On Windows and Mac OS X, @scheme[the-x-selection-clipboard] is
always the same as @scheme[the-clipboard].
Data can be entered into a clipboard in one of two ways: by setting

6
collects/scribblings/gui/dialog-class.scrbl
View File

@ -32,8 +32,8 @@ title bar. If the dialog's label is changed (see
@method[window<%> set-label]), the title bar is updated.
The @scheme[parent] argument can be @scheme[#f] or an existing
frame. Under Windows, if @scheme[parent] is an existing frame, the
new dialog is always on top of its parent. Under Windows and X, a
frame. On Windows, if @scheme[parent] is an existing frame, the
new dialog is always on top of its parent. On Windows and Unix, a
dialog is iconized when its parent is iconized.
If @scheme[parent] is @scheme[#f], then the eventspace for the new
@ -44,7 +44,7 @@ If @scheme[parent] is @scheme[#f], then the eventspace for the new
If the @scheme[width] or @scheme[height] argument is not @scheme[#f],
it specifies an initial size for the dialog (in pixels) assuming that
it is larger than the minimum size, otherwise the minimum size is
used. Under Windows and Mac OS X (and with some X window managers)
used. On Windows and Mac OS X (and with some Unix window managers)
dialogs are not resizeable.
If the @scheme[x] or @scheme[y] argument is not @scheme[#f], it

22
collects/scribblings/gui/dialog-funcs.scrbl
View File

@ -45,7 +45,7 @@ Under Windows, if @scheme[extension] is not @scheme[#f], the returned path
The @scheme[style] list can contain @scheme['common], a
platform-independent version of the dialog is used instead of a
native dialog. Under Mac OS X, if the @scheme[style] list
native dialog. On Mac OS X, if the @scheme[style] list
contains @scheme['packages], a user is allowed to select a package
directory, which is a directory with a special suffix (e.g.,
``.app'') that the Finder normally displays like a file. If the list
@ -53,14 +53,14 @@ The @scheme[style] list can contain @scheme['common], a
within a package directory. If the list contains both
@scheme['packages] and @scheme['enter-packages], the former is ignored.
Under Windows and X, @scheme[filters] determines a set of filters from
On Windows and Unix, @scheme[filters] determines a set of filters from
which the user can choose in the dialog. Each element of the
@scheme[filters] list contains two strings: a description of the filter
as seen by the user, and a filter pattern matched against file names.
Pattern strings can be a simple ``glob'' pattern, or a number of glob
patterns separated by a @litchar[";"] character.
Under X, a @racket["*.*"] pattern is implicitly replaced with @racket["*"].
Under Mac OS X, suffix names are extracted from all globs that match a
On Unix, a @racket["*.*"] pattern is implicitly replaced with @racket["*"].
On Mac OS X, suffix names are extracted from all globs that match a
fixed suffix (e.g., two suffixes of @racket["foo"] and @racket["bar"]
are extracted from a @racket["*.foo;*.bar;*.baz*"] pattern), and files
that have any of these suffixes in any filter are selectable; a
@ -113,7 +113,7 @@ If @scheme[directory] is not @scheme[#f], it is used as the starting
when appropriate, and it should @italic{not} contain a directory path
prefix.
Under Windows, if @scheme[extension] is not @scheme[#f], the returned path
On Windows, if @scheme[extension] is not @scheme[#f], the returned path
will get a default extension if the user does not supply one. If
@scheme[extension] is the empty string, then the extension is derived
from the user's @scheme[filters] choice if the corresponding pattern is
@ -127,7 +127,7 @@ Under Windows, if @scheme[extension] is not @scheme[#f], the returned path
is @scheme[(string-append "*." extension)], then the result pathname is guaranteed
to have an extension mapping @scheme[extension].
Under Mac OS X 10.5 and later, if @scheme[extension] is not
On Mac OS X 10.5 and later, if @scheme[extension] is not
@scheme[#f] or @racket[""], the returned path will get a default extension if the
user does not supply one. If @scheme[filters] contains as
@scheme["*.*"] pattern, then the user can supply any extension that
@ -139,13 +139,13 @@ Under Mac OS X 10.5 and later, if @scheme[extension] is not
"*." extension)], then the result pathname is guaranteed to have an
extension mapping @scheme[extension].
Under Mac OS X versions before 10.5, the returned path will get a
On Mac OS X versions before 10.5, the returned path will get a
default extension only if @scheme[extension] is not @scheme[#f],
@scheme[extension] is not @racket[""], and
@scheme[filters] contains only @scheme[(string-append "*."
extension)].
Under X, @racket[extension] is ignored, and @racket[filters] is used
On Unix, @racket[extension] is ignored, and @racket[filters] is used
to filter the visible list of files as in @racket[get-file].
The @scheme[style] list is treated as for @scheme[get-file].
@ -174,7 +174,7 @@ If @scheme[directory] is not @scheme[#f], it is used on some platforms as
The @scheme[style] argument is treated as for
@scheme[get-file], except that only @scheme['common] or @scheme['enter-packages] can be
specified. The latter
matters only under Mac OS X, where @scheme['enter-packages]
matters only on Mac OS X, where @scheme['enter-packages]
enables the user to select package directory or a directory within a
package. A package is a directory with a special suffix (e.g.,
``.app'') that the Finder normally displays like a file.
@ -273,7 +273,7 @@ If @scheme[style] does not include @scheme['number-order], the order of
@item{Button 1 is the normal action, and it is usually the default
button. For example, if the dialog has an @onscreen{OK} button, it is
this one. Under Windows, this button is leftmost; under X and Mac OS
this one. On Windows, this button is leftmost; on Unix and Mac OS
X, it is rightmost. (See also
@scheme[system-position-ok-before-cancel?].) Use this button for
dialogs that contain only one button.}
@ -282,7 +282,7 @@ If @scheme[style] does not include @scheme['number-order], the order of
@onscreen{Cancel} (even when the default action is to cancel, such as
when confirming a file replacement).}
@item{Button 3 tends to be separated from the other two (under
@item{Button 3 tends to be separated from the other two (on
Mac OS X, it is left-aligned in the dialog). Use this button only
for three-button dialogs.}

14
collects/scribblings/gui/editor-funcs.scrbl
View File

@ -134,7 +134,7 @@ The initializer takes a keymap object and returns nothing. The default
initializer chains the given keymap to an internal keymap that
implements standard text editor keyboard and mouse bindings for cut,
copy, paste, undo, and select-all. The right mouse button is mapped
to popup an edit menu when the button is released. Under X,
to popup an edit menu when the button is released. On Unix,
start-of-line (Ctl-A) and end-of-line (Ctl-E) are also mapped.
}
@ -142,13 +142,11 @@ The initializer takes a keymap object and returns nothing. The default
@defproc[(editor-set-x-selection-mode [on any/c])
void?]{
Under X Windows, editor selections conform to the X Windows selection
conventions instead of a clipboard-based convention. If @racket[on] is
@racket[#f], the behavior is switched to the clipboard-based convention
On Unix, editor selections conform to the X11 Windows selection
conventions. If @racket[on] is
@racket[#f], the behavior is switched exclusively to the clipboard-based convention
(where copy must be explicitly requested before a paste).
}
@defproc[(get-the-editor-data-class-list)
@ -174,7 +172,7 @@ Gets the snip class list instance for the current eventspace.
[(map-command-as-meta-key)
boolean?])]{
Determines the interpretation of @litchar{m:} for a @racket[keymap%]
mapping under Mac OS X. See also
mapping on Mac OS X. See also
@xmethod[keymap% map-function].
@ -182,7 +180,7 @@ First case:
If @racket[on?] is @racket[#t], @litchar{m:} corresponds to the Command key. If
@racket[on?] is @racket[#f], then @litchar{m:} corresponds to no key under Mac OS
@racket[on?] is @racket[#f], then @litchar{m:} corresponds to no key on Mac OS
X.

8
collects/scribblings/gui/editor-intf.scrbl
View File

@ -1087,7 +1087,7 @@ extension and/or contents; when saving a file, this is the same as
@item{@scheme['text] --- read/write a text file (@scheme[text%] only);
file writing uses the platform's text-mode conventions
(e.g., newlines as return--linefeed combinations under Windows) when
(e.g., newlines as return--linefeed combinations on Windows) when
not specifically disabled via @method[editor<%> use-file-text-mode]}
@item{@scheme['text-force-cr] --- read/write a text file
@ -1673,8 +1673,8 @@ See also @method[editor<%> get-paste-text-only].
@defmethod[(paste-x-selection [time exact-integer? 0])
void?]{
Like @method[editor<%> paste], but under X, uses the X selection
instead of the X clipboard.
Like @method[editor<%> paste], but on Unix, uses the X11 selection
instead of the clipboard.
See @|timediscuss| for a discussion of the @scheme[time] argument. If
@scheme[time] is outside the platform-specific range of times,
@ -1978,7 +1978,7 @@ The filename and format used to save the file can be retrieved with
See also @method[editor<%> on-save-file], @method[editor<%>
after-save-file], and @method[editor<%> can-save-file?].
Under Mac OS X, the file's type signature is set to @scheme["TEXT"]
On Mac OS X, the file's type signature is set to @scheme["TEXT"]
for a text-format file or @scheme["WXME"] for a standard-format
(binary) file.

10
collects/scribblings/gui/editor-overview.scrbl
View File

@ -503,7 +503,7 @@ The editor file format provides for adding extra global data in
conflict with any other header/footer record name in use, and no one
else should use these names. All names beginning with ``wx'' are
reserved for internal use. By tagging extra header and footer records
with a unique name, the file can be safely loaded under a system that
with a unique name, the file can be safely loaded in an installation that
does not support the records.}
@item{Derive a new class from the @scheme[text%] or
@ -577,8 +577,8 @@ Text can be extracted from an editor in either of two forms:
mapped to themselves, but more complicated @techlink{item}s can be
represented with a useful string determined by the @techlink{item}'s
snip. Newlines are mapped to platform-specific character sequences
(linefeed under X, carriage return under Mac OS X, and
linefeed-carriage return under Windows). This form is called
(linefeed on Unix and Mac OS X, and
linefeed--carriage return on Windows). This form is called
``flattened'' because the editor's @techlink{item}s have been reduced
to a linear sequence of characters.}
@ -637,7 +637,7 @@ Methods of @scheme[editor<%>] that use the clipboard --- including
paste], and @method[editor<%> do-edit-operation] --- consume a time
stamp argument. This time stamp is generally extracted from the
@scheme[mouse-event%] or @scheme[key-event%] object that triggered
the clipboard action. X uses the time stamp to synchronize clipboard
the clipboard action. Unix uses the time stamp to synchronize clipboard
operations among the clipboard clients.
All instances of @scheme[event%] include a time stamp, which can be
@ -645,7 +645,7 @@ All instances of @scheme[event%] include a time stamp, which can be
If the time stamp is 0, it defaults to the current time. Using 0 as the
time stamp almost always works fine, but it is considered bad manners
under X.
on Unix.
@section[#:tag "editorclickback"]{Clickbacks}

2
collects/scribblings/gui/eventspace-funcs.scrbl
View File

@ -63,7 +63,7 @@ result event is ready when @racket[(yield)] for the eventspace
@defproc[(check-for-break)
boolean?]{
Inspects the event queue of the current eventspace, searching for a
Shift-Ctl-C (X, Windows) or Cmd-. (Mac OS X) key combination. Returns
Shift-Ctl-C (Unix, Windows) or Cmd-. (Mac OS X) key combination. Returns
@scheme[#t] if such an event was found (and the event is dequeued) or
@scheme[#f] otherwise.

12
collects/scribblings/gui/font-funcs.scrbl
View File

@ -7,8 +7,8 @@
This font is the default for @scheme[popup-menu%] objects.
Under Mac OS X, this font is slightly larger than
@scheme[normal-control-font]. Under Windows and X, it is the same
On Mac OS X, this font is slightly larger than
@scheme[normal-control-font]. On Windows and Unix, it is the same
size as @scheme[normal-control-font].
}
@ -27,9 +27,9 @@ This font is the default for @scheme[group-box-panel%] objects, and it is
a suitable for controls in a floating window and other contexts that
need smaller controls.
Under Windows, this font is the same size as
On Windows, this font is the same size as
@scheme[normal-control-font], since the Windows control font is
already relatively small. Under X and Mac OS X, this font is slightly
already relatively small. On Unix and Mac OS X, this font is slightly
smaller than @scheme[normal-control-font].
@ -47,9 +47,9 @@ This font is for tiny controls, and it is smaller than
This font is the default for @scheme[list-box%] objects (but not
list box labels, which use @scheme[normal-control-font]).
Under Mac OS X, this font is slightly smaller than
On Mac OS X, this font is slightly smaller than
@scheme[normal-control-font], and slightly larger than
@scheme[small-control-font]. Under Windows and X, it is the same size
@scheme[small-control-font]. On Windows and Unix, it is the same size
as @scheme[normal-control-font].
}

36
collects/scribblings/gui/frame-class.scrbl
View File

@ -7,7 +7,7 @@ A frame is a top-level container window. It has a title bar (which
displays the frame's label), an optional menu bar, and an optional
status line.
Under Windows, both Multiple Document Interface (MDI) and Single
On Windows, both Multiple Document Interface (MDI) and Single
Document Interface (SDI) frames are supported.
@defconstructor[([label label-string?]
@ -36,10 +36,10 @@ bar. If the frame's label is changed (see @method[window<%>
set-label]), the title bar is updated.
The @scheme[parent] argument can be @scheme[#f] or an existing
frame. Under Windows, if @scheme[parent] is an existing frame,
frame. On Windows, if @scheme[parent] is an existing frame,
the new frame is always on top of its parent. Also, the
@scheme[parent] frame may be an MDI parent frame from a new MDI
child frame. Under Windows and X (for many window managers), a
child frame. On Windows and Unix (for many window managers), a
frame is iconized when its parent is iconized.
If @scheme[parent] is @scheme[#f], then the eventspace for the
@ -63,11 +63,11 @@ some platforms:
@itemize[
@item{@scheme['no-resize-border] --- omits the resizeable border
around the window (Windows, X) or grow box in the bottom right
around the window (Windows, Unix) or grow box in the bottom right
corner (Mac OS X)}
@item{@scheme['no-caption] --- omits the title bar for the frame
(Windows, Mac OS X, X)}
(Windows, Mac OS X, Unix)}
@item{@scheme['no-system-menu] --- omits the system menu
(Windows)}
@ -85,14 +85,14 @@ some platforms:
a call to @method[frame% on-toolbar-button-click]}
@item{@scheme['hide-menu-bar] --- hides the menu bar and dock when
the frame is active (Mac OS X) or asks the window manager to make
the frame fullscreen (X)}
the frame fullscreen (Unix)}
@item{@scheme['float] --- causes the frame to stay in front of all
other non-floating windows (Windows, Mac OS X, X); under Mac OS X, a floating frame
other non-floating windows (Windows, Mac OS X, Unix); on Mac OS X, a floating frame
shares the focus with an active non-floating frame; when this style
is combined with @scheme['no-caption], then showing the frame does
not cause the keyboard focus to shift to the window, and under X,
clicking the frame does not move the focus; under Windows, a floating
not cause the keyboard focus to shift to the window, and on Unix,
clicking the frame does not move the focus; on Windows, a floating
frame has no taskbar button}
@item{@scheme['metal] --- ignored (formerly supported for Mac OS X)}
@ -161,8 +161,8 @@ otherwise.
@defmethod[(is-maximized?)
boolean?]{
Under Windows and Mac OS X, returns @scheme[#t] if the frame is
maximized, @scheme[#f] otherwise. Under X, the result is always
On Windows and Mac OS X, returns @scheme[#t] if the frame is
maximized, @scheme[#f] otherwise. On Unix, the result is always
@scheme[#f].
}
@ -171,8 +171,8 @@ maximized, @scheme[#f] otherwise. Under X, the result is always
void?]{
@methspec{
Maximizes or restores the frame under Windows and Mac OS X; the
frame's show state is not affected. Under Windows, an iconized frame
Maximizes or restores the frame on Windows and Mac OS X; the
frame's show state is not affected. On Windows, an iconized frame
cannot be maximized or restored.
@MonitorMethod[@elem{A window's maximization} @elem{the user} @elem{@method[window<%> on-size]} @elem{size}]
@ -193,8 +193,8 @@ If @scheme[maximize?] is @scheme[#f], the window is restored, otherwise
void?])]{
Gets or sets the frame's modification state as reflected to the user.
Under Mac OS X, the modification state is reflected as a dot in the
frame's close button. Under Windows and X, the modification state is
On Mac OS X, the modification state is reflected as a dot in the
frame's close button. On Windows and Unix, the modification state is
reflected by an asterisk at the end of the frame's displayed title.
}
@ -202,7 +202,7 @@ Gets or sets the frame's modification state as reflected to the user.
@defmethod[(on-mdi-activate [active? any/c])
void?]{
Called under Windows when a MDI-child frame becomes the active frame
Called on Windows when a MDI-child frame becomes the active frame
within its parent (in which case the argument is @scheme[#t]), or when
the child frame ceases to be the active frame (in which case the
argument is @scheme[#f]).
@ -254,7 +254,7 @@ Returns the result of
@defmethod[(on-toolbar-button-click)
void?]{
Under Mac OS X, called when the user clicks the toolbar button on a
On Mac OS X, called when the user clicks the toolbar button on a
frame created with the @indexed-scheme['toolbar-button] style.
}
@ -277,7 +277,7 @@ The icon is used in a platform-specific way:
@item{Mac OS X --- both icons are ignored.}
@item{X --- many window managers use the small icon in the same way
@item{Unix --- many window managers use the small icon in the same way
as Windows, and others use the small icon when iconifying the
frame; the large icon is ignored.}

12
collects/scribblings/gui/global-draw-funcs.scrbl
View File

@ -26,13 +26,13 @@ Returns the depth of the main display (a value of 1 denotes a monochrome display
When the optional argument is @scheme[#f] (the default), this function
returns the offset of the main screen's origin from the
top-left of the physical screen. Under X and Windows, the result is
always @scheme[0] and @scheme[0]; under Mac OS X, the result is
top-left of the physical screen. On Unix and Windows, the result is
always @scheme[0] and @scheme[0]; on Mac OS X, the result is
@scheme[0] and the height of the menu bar.
When the optional argument is true, this function returns the amount
space at the left and top of the main screen that is occupied by the
task bar (Windows) or menu bar and dock (Mac OS X). Under X, the
task bar (Windows) or menu bar and dock (Mac OS X). On Unix, the
result is always @scheme[0] and @scheme[0].
}
@ -41,11 +41,11 @@ When the optional argument is true, this function returns the amount
(values exact-nonnegative-integer? exact-nonnegative-integer?)]{
@index["screen resolution"]{Gets} the physical size of the display in
pixels. Under Windows, this size does not include the task bar by
default. Under Mac OS X, this size does not include the menu bar or
pixels. On Windows, this size does not include the task bar by
default. On Mac OS X, this size does not include the menu bar or
dock area by default.
Under Windows and Mac OS X, if the optional argument is true, then
On Windows and Mac OS X, if the optional argument is true, then
the task bar, menu bar, and dock area are included in the result.
Returns the screen's width and height.

6
collects/scribblings/gui/grow-box-spacer-pane-class.scrbl
View File

@ -5,10 +5,10 @@
A @scheme[grow-box-spacer-pane%] object is intended for use as a
lightweight spacer in the bottom-right corner of a frame, rather than
as a container. Under Mac OS X, a
as a container. On Mac OS X, a
@scheme[grow-box-spacer-pane%] has the same width and height as the
grow box that is inset into the bottom-right corner of a frame. Under
Windows and X, a @scheme[grow-box-spacer-pane%] has zero width and
grow box that is inset into the bottom-right corner of a frame. On
Windows and Unix, a @scheme[grow-box-spacer-pane%] has zero width and
height. Unlike all other container types, a
@scheme[grow-box-spacer-pane%] is unstretchable by default.

24
collects/scribblings/gui/key-event-class.scrbl
View File

@ -55,7 +55,7 @@ Returns @scheme[#t] if the Caps Lock key was on for the event.
boolean?]{
Returns @scheme[#t] if the Control key was down for the event.
Under Mac OS X, if a control-key press is combined with a mouse button
On Mac OS X, if a control-key press is combined with a mouse button
click, the event is reported as a right-button click and
@method[key-event% get-control-down] for the event reports @scheme[#f].
@ -172,13 +172,13 @@ A @scheme['wheel-up], @scheme['wheel-down], @scheme['wheel-left], or
events based on the location of the mouse pointer instead of the
keyboard focus.
Under Windows, when the Control key is pressed without Alt, the key
On Windows, when the Control key is pressed without Alt, the key
code for ASCII characters is downcased, roughly cancelling the effect
of the Shift key. Under Mac OS X, the key code is computed without
of the Shift key. On Mac OS X, the key code is computed without
Caps Lock effects when the Control or Command key is pressed; in the
case of Control, Caps Lock is used normally if special handling is
disabled for the Control key via @scheme[special-control-key]. Under
X, the key code is computed with Caps Lock effects when the Control
disabled for the Control key via @scheme[special-control-key]. On
Unix, the key code is computed with Caps Lock effects when the Control
key is pressed without Alt.
See also @method[key-event% get-other-shift-key-code].
@ -197,7 +197,7 @@ Gets the virtual key code for a key-release event; the result is
@defmethod[(get-meta-down)
boolean?]{
Returns @scheme[#t] if the Meta (X), Alt (Windows), or Command (Mac OS
Returns @scheme[#t] if the Meta (Unix), Alt (Windows), or Command (Mac OS
X) key was down for the event.
}
@ -236,7 +236,7 @@ Since keyboard mappings vary, it is sometimes useful in key mappings
The @method[key-event% get-other-altgr-key-code] method provides the
same information with respect to the AltGr key (i.e., Alt combined
with Control) under Windows and X, or the Option key under Mac OS
with Control) on Windows and Unix, or the Option key on Mac OS
X. The @method[key-event% get-other-shift-altgr-key-code] method
reports a mapping for in tha case that both Shift and AltGr/Option
were different from the actual event.
@ -252,10 +252,10 @@ result. (Caps Lock normally has either no effect or the same effect as
Shift, so further combinations involving Caps Lock and other modifier
keys would not normally produce further alternatives.)
Alternate mappings are not available for all events. Under Windows,
Alternate mappings are not available for all events. On Windows,
alternate mappings are reported when they produce ASCII letters,
ASCII digits, and ASCII symbols. Under Mac OS X, alternate mappings are
available only when the Command key is pressed. Under X, alternate
ASCII digits, and ASCII symbols. On Mac OS X, alternate mappings are
available only when the Command key is pressed. On Unix, alternate
mappings are usually available.
}
@ -304,7 +304,7 @@ Sets whether the Caps Lock key was on for the event.
Sets whether the Control key was down for the event.
Under Mac OS X, if a control-key press is combined with a mouse button
On Mac OS X, if a control-key press is combined with a mouse button
click, the event is reported as a right-button click and
@method[key-event% get-control-down] for the event reports
@scheme[#f].
@ -331,7 +331,7 @@ Sets the virtual key code for a release event, either a character or
@defmethod[(set-meta-down [down? any/c])
void?]{
Sets whether the Meta (X), Alt (Windows), or Command (Mac OS X) key
Sets whether the Meta (Unix), Alt (Windows), or Command (Mac OS X) key
was down for the event.
}

10
collects/scribblings/gui/keymap-class.scrbl
View File

@ -171,7 +171,7 @@ The modifier identifiers are:
@item{@litchar{a:} --- Mac OS X: Option}
@item{@litchar{m:} --- Windows: Alt; X: Meta; Mac OS X: Command, when
@item{@litchar{m:} --- Windows: Alt; Unix: Meta; Mac OS X: Command, when
@scheme[map-command-as-meta-key] produces @scheme[#t]}
@item{@litchar{d:} --- Mac OS X: Command}
@ -278,11 +278,11 @@ For a special keyword, the capitalization does not matter. However,
capitalization is important for single-letter keynames. Furthermore,
single-letter ASCII keynames are treated specially: @litchar{A} and
@litchar{s:a} are both treated as @litchar{s:A}. However, when
@litchar{c:} is included under Windows without @litchar{m:}, or when
@litchar{d:} is included under Mac OS X, then ASCII letters are not
@litchar{c:} is included on Windows without @litchar{m:}, or when
@litchar{d:} is included on Mac OS X, then ASCII letters are not
upcased with @litchar{s:}, since the upcasing behavior of the Shift key
is cancelled by Control without Alt (under Windows) or by Command
(under Mac OS X).
is cancelled by Control without Alt (on Windows) or by Command
(on Mac OS X).
A state can match multiple state strings mapped in a keymap (or keymap
chain); when a state matches multiple state strings, a mapping is

6
collects/scribblings/gui/labelled-menu-item-intf.scrbl
View File

@ -101,15 +101,15 @@ Sets the menu item's label. If the item has a shortcut, the shortcut
is not affected.
If the label contains @litchar{&} and the window is a control, the
label is parsed specially; under Windows and X, the character
label is parsed specially; on Windows and Unix, the character
following a @litchar{&} is underlined in the displayed menu to
indicate a keyboard mnemonic. Pressing the Alt key with an underlined
character from a menu's name in the menu bar causes the menu to be
selected (via @method[frame% on-menu-char]). When a menu has the
focus, the mnemonic characters are used for navigation without Alt. A
@litchar{&&} in the label is replaced by a literal (non-navigation)
@litchar{&}. Under Mac OS X, @litchar{&}s in the label are parsed in
the same way as for X and Windows, but no mnemonic underline is
@litchar{&}. On Mac OS X, @litchar{&}s in the label are parsed in
the same way as for Unix and Windows, but no mnemonic underline is
displayed.
A @litchar{&} is always preserved in the label returned by

2
collects/scribblings/gui/libs.scrbl
View File

@ -7,7 +7,7 @@
See @secref[#:doc draw-doc "libs"] in @other-manual[draw-doc] for
information on platform library dependencies for
@racketmodname[racket/draw]. Under Unix, the following additional
@racketmodname[racket/draw]. On Unix, the following additional
system libraries must be installed for @racketmodname[racket/gui/base]:
@itemlist[

4
collects/scribblings/gui/menu-class.scrbl
View File

@ -17,13 +17,13 @@ A @scheme[menu%] object is a submenu within a @scheme[menu%] or
Creates a new menu with the given label.
If @scheme[label] contains a @litchar{&}, it is handled specially;
under Windows, the character following a @litchar{&} is underlined in
on Windows, the character following a @litchar{&} is underlined in
the displayed menu title to indicate a keyboard mnemonic. Pressing
and releasing the Alt key switches to menu-selection mode in the menu
bar where mnemonic characters are used for navigation. An Alt
combination might select a specific menu via @method[frame%
on-menu-char]. A @litchar{&&} in @scheme[label] is replaced by a
literal (non-navigation) @litchar{&}ampersand. Under X and Mac OS X,
literal (non-navigation) @litchar{&}ampersand. On Unix and Mac OS X,
@litchar{&}s in the label are parsed in the same way as for Windows,
but no mnemonic underline is displayed.

22
collects/scribblings/gui/miscwin-funcs.scrbl
View File

@ -52,7 +52,7 @@ See @racket[begin-busy-cursor].
Gets or sets the creator and type of a file in Mac OS X.
The get operation always returns @racket[#"????"] and @racket[#"????"] for
Unix or Windows. The set operation has no effect under Unix or
Unix or Windows. The set operation has no effect on Unix or
Windows.
}
@ -80,8 +80,8 @@ The result depends on @racket[what], and a @racket[#f] result is only
]}
@item{@racket['x-display] returns a ``path'' whose string identifies
the X display if specified by either the @Flag{display} flag or the
@envvar{DISPLAY} environment variable when GRacket starts under X. For
the X11 display if specified by either the @Flag{display} flag or the
@envvar{DISPLAY} environment variable when GRacket starts on Unix. For
other platforms, or when neither @Flag{display} nor @envvar{DISPLAY}
was specified, the result is @racket[#f].}
@ -98,8 +98,8 @@ Returns an immutable list specifying the default prefix for menu
shortcuts. See also
@xmethod[selectable-menu-item<%> get-shortcut-prefix].
Under Windows, the default is @racket['(ctl)]. Under Mac OS X, the
default is @racket['(cmd)]. Under X, the default is normally
On Windows, the default is @racket['(ctl)]. On Mac OS X, the
default is @racket['(cmd)]. On Unix, the default is normally
@racket['(ctl)], but the default can be changed through the
@Resource{defaultMenuPrefix} low-level preference (see
@|mrprefsdiscuss|).}
@ -258,7 +258,7 @@ Creates a bitmap that draws in a way that is the same as drawing to a
canvas in its default configuration.
A normal @racket[bitmap%] draws in a more platform-independent way and
may use fewer constrained resources, particularly under Windows.}
may use fewer constrained resources, particularly on Windows.}
@defproc[(play-sound [filename path-string?]
@ -270,9 +270,9 @@ Plays a sound file. If @racket[async?] is false, the function does not
The result is @racket[#t] if the sound plays successfully, @racket[#f]
otherwise.
Under Windows, only @filepath{.wav} files are supported.
On Windows, only @filepath{.wav} files are supported.
Under X, the function invokes an external sound-playing program;
On Unix, the function invokes an external sound-playing program;
looking for a few known programs (@exec{aplay}, @exec{play},
@exec{esdplay}, @exec{sndfile-play}, @exec{audioplay}). In addition, a
play command can be defined through the @ResourceFirst{playcmd}
@ -286,7 +286,7 @@ Under X, the function invokes an external sound-playing program;
error code---in this case the last part of the error output is
shown.
Under Mac OS X, Quicktime is used to play sounds; most sound
On Mac OS X, Quicktime is used to play sounds; most sound
formats (.wav, .aiff, .mp3) are supported in recent versions of
Quicktime. In order to play .wav files, Quicktime 3.0 (compatible
with OS 7.5 and up) is required.}
@ -351,10 +351,10 @@ Unregisters all blit requests installed for @racket[canvas] with
@defproc[(system-position-ok-before-cancel?) boolean?]{
Returns @racket[#t] under Windows---indicating that a dialog with
Returns @racket[#t] on Windows---indicating that a dialog with
@onscreen{OK} and @onscreen{Cancel} buttons should place the
@onscreen{OK} button on to left of the @onscreen{Cancel} button---and
returns @racket[#f] under Mac OS X and X.}
returns @racket[#f] on Mac OS X and Unix.}
@defthing[the-clipboard (is-a?/c clipboard<%>)]{

16
collects/scribblings/gui/mouse-event-class.scrbl
View File

@ -134,7 +134,7 @@ Returns @scheme[#t] if the Caps Lock key was on for the event.
Returns @scheme[#t] if the Control key was down for the event.
Under Mac OS X, if a control-key press is combined with a mouse button
On Mac OS X, if a control-key press is combined with a mouse button
click, the event is reported as a right-button click and
@method[mouse-event% get-control-down] for the event reports
@scheme[#f].
@ -161,7 +161,7 @@ Returns @scheme[#t] if the left mouse button was down (but not pressed) during t
@defmethod[(get-meta-down)
boolean?]{
Returns @scheme[#t] if the Meta (X), Alt (Windows), or Command (Mac OS
Returns @scheme[#t] if the Meta (Unix), Alt (Windows), or Command (Mac OS
X) key was down for the event.
}
@ -170,7 +170,7 @@ Returns @scheme[#t] if the Meta (X), Alt (Windows), or Command (Mac OS
boolean?]{
Returns @scheme[#t] if the middle mouse button was down (but not
pressed) for the event. Under Mac OS X, a middle-button click is
pressed) for the event. On Mac OS X, a middle-button click is
impossible.
}
@ -179,7 +179,7 @@ Returns @scheme[#t] if the middle mouse button was down (but not
boolean?]{
Returns @scheme[#t] if the right mouse button was down (but not
pressed) for the event. Under Mac OS X, a control-click combination
pressed) for the event. On Mac OS X, a control-click combination
is treated as a right-button click.
}
@ -247,7 +247,7 @@ Sets whether the Caps Lock key was on for the event.
Sets whether the Control key was down for the event.
Under Mac OS X, if a control-key press is combined with a mouse button
On Mac OS X, if a control-key press is combined with a mouse button
click, the event is reported as a right-button click and
@method[mouse-event% get-control-down] for the event reports
@scheme[#f].
@ -275,7 +275,7 @@ the event.
@defmethod[(set-meta-down [down? any/c])
void?]{
Sets whether the Meta (X), Alt (Windows), or Command (Mac OS X) key
Sets whether the Meta (Unix), Alt (Windows), or Command (Mac OS X) key
was down for the event.
}
@ -284,7 +284,7 @@ Sets whether the Meta (X), Alt (Windows), or Command (Mac OS X) key
void?]{
Sets whether the middle mouse button was down (but not pressed) for
the event. Under Mac OS X, a middle-button click is impossible.
the event. On Mac OS X, a middle-button click is impossible.
}
@ -292,7 +292,7 @@ Sets whether the middle mouse button was down (but not pressed) for
void?]{
Sets whether the right mouse button was down (but not pressed) for the
event. Under Mac OS X, a control-click combination by the user is
event. On Mac OS X, a control-click combination by the user is
treated as a right-button click.
}

4
collects/scribblings/gui/pasteboard-class.scrbl
View File

@ -552,8 +552,8 @@ Pastes.
void?]{
@methspec{
Called to paste the current contents of the X selection under X (or
the clipboard under Windows and Mac OS X) into the editor. This
Called to paste the current contents of the X11 selection on Unix (or
the clipboard on Windows and Mac OS X) into the editor. This
method is provided so that it can be overridden by subclasses. Do
not call this method directly; instead, call @method[editor<%>
paste-x-selection].

2
collects/scribblings/gui/prefs.scrbl
View File

@ -25,7 +25,7 @@ The following are the preference names used by GRacket:
an editor.}
@item{@ResourceFirst{defaultMenuPrefix} --- sets the prefix used by
default for menu item shortcuts under X, one of @scheme['ctl],
default for menu item shortcuts on Unix, one of @scheme['ctl],
@scheme['meta], or @scheme['alt]. The default is
@scheme['ctl]. When this preference is set to @scheme['meta] or
@scheme['alt], underlined mnemonics (introduced by @litchar{&} in menu

6
collects/scribblings/gui/selectable-menu-item-intf.scrbl
View File

@ -51,13 +51,13 @@ Returns a list of symbols that indicates the keyboard prefix used for the menu
@itemize[
@item{@scheme['alt] --- Meta (Windows and X only)}
@item{@scheme['cmd] --- Command (Mac OS X only)}
@item{@scheme['meta] --- Meta (X only)}
@item{@scheme['meta] --- Meta (Unix only)}
@item{@scheme['ctl] --- Control}
@item{@scheme['shift] --- Shift}
@item{@scheme['option] --- Option (Mac OS X only)}
]
Under X, at most one of @scheme['alt] and @scheme['meta] can be
On Unix, at most one of @scheme['alt] and @scheme['meta] can be
supplied; the only difference between @scheme['alt] and
@scheme['meta] is the key combination's display in a menu.
@ -74,7 +74,7 @@ The shortcut key, as determined by @method[selectable-menu-item<%>
letters and digits, however, then the shortcut prefix merely
determines a minimum set of modifier keys, because additional
modifiers may be needed to access the character; an exception is
that, under Windows or X, the Alt/Meta key press must match the
that, on Windows or Unix, the Alt/Meta key press must match the
prefix exactly (i.e., included or not). In all cases, the most
precise match takes precedence; see @xmethod[keymap% map-function]
for more information on match ranking.

12
collects/scribblings/gui/system-menu-funcs.scrbl
View File

@ -13,7 +13,7 @@ Returns @scheme[#t] for Mac OS X when the current eventspace is the
This procedure is intended for use in deciding whether to include a
@onscreen{Quit}, @onscreen{About}, and @onscreen{Preferences} menu
item in a frame's menu. Under Mac OS X, the application
item in a frame's menu. On Mac OS X, the application
@onscreen{Quit} menu triggers a call to a frame's
@method[top-level-window<%> on-exit] method, the @onscreen{About} menu item is controlled by
@scheme[application-about-handler], and the
@ -41,7 +41,7 @@ This procedure is intended for use in deciding whether to create a
When the current eventspace is the initial eventspace, this
procedure retrieves or installs a thunk that is called when the
user selects the application @onscreen{About} menu item in Mac OS
user selects the application @onscreen{About} menu item on Mac OS
X. The thunk is always called in the initial eventspace's
handler thread (as a callback).
@ -59,7 +59,7 @@ or has no effect (when called with a handler).
void?])]{
When the current eventspace is the initial eventspace, this procedure
retrieves or installs a thunk that is called when the user selects
the application @onscreen{Preferences} menu item in Mac OS X. The
the application @onscreen{Preferences} menu item on Mac OS X. The
thunk is always called in the initial eventspace's handler thread (as
a callback). If the handler is set to @scheme[#f], the
@onscreen{Preferences} item is disabled.
@ -78,11 +78,11 @@ or has no effect (when called with a handler).
When the current eventspace is the initial eventspace, this procedure
retrieves or installs a thunk that is called when the user requests
that the application quit (e.g., through the @onscreen{Quit} menu
item in Mac OS X, or when shutting down the machine in Windows). The
item on Mac OS X, or when shutting down the machine in Windows). The
thunk is always called in the initial eventspace's handler thread (as
a callback). If the result of the thunk is @scheme[#f], then the
operating system is explicitly notified that the application does not
intend to quit (under Windows).
intend to quit (on Windows).
The default handler queues a call to the
@method[top-level-window<%> can-exit?] method of the most
@ -104,7 +104,7 @@ or has no effect (when called with a handler).
[(application-file-handler [handler-proc (path? . -> . any)])
void?])]{
When the current eventspace is the initial eventspace, this procedure
retrieves or installs a procedure that is called under Mac OS X
retrieves or installs a procedure that is called on Mac OS X
and Windows when the application is running and user double-clicks an
application-handled file or drags a file onto the application's
icon. The procedure is always called in the initial eventspace's

4
collects/scribblings/gui/text-class.scrbl
View File

@ -478,8 +478,8 @@ Pastes into the @techlink{position} @scheme[start].
void?]{
@methspec{
Called to paste the current contents of X selection under X (or the
clipboard under Windows or Mac OS X) into the editor. This method is
Called to paste the current contents of the X11 selection on Unix (or the
clipboard on Windows or Mac OS X) into the editor. This method is
provided so that it can be overridden by subclasses. Do not call
this method directly; instead, call @method[text% paste-x-selection].

18
collects/scribblings/gui/top-level-window-intf.scrbl
View File

@ -125,7 +125,7 @@ Called when a window is @defterm{activated} or
@defterm{deactivated}. A top-level window is activated when the
keyboard focus moves from outside the window to the window or one of
its children. It is deactivated when the focus moves back out of the
window. Under Mac OS X, a child of a floating frames can have the
window. On Mac OS X, a child of a floating frames can have the
focus instead of a child of the active non-floating frame; in other
words, floating frames act as an extension of the active non-frame
for keyboard focus.
@ -156,7 +156,7 @@ Called by the default application quit handler (as determined by the
@scheme[application-quit-handler] parameter) when the operating
system requests that the application shut down (e.g., when the
@onscreen{Quit} menu item is selected in the main application menu
under Mac OS X). In that case, this method is called for the most
on Mac OS X). In that case, this method is called for the most
recently active top-level window in the initial eventspace, but only
if the window's @method[top-level-window<%> can-exit?] method first
returns true.
@ -218,29 +218,29 @@ If the window that currently owns the focus specifically handles the
@item{@scheme[editor-canvas%] --- tab-exit is disabled (see
@method[editor-canvas% allow-tab-exit]): all keyboard events, except alphanumeric key events when the Meta
(X) or Alt (Windows) key is pressed; when tab-exit is enabled:
(Unix) or Alt (Windows) key is pressed; when tab-exit is enabled:
all keyboard events except Tab, Enter, Escape, and alphanumeric
Meta/Alt events.}
@item{@scheme[canvas%] --- when tab-focus is disabled (see
@method[canvas<%> accept-tab-focus]): all keyboard events, except alphanumeric key events when the Meta
(X) or Alt (Windows) key is pressed; when tab-focus is enabled:
(Unix) or Alt (Windows) key is pressed; when tab-focus is enabled:
no key events}
@item{@scheme[text-field%], @scheme['single] style --- arrow key
events and alphanumeric key events when the Meta (X) or Alt
(Windows) key is not pressed (and all alphanumeric events under
events and alphanumeric key events when the Meta (Unix) or Alt
(Windows) key is not pressed (and all alphanumeric events on
Mac OS X)}
@item{@scheme[text-field%], @scheme['multiple] style --- all
keyboard events, except alphanumeric key events when the Meta (X) or
keyboard events, except alphanumeric key events when the Meta (Unix) or
Alt (Windows) key is pressed}
@item{@scheme[choice%] --- arrow key events and alphanumeric key
events when the Meta (X) or Alt (Windows) key is not pressed}
events when the Meta (Unix) or Alt (Windows) key is not pressed}
@item{@scheme[list-box%] --- arrow key events and alphanumeric key
events when the Meta (X) or Alt (Windows) key is not pressed}
events when the Meta (Unix) or Alt (Windows) key is not pressed}
]}

6
collects/scribblings/gui/win-overview.scrbl
View File

@ -736,10 +736,10 @@ Controls, such as buttons and list boxes, handle keyboard and mouse
focus-navigation events. See @xmethod[frame% on-subwindow-char] and
@xmethod[dialog% on-subwindow-char] for details. Certain OS-specific
key combinations are captured at a low level, and cannot be
overridden. For example, under Windows and X, pressing and releasing
overridden. For example, on Windows and Unix, pressing and releasing
Alt always moves the keyboard focus to the menu bar. Similarly,
Alt-Tab switches to a different application under Windows. (Alt-Space
invokes the system menu under Windows, but this shortcut is
Alt-Tab switches to a different application on Windows. (Alt-Space
invokes the system menu on Windows, but this shortcut is
implemented by @method[top-level-window<%> on-system-menu-char],
which is called by @xmethod[frame% on-subwindow-char] and
@xmethod[dialog% on-subwindow-char].)

22
collects/scribblings/gui/window-intf.scrbl
View File

@ -37,7 +37,7 @@ All @scheme[window<%>] classes accept the following named instantiation
@index["global coordinates"]{Converts} local window coordinates to
screen coordinates.
Under Mac OS X, the screen coordinates start with @math{(0, 0)} at the
On Mac OS X, the screen coordinates start with @math{(0, 0)} at the
upper left of the menu bar. In contrast, @xmethod[top-level-window<%>
move] considers @math{(0, 0)} to be below the menu bar. See also
@scheme[get-display-left-top-inset].
@ -73,7 +73,7 @@ If @scheme[enable?] is true, the window is enabled, otherwise it is
See also
@method[window<%> on-focus].
Note that under X, keyboard focus can move to the menu bar
Note that on Unix, keyboard focus can move to the menu bar
when the user is selecting a menu item.
@MonitorMethod[@elem{The current keyboard focus window} @elem{the user} @elem{@method[window<%> on-focus]} @elem{focus}]
@ -93,7 +93,7 @@ on the platform:
@item{Mac OS X: @tt{NSView}}
@item{X: @tt{GtkWidget}}
@item{Unix: @tt{GtkWidget}}
]
@ -140,7 +140,7 @@ platform:
@item{Mac OS X: @tt{NSWindow} for a @scheme[top-level-window<%>] object,
@tt{NSView} for other windows}
@item{X: @tt{GtkWidget}}
@item{Unix: @tt{GtkWidget}}
]
@ -177,11 +177,11 @@ Gets a window's label, if any. Control windows generally display their
string label (along with a position for the bitmap).
A label string may contain @litchar{&}s, which serve as
keyboard navigation annotations for controls under Windows and X. The
keyboard navigation annotations for controls on Windows and Unix. The
ampersands are not part of the displayed label of a control; instead,
ampersands are removed in the displayed label (under all platforms),
ampersands are removed in the displayed label (on all platforms),
and any character preceding an ampersand is underlined (Windows and
X) indicating that the character is a mnemonic for the
Unix) indicating that the character is a mnemonic for the
control. Double ampersands are converted into a single ampersand
(with no displayed underline). See also
@method[top-level-window<%> on-traverse-char].
@ -207,7 +207,7 @@ Like
(integer-in 0 10000))]{
Gets the current size of the entire window in pixels, not counting
horizontal and vertical margins. (Under X, this size does not include
horizontal and vertical margins. (On Unix, this size does not include
a title bar or borders for a frame/dialog.) See also
@method[window<%> get-client-size].
@ -287,11 +287,11 @@ The result is @scheme[#t] if this window is shown when its ancestors are
void?]{
@index["drag-and-drop"]{Called} when the user drags a file onto the
window. (Under X, drag-and-drop is supported via the XDND
window. (On Unix, drag-and-drop is supported via the XDND
protocol.) Drag-and-drop must first be enabled for the window with
@method[window<%> accept-drop-files].
Under Mac OS X, when the application is running and user
On Mac OS X, when the application is running and user
double-clicks an application-handled file or drags a file onto the
application's icon, the main thread's application file handler is
called (see
@ -312,7 +312,7 @@ Under Mac OS X, when the application is running and user
receives or loses the keyboard focus. If the argument is @scheme[#t],
the keyboard focus was received, otherwise it was lost.
Note that under X, keyboard focus can move to the menu bar
Note that on Unix, keyboard focus can move to the menu bar
when the user is selecting a menu item.
}

8
collects/scribblings/guide/paths.scrbl
View File

@ -37,12 +37,8 @@ values, instead of strings.
Although it's sometimes tempting to directly manipulate strings that
represent filesystem paths, correctly manipulating a path can be
surprisingly difficult. For example, if you start under Unix with the
absolute path @filepath{/tmp/~} and take just the last part, you end up
with @filepath{~}---which looks like a reference to the current user's
home directory, instead of a relative path to a file of directory
named @filepath{~}. Windows path manipulation, furthermore, is far
trickier, because path elements like @filepath{aux} can have special
surprisingly difficult. Windows path manipulation is especially
tricky, because path elements like @filepath{aux} can have special
meanings.
@refdetails/gory["windows-path"]{Windows filesystem paths}

4
collects/scribblings/guide/scripts.scrbl
View File

@ -5,8 +5,8 @@
@title[#:tag "scripts"]{Scripts}
Racket files can be turned into executable scripts under Unix and Mac
OS X. Under Windows, a compatibility layer like Cygwin support the
Racket files can be turned into executable scripts on Unix and Mac
OS X. On Windows, a compatibility layer like Cygwin support the
same kind of scripts, or scripts can be implemented as batch files.
@section{Unix Scripts}

20
collects/scribblings/inside/memory.scrbl
View File

@ -51,14 +51,14 @@ The basic collector allocation functions are:
@item{@cppi{scheme_malloc_tagged} --- Allocates collectable memory
that contains a mixture of pointers and atomic data. With the
conservative collector, this function is the same
as @cppi{scheme_malloc}, but under 3m, the type tag stored at the
as @cppi{scheme_malloc}, but on 3m, the type tag stored at the
start of the block is used to determine the size and shape of the
object for future garbage collection (as described
in @secref["im:3m"]).}
@item{@cppi{scheme_malloc_allow_interior} --- Allocates an array of
pointers such that the array is never moved by the garbage collector
and references are allowed into the middle of the block under 3m (and
and references are allowed into the middle of the block on 3m (and
pointers to the middle prevent the block from being collected). Use
this procedure sparingly, because small, non-moving objects are
handled less efficiently than movable objects by the 3m collector.
@ -101,7 +101,7 @@ function can be safely called even when it's not needed, but it must
not be called multiple times for a single memory address.
Collectable memory can be temporarily locked from collection by using
the reference-counting function @cppi{scheme_dont_gc_ptr}. Under 3m,
the reference-counting function @cppi{scheme_dont_gc_ptr}. On 3m,
such locking does not prevent the object from being moved.
Garbage collection can occur during any call into Racket or its
@ -807,7 +807,7 @@ for CGC:
}
}
Under 3m, the above code does not quite work, because @var{stack_addr}
On 3m, the above code does not quite work, because @var{stack_addr}
must be the beginning or end of a local-frame registration. Worse, in
CGC or 3m, if @cpp{real_main} is declared @cpp{static}, the compiler
may inline it and place variables containing collectable values deeper
@ -829,8 +829,8 @@ requires a few frames.
If @var{stack_end} is @cpp{NULL}, then the stack end is computed
automatically: the stack size assumed to be the limit reported by
@cpp{getrlimit} under Unix and Mac OS X, or it is assumed to be 1 MB
under Windows; if this size is greater than 8 MB, then 8 MB is
@cpp{getrlimit} on Unix and Mac OS X, or it is assumed to be 1 MB
on Windows; if this size is greater than 8 MB, then 8 MB is
assumed, instead; the size is decremented by 50000 bytes to cover a
large margin of error; finally, the size is subtracted from (for
stacks that grow down) or added to (for stacks that grow up) the stack
@ -844,7 +844,7 @@ overflow.}
[void* ptr]
[int tls_index])]{
Only available under Windows; registers @var{ptr} as the address of a
Only available on Windows; registers @var{ptr} as the address of a
thread-local pointer variable that is declared in the main
executable. The variable's storage will be used to implement
thread-local storage within the Racket run-time. See
@ -1106,16 +1106,16 @@ foreign function to be called. The following protocols are supported:
@item{@racket['osapi_ptr_int->void] corresponds to @cpp{void
(*)(void*, int)}, but using the stdcall calling convention
under Windows.}
on Windows.}
@item{@racket['osapi_ptr_ptr->void] corresponds to @cpp{void
(*)(void*, void*)}, but using the stdcall calling convention
under Windows.}
on Windows.}
@item{@racket['osapi_ptr_int_int_int_int_ptr_int_int_long->void]
corresponds to @cpp{void (*)(void*, int, int, int, int, void*,
int, int, long)}, but using the stdcall calling convention
under Windows.}
on Windows.}
]

26
collects/scribblings/inside/overview.scrbl
View File

@ -186,7 +186,7 @@ As an example, the following C code defines an extension that returns
}
Assuming that this code is in the file @filepath{hw.c}, the extension
is compiled under Unix with the following two commands:
is compiled on Unix with the following two commands:
@commandline{raco ctool --cgc --cc hw.c}
@commandline{raco ctool --cgc --ld hw.so hw.o}
@ -223,7 +223,7 @@ must be extended as follows:
]
For a relatively simple extension @filepath{hw.c}, the extension is
compiled under Unix for 3m with the following three commands:
compiled on Unix for 3m with the following three commands:
@commandline{raco ctool --xform hw.c}
@commandline{raco ctool --3m --cc hw.3m.c}
@ -298,7 +298,7 @@ To embed Racket CGC in a program, follow these steps:
standard distribution provides 3m libraries, only, you will most
likely have to build from source.
Under Unix, the libraries are @as-index{@filepath{libracket.a}}
On Unix, the libraries are @as-index{@filepath{libracket.a}}
and @as-index{@filepath{libmzgc.a}} (or
@as-index{@filepath{libracket.so}} and
@as-index{@filepath{libmzgc.so}} for a dynamic-library build, with
@ -308,7 +308,7 @@ To embed Racket CGC in a program, follow these steps:
libraries into the installation's @filepath{lib} directory. Be sure
to build the CGC variant, since the default is 3m.
Under Windows, stub libraries for use with Microsoft tools are
On Windows, stub libraries for use with Microsoft tools are
@filepath{libracket@italic{x}.lib} and
@filepath{libmzgc@italic{x}.lib} (where @italic{x} represents the
version number) are in a compiler-specific directory in
@ -325,7 +325,7 @@ To embed Racket CGC in a program, follow these steps:
use. (@filepath{Racket.exe} and @filepath{GRacket.exe} use the latter
strategy.)
Under Mac OS X, dynamic libraries are provided by the
On Mac OS X, dynamic libraries are provided by the
@filepath{Racket} framework, which is typically installed in
@filepath{lib} sub-directory of the installation. Supply
@exec{-framework Racket} to @exec{gcc} when linking, along
@ -363,7 +363,7 @@ To embed Racket CGC in a program, follow these steps:
@cpp{scheme_main_stack_setup} trampoline registers the C stack with
the memory manager without creating a namespace.)
Under 32-bit Windows, when support for parallelism is enabled in the Racket
On 32-bit Windows, when support for parallelism is enabled in the Racket
build (as is the default), then before calling
@cpp{scheme_main_setup}, your embedding application must first call
@cppi{scheme_register_tls_space}:
@ -476,12 +476,12 @@ int main(int argc, char *argv[])
}
}
Under Mac OS X, or under Windows when Racket is compiled to a DLL
On Mac OS X, or on Windows when Racket is compiled to a DLL
using Cygwin, the garbage collector cannot find static variables
automatically. In that case, @cppi{scheme_main_setup} must be called with a
non-zero first argument.
Under Windows (for any other build mode), the garbage collector finds
On Windows (for any other build mode), the garbage collector finds
static variables in an embedding program by examining all memory
pages. This strategy fails if a program contains multiple Windows
threads; a page may get unmapped by a thread while the collector is
@ -516,21 +516,21 @@ In addition, some library details are different:
@itemize[
@item{Under Unix, the library is just
@item{On Unix, the library is just
@as-index{@filepath{libracket3m.a}} (or
@as-index{@filepath{libracket3m.so}} for a dynamic-library build,
with @as-index{@filepath{libracket3m.la}} for use with
@exec{libtool}). There is no separate library for 3m analogous to
CGC's @filepath{libmzgc.a}.}
@item{Under Windows, the stub library for use with Microsoft tools is
@item{On Windows, the stub library for use with Microsoft tools is
@filepath{libracket3m@italic{x}.lib} (where @italic{x} represents the
version number). This library identifies the bindings that are
provided by @filepath{libracket3m@italic{x}.dll}. There is no
separate library for 3m analogous to CGC's
@filepath{libmzgc@italic{x}.lib}.}
@item{Under Mac OS X, 3m dynamic libraries are provided by the
@item{On Mac OS X, 3m dynamic libraries are provided by the
@filepath{Racket} framework, just as for CGC, but as a version
suffixed with @filepath{_3m}.}
@ -642,8 +642,8 @@ for the original place.
Racket implements threads for Racket programs without aid from the
operating system, so that Racket threads are cooperative from the
perspective of C code. Under Unix, stand-alone Racket uses a single
OS-implemented thread. Under Windows and Mac OS X, stand-alone
perspective of C code. On Unix, stand-alone Racket uses a single
OS-implemented thread. On Windows and Mac OS X, stand-alone
Racket uses a few private OS-implemented threads for background
tasks, but these OS-implemented threads are never exposed by the
Racket API.

16
collects/scribblings/inside/ports.scrbl
View File

@ -335,7 +335,7 @@ Closes the given output port.}
Fills @cpp{*@var{fd}} with a file-descriptor value for @var{port} if
one is available (i.e., the port is a file-stream port and it is not
closed). The result is non-zero if the file-descriptor value is
available, zero otherwise. Under Windows, a ``file dscriptor'' is a
available, zero otherwise. On Windows, a ``file dscriptor'' is a
file @cpp{HANDLE}.}
@function[(intptr_t scheme_get_port_fd
@ -352,7 +352,7 @@ Like @cpp{scheme_get_port_file_descriptor}, but a file
Fills @cpp{*@var{s}} with a socket value for @var{port} if one is
available (i.e., the port is a TCP port and it is not closed). The
result is non-zero if the socket value is available, zero
otherwise. Under Windows, a socket value has type @cpp{SOCKET}.}
otherwise. On Windows, a socket value has type @cpp{SOCKET}.}
@function[(Scheme_Object* scheme_make_port_type
[char* name])]{
@ -512,7 +512,7 @@ The functions are as follows.
read, one for write, one for exceptions), but manipulate this
array using @cppi{scheme_get_fdset} to get a particular element of
the array, and use @cppi{MZ_FD_XXX} instead of @cpp{FD_XXX} to
manipulate a single ``@cpp{fd_set}''. Under Windows, the first
manipulate a single ``@cpp{fd_set}''. On Windows, the first
``@cpp{fd_set}'' can also contain OS-level semaphores or other
handles via @cpp{scheme_add_fd_handle}.}
}
@ -613,7 +613,7 @@ The functions are as follows.
read, one for write, one for exceptions), but manipulate this
array using @cppi{scheme_get_fdset} to get a particular element of
the array, and use @cppi{MZ_FD_XXX} instead of @cpp{FD_XXX} to
manipulate a single ``@cpp{fd_set}''. Under Windows, the first
manipulate a single ``@cpp{fd_set}''. On Windows, the first
``@cpp{fd_set}'' can also contain OS-level semaphores or other
handles via @cpp{scheme_add_fd_handle}.}
@ -730,7 +730,7 @@ Creates a Racket output file port from an ANSI C file pointer. The
[int regfile]
[int win_textmode])]{
Creates a Racket input port for a file descriptor @var{fd}. Under
Creates a Racket input port for a file descriptor @var{fd}. On
Windows, @var{fd} can be a @cpp{HANDLE} for a stream, and it should
never be a file descriptor from the C library or a WinSock socket.
@ -738,7 +738,7 @@ The @var{name} object is used for the port's name. Specify a non-zero
value for @var{regfile} only if the file descriptor corresponds to a
regular file (which implies that reading never blocks, for example).
Under Windows, @var{win_textmode} can be non-zero to make trigger
On Windows, @var{win_textmode} can be non-zero to make trigger
auto-conversion (at the byte level) of CRLF combinations to LF.
Closing the resulting port closes the file descriptor.
@ -756,7 +756,7 @@ Instead of calling both @cpp{scheme_make_fd_input_port} and
[int win_textmode]
[int read_too])]{
Creates a Racket output port for a file descriptor @var{fd}. Under
Creates a Racket output port for a file descriptor @var{fd}. On
Windows, @var{fd} can be a @cpp{HANDLE} for a stream, and it should
never be a file descriptor from the C library or a WinSock socket.
@ -764,7 +764,7 @@ The @var{name} object is used for the port's name. Specify a non-zero
value for @var{regfile} only if the file descriptor corresponds to a
regular file (which implies that reading never blocks, for example).
Under Windows, @var{win_textmode} can be non-zero to make trigger
On Windows, @var{win_textmode} can be non-zero to make trigger
auto-conversion (at the byte level) of CRLF combinations to LF.
Closing the resulting port closes the file descriptor.

8
collects/scribblings/inside/threads.scrbl
View File

@ -115,7 +115,7 @@ to run, block using @cppi{scheme_block_until}. This procedure takes
two functions: a polling function that tests whether the blocking
operation can be completed, and a prepare-to-sleep function that sets
bits in @cpp{fd_set}s when Racket decides to sleep (because all Racket
threads are blocked). Under Windows, an ``@cpp{fd_set}'' can also
threads are blocked). On Windows, an ``@cpp{fd_set}'' can also
accommodate OS-level semaphores or other handles via
@cpp{scheme_add_fd_handle}.
@ -495,7 +495,7 @@ If Racket decides to sleep, then the @var{fdf} function is called to
@cpp{fd_set}s: one or reading, one for writing, and one for
exceptions. Use @cpp{scheme_get_fdset} to get elements of this
array, and manipulate an ``@cpp{fd_set}'' with @cpp{MZ_FD_SET}
instead of @cpp{FD_SET}, etc. Under Windows, an ``@cpp{fd_set}'' can
instead of @cpp{FD_SET}, etc. On Windows, an ``@cpp{fd_set}'' can
also accommodate OS-level semaphores or other handles via
@cpp{scheme_add_fd_handle}.
@ -595,7 +595,7 @@ The @cpp{scheme_add_fd_handle} function is useful for implementing
the second procedure passed to @cpp{scheme_wait_until}, or for
implementing a custom input port.
Under Unix and Mac OS X, this function has no effect.}
On Unix and Mac OS X, this function has no effect.}
@function[(void scheme_add_fd_eventmask
@ -612,7 +612,7 @@ The event mask is only used when some handle is installed with
@cpp{scheme_add_fd_handle}. This awkward restriction may force you
to create a dummy semaphore that is never posted.
Under Unix, and Mac OS X, this function has no effect.}
On Unix, and Mac OS X, this function has no effect.}
@function[(void scheme_add_evt
[Scheme_Type type]

2
collects/scribblings/main/start.scrbl
View File

@ -10,7 +10,7 @@
@margin-note{
@not-on-the-web{
This is an installation-specific listing. Running @exec{raco docs}
(or @exec{Racket Documentation} under Windows or Mac OS X)
(or @exec{Racket Documentation} on Windows or Mac OS X)
may open a different page with local and user-specific
documentation, including documentation for installed
@link["http://planet.racket-lang.org/"]{@|PLaneT|} packages.}}

8
collects/scribblings/raco/bundle-api.scrbl
View File

@ -11,9 +11,9 @@
The @racketmodname[compiler/bundle-dist] library provides a function
to pack a directory (usually assembled by
@racket[assemble-distribution]) into a distribution file. Under
Windows, the result is a @filepath{.zip} archive; under Mac OS X, it's
a @filepath{.dmg} disk image; under Unix, it's a @filepath{.tgz}
@racket[assemble-distribution]) into a distribution file. On
Windows, the result is a @filepath{.zip} archive; on Mac OS X, it's
a @filepath{.dmg} disk image; on Unix, it's a @filepath{.tgz}
archive.}
@ -27,7 +27,7 @@ has no extension, a file extension is added automatcially (using the
first result of @racket[bundle-put-file-extension+style+filters]).
The created archive contains a directory with the same name as
@racket[dir]---except under Mac OS X when @racket[for-exe?] is true
@racket[dir]---except on Mac OS X when @racket[for-exe?] is true
and @racket[dir] contains a single a single file or directory, in
which case the created disk image contains just the file or
directory. The default for @racket[for-exe?] is @racket[#f].

8
collects/scribblings/raco/dist.scrbl
View File

@ -15,7 +15,7 @@ system.
After the @exec{raco distribute} command, supply a directory to
contain the combined files for a distribution. Each command-line
argument is an executable to include in the distribution, so multiple
executables can be packaged together. For example, under Windows,
executables can be packaged together. For example, on Windows,
@commandline{raco distribute greetings hello.exe goodbye.exe}
@ -31,11 +31,11 @@ platform-specific:
@itemize[
@item{Under Windows, executables are put directly into the
@item{On Windows, executables are put directly into the
distribution directory, and DLLs and other run-time files go
into a @filepath{lib} sub-directory.}
@item{Under Mac OS X, GUI executables go into the distribution
@item{On Mac OS X, GUI executables go into the distribution
directory, other executables go into a @filepath{bin}
subdirectory, and frameworks (i.e., shared libraries) go into a
@filepath{lib} sub-directory along with other run-time files. As
@ -43,7 +43,7 @@ platform-specific:
executable, then the @filepath{lib} directory is hidden inside
the application bundle.}
@item{Under Unix, executables go into a @filepath{bin} subdirectory,
@item{On Unix, executables go into a @filepath{bin} subdirectory,
shared libraries (if any) go into a @filepath{lib} subdirectory
along with other run-time files, and wrapped executables are
placed into a @filepath{lib/plt} subdirectory with

4
collects/scribblings/raco/exe-api.scrbl
View File

@ -95,7 +95,7 @@ parameter is true.
Copies the Racket (if @racket[gracket?] and @racket[mred?] are
@racket[#f]) or GRacket (otherwise) binary, embedding code into the
copied executable to be loaded on startup. Under Unix, the binary is
copied executable to be loaded on startup. On Unix, the binary is
actually a wrapper executable that execs the original; see also the
@racket['original-exe?] tag for @racket[aux].
@ -381,7 +381,7 @@ currently @racket[#f] for all platforms.}
boolean?]{
Indicates whether Racket/GRacket executables for the current platform
actually correspond to directories. The result is @racket[#t] under
actually correspond to directories. The result is @racket[#t] on
Mac OS X when @racket[mred?] is @racket[#t], @racket[#f] otherwise.}

2
collects/scribblings/raco/exe.scrbl
View File

@ -19,7 +19,7 @@ an executable produced by @exec{raco exe} will not improve performance
over @exec{raco make}.
The @exec{raco exe} command embeds a module, from source or byte
code, into a copy of the @exec{racket} executable. (Under Unix, the
code, into a copy of the @exec{racket} executable. (On Unix, the
embedding executable is actually a copy of a wrapper executable.) The
created executable invokes the embedded module on startup. The
@DFlag{gui} flag causes the program to be embedded in a copy of the

22
collects/scribblings/raco/launcher.scrbl
View File

@ -40,7 +40,7 @@ platform-specific options (i.e., it is a list of pairs where the first
element of the pair is a key symbol and the second element is the
value for that key). See also @racket[build-aux-from-path]. See
@racket[create-embedding-executable] for a list that applies to both
stand-alone executables and launchers under Windows and Mac OS X GRacket;
stand-alone executables and launchers on Windows and Mac OS X GRacket;
the following additional associations apply to launchers:
@itemize[
@ -76,7 +76,7 @@ argument) are then appended after the spliced @racket[args].}
[aux (listof (cons/c symbol? any/c)) null])
void?]{
Like @racket[make-gracket-launcher], but for starting Racket. Under Mac
Like @racket[make-gracket-launcher], but for starting Racket. On Mac
OS X, the @racket['exe-name] @racket[aux] association is ignored.}
@ -309,26 +309,26 @@ The recognized suffixes are as follows:
@itemize[
@item{@filepath{.icns} @'rarr @racket['icns] file for use under Mac
@item{@filepath{.icns} @'rarr @racket['icns] file for use on Mac
OS X}
@item{@filepath{.ico} @'rarr @racket['ico] file for use under
@item{@filepath{.ico} @'rarr @racket['ico] file for use on
Windows}
@item{@filepath{.lch} @'rarr @racket['independent?] as @racket[#t]
(the file content is ignored) for use under Windows}
(the file content is ignored) for use on Windows}
@item{@filepath{.creator} @'rarr @racket['creator] as the initial
four characters in the file for use under Mac OS X}
four characters in the file for use on Mac OS X}
@item{@filepath{.filetypes} @'rarr @racket['file-types] as
@racket[read] content (a single S-expression), and
@racket['resource-files] as a list constructed by finding
@racket["CFBundleTypeIconFile"] entries in @racket['file-types]
(and filtering duplicates); for use under Mac OS X}
(and filtering duplicates); for use on Mac OS X}
@item{@filepath{.utiexports} @'rarr @racket['uti-exports] as
@racket[read] content (a single S-expression); for use under
@racket[read] content (a single S-expression); for use on
Mac OS X}
]}
@ -337,8 +337,8 @@ The recognized suffixes are as follows:
A parameter that indicates a variant of Racket or GRacket to use for
launcher creation and for generating launcher names. The default is
the result of @racket[(system-type 'gc)]. Under Unix and Windows, the
possibilities are @racket['cgc] and @racket['3m]. Under Mac OS X, the
the result of @racket[(system-type 'gc)]. On Unix and Windows, the
possibilities are @racket['cgc] and @racket['3m]. On Mac OS X, the
@racket['script-3m] and @racket['script-cgc] variants are also
available for GRacket launchers.}
@ -348,7 +348,7 @@ Returns a list of symbols corresponding to available variants of GRacket
in the current Racket installation. The list normally includes at
least one of @racket['3m] or @racket['cgc]--- whichever is the result
of @racket[(system-type 'gc)]---and may include the other, as well as
@racket['script-3m] and/or @racket['script-cgc] under Mac OS X.}
@racket['script-3m] and/or @racket['script-cgc] on Mac OS X.}
@defproc[(available-racket-variants) (listof symbol?)]{

2
collects/scribblings/raco/setup.scrbl
View File

@ -985,7 +985,7 @@ An @deftech{unpackable} is one of the following:
@defproc[(find-dll-dir) (or/c path? false/c)]{
Returns a path to the directory that contains DLLs for use with the
current executable (e.g., @filepath{libmzsch.dll} under Windows).
current executable (e.g., @filepath{libmzsch.dll} on Windows).
The result is @racket[#f] if no such directory is available, or if no
specific directory is available (i.e., other than the platform's normal
search path).}

16
collects/scribblings/reference/bytes.scrbl
View File

@ -439,9 +439,9 @@ Certain encoding combinations are always available:
@secref["encodings"]).}
@item{@scheme[(bytes-open-converter "platform-UTF-8" "platform-UTF-16")]
--- converts UTF-8 to UTF-16 under @|AllUnix|, where each UTF-16
--- converts UTF-8 to UTF-16 on @|AllUnix|, where each UTF-16
code unit is a sequence of two bytes ordered by the current
platform's endianness. Under Windows, the input can include
platform's endianness. On Windows, the input can include
encodings that are not valid UTF-8, but which naturally extend the
UTF-8 encoding to support unpaired surrogate code units, and the
output is a sequence of UTF-16 code units (as little-endian byte
@ -450,15 +450,15 @@ Certain encoding combinations are always available:
@item{@scheme[(bytes-open-converter "platform-UTF-8-permissive" "platform-UTF-16")]
--- like @scheme[(bytes-open-converter "platform-UTF-8" "platform-UTF-16")],
but an input byte that is not part of a valid UTF-8 encoding
sequence (or valid for the unpaired-surrogate extension under
sequence (or valid for the unpaired-surrogate extension on
Windows) is effectively replaced with @scheme[(char->integer #\?)].}
@item{@scheme[(bytes-open-converter "platform-UTF-16" "platform-UTF-8")]
--- converts UTF-16 (bytes orderd by the current platform's
endianness) to UTF-8 under @|AllUnix|. Under Windows, the input can
endianness) to UTF-8 on @|AllUnix|. On Windows, the input can
include UTF-16 code units that are unpaired surrogates, and the
corresponding output includes an encoding of each surrogate in a
natural extension of UTF-8. Under @|AllUnix|, surrogates are
natural extension of UTF-8. On @|AllUnix|, surrogates are
assumed to be paired: a pair of bytes with the bits @scheme[#xD800]
starts a surrogate pair, and the @scheme[#x03FF] bits are used from
the pair and following pair (independent of the value of the
@ -471,8 +471,8 @@ A newly opened byte converter is registered with the current custodian
(see @secref["custodians"]), so that the converter is closed when
the custodian is shut down. A converter is not registered with a
custodian (and does not need to be closed) if it is one of the
guaranteed combinations not involving @scheme[""] under Unix, or if it
is any of the guaranteed combinations (including @scheme[""]) under
guaranteed combinations not involving @scheme[""] on Unix, or if it
is any of the guaranteed combinations (including @scheme[""]) on
Windows and Mac OS X.
@margin-note{In the Racket software distributions for Windows, a suitable
@ -481,7 +481,7 @@ Windows and Mac OS X.
The set of available encodings and combinations varies by platform,
depending on the @exec{iconv} library that is installed; the
@scheme[from-name] and @scheme[to-name] arguments are passed on to
@tt{iconv_open}. Under Windows, @filepath{iconv.dll} or
@tt{iconv_open}. On Windows, @filepath{iconv.dll} or
@filepath{libiconv.dll} must be in the same directory as
@filepath{libmzsch@italic{VERS}.dll} (where @italic{VERS} is a version
number), in the user's path, in the system directory, or in the

4
collects/scribblings/reference/collects.scrbl
View File

@ -108,8 +108,8 @@ Produces a list of paths as follows:
default collection path list (as constructed by the first three
bullets above) is used directly.
Note that under @|AllUnix|, paths are separated by @litchar{:}, and
under Windows by @litchar{;}. Also,
Note that on @|AllUnix|, paths are separated by @litchar{:}, and
on Windows by @litchar{;}. Also,
@racket[path-list-string->path-list] splices the default paths at an
empty path, for example, with many Unix shells you can set
@envvar{PLTCOLLECTS} to @tt{":`pwd`"}, @tt{"`pwd`:"}, or

6
collects/scribblings/reference/encodings.scrbl
View File

@ -58,17 +58,17 @@ the locale's encoding; and, finally, Racket provides functions such as
encoding.
A Unix user selects a locale by setting environment variables, such as
@envvar{LC_ALL}. Under Windows and Mac OS X, the operating system
@envvar{LC_ALL}. On Windows and Mac OS X, the operating system
provides other mechanisms for setting the locale. Within Racket, the
current locale can be changed by setting the @racket[current-locale]
parameter. The locale name within Racket is a string, and the
available locale names depend on the platform and its configuration,
but the @racket[""] locale means the current user's default locale;
under Windows and Mac OS X, the encoding for @racket[""] is always
on Windows and Mac OS X, the encoding for @racket[""] is always
UTF-8, and locale-sensitive operations use the operating system's
native interface. (In particular, setting the @envvar{LC_ALL} and
@envvar{LC_CTYPE} environment variables does not affect the locale
@racket[""] under Mac OS X. Use @racket[getenv] and
@racket[""] on Mac OS X. Use @racket[getenv] and
@racket[current-locale] to explicitly install the
environment-specified locale, if desired.) Setting the current locale
to @racket[#f] makes locale-sensitive operations locale-insensitive,

18
collects/scribblings/reference/file-ports.scrbl
View File

@ -74,13 +74,13 @@ translated on input:
]}
]
Under Windows, @racket['text] mode works only with regular files;
On Windows, @racket['text] mode works only with regular files;
attempting to use @racket['text] with other kinds of files triggers an
@racket[exn:fail:filesystem] exception.
Otherwise, the file specified by @racket[path] need not be a regular
file. It might be a device that is connected through the filesystem, such
as @filepath{aux} under Windows or @filepath{/dev/null} under Unix. In all
as @filepath{aux} on Windows or @filepath{/dev/null} on Unix. In all
cases, the port is buffered by default.
The port produced by @racket[open-input-file] should be explicitly
@ -119,13 +119,13 @@ are translated when written to the file:
@item{@racket['binary] --- bytes are written to the file exactly
as written to the port.}
@item{@racket['text] --- under Windows, a linefeed byte (10) written
@item{@racket['text] --- on Windows, a linefeed byte (10) written
to the port is translated to a return-linefeed combination in the
file; no filtering occurs for returns.}
]
Under Windows, @racket['text] mode works only with regular files;
On Windows, @racket['text] mode works only with regular files;
attempting to use @racket['text] with other kinds of files triggers an
@racket[exn:fail:filesystem] exception.
@ -160,7 +160,7 @@ files that already exist:
truncating it, or create the file if it does not exist.}
@item{@indexed-racket['append] --- append to the end of the file,
whether it already exists or not; under Windows,
whether it already exists or not; on Windows,
@racket['append] is equivalent to @racket['update], except that
the file is not required to exist, and the file position is
immediately set to the end of the file after opening it.}
@ -169,7 +169,7 @@ files that already exist:
The file specified by @racket[path] need not be a regular file. It
might be a device that is connected through the filesystem, such as
@filepath{aux} under Windows or @filepath{/dev/null} under Unix. The output
@filepath{aux} on Windows or @filepath{/dev/null} on Unix. The output
port is block-buffered by default, unless the file corresponds to a
terminal, in which case it is line-buffered by default.
@ -316,12 +316,12 @@ either it is released with @racket[port-file-unlock] or the port is closed
Depending on the platform, locks may be merely advisory (i.e., locks
affect only the ability of processes to acquire locks) or they may
correspond to mandatory locks that prevent reads and writes to the
locked file. Specifically, locks are mandatory under Windows and
locked file. Specifically, locks are mandatory on Windows and
advisory on other platforms.
Typically, locking is supported only for file ports, and attempting to
acquire a lock with other kinds of file-stream ports raises an
@racket[exn:fail:filesystem] exception. Locking is not supported under Solaris,
@racket[exn:fail:filesystem] exception. Locking is not supported on Solaris,
where the @racket[exn:fail:unsupported] exception is raised.}
@ -342,7 +342,7 @@ and only if the ports access the same device and file. For ports whose
open times do not overlap, no guarantee can be provided for the port
identities (even if the ports actually access the same file)---except
as can be inferred through relationships with other ports. If
@racket[port] is closed, the @exnraise[exn:fail]. Under
@racket[port] is closed, the @exnraise[exn:fail]. On
Windows 95, 98, and Me, if @racket[port] is connected to a
pipe instead of a file, the @exnraise[exn:fail:filesystem].

74
collects/scribblings/reference/filesystem.scrbl
View File

@ -24,14 +24,14 @@ by @racket[kind], which must be one of the following:
@item{@indexed-racket['home-dir] --- the current user's home
directory.
Under Unix and Mac OS X, this directory is determined by expanding
On Unix and Mac OS X, this directory is determined by expanding
the path @filepath{~}, which is expanded by first checking for a
@indexed-envvar{HOME} environment variable. If none is defined, the
@indexed-envvar{USER} and @indexed-envvar{LOGNAME} environment
variables are consulted (in that order) to find a user name, and then
system files are consulted to locate the user's home directory.
Under Windows, the user's home directory is the user-specific profile
On Windows, the user's home directory is the user-specific profile
directory as determined by the Windows registry. If the registry
cannot provide a directory for some reason, the value of the
@indexed-envvar{USERPROFILE} environment variable is used instead, as
@ -43,27 +43,27 @@ by @racket[kind], which must be one of the following:
the current executable is used as the home directory.}
@item{@indexed-racket['pref-dir] --- the standard directory for
storing the current user's preferences. Under Unix, the directory is
@filepath{.racket} in the user's home directory. Under Windows, it
storing the current user's preferences. On Unix, the directory is
@filepath{.racket} in the user's home directory. On Windows, it
is @filepath{Racket} in the user's application-data folder as
specified by the Windows registry; the application-data folder is
usually @filepath{Application Data} in the user's profile
directory. Under Mac OS X, it is @filepath{Library/Preferences} in the
directory. On Mac OS X, it is @filepath{Library/Preferences} in the
user's home directory. This directory might not exist.}
@item{@indexed-racket['pref-file] --- a file that contains a
symbol-keyed association list of preference values. The file's
directory path always matches the result returned for
@racket['pref-dir]. The file name is @filepath{racket-prefs.rktd} under Unix
and Windows, and it is @filepath{org.racket-lang.prefs.rktd} under Mac OS
@racket['pref-dir]. The file name is @filepath{racket-prefs.rktd} on Unix
and Windows, and it is @filepath{org.racket-lang.prefs.rktd} on Mac OS
X. The file's directory might not exist. See also
@racket[get-preference].}
@item{@indexed-racket['temp-dir] --- the standard directory for
storing temporary files. Under @|AllUnix|, this is the directory
storing temporary files. On @|AllUnix|, this is the directory
specified by the @indexed-envvar{TMPDIR} environment variable, if it
is defined, otherwise it is the first path that exists among
@filepath{/var/tmp}, @filepath{/usr/tmp}, and @filepath{/tmp}. Under
@filepath{/var/tmp}, @filepath{/usr/tmp}, and @filepath{/tmp}. On
Windows, the result is the directory specified by the
@indexed-envvar{TMP} or @indexed-envvar{TEMP} environment variable,
if it is defined, otherwise it is the current directory.}
@ -91,27 +91,27 @@ by @racket[kind], which must be one of the following:
overridden by the @DFlag{addon} or @Flag{A} command-line flag. If no
environment variable or flag is specified, or if the value is not a
legal path name, then this directory defaults to
@filepath{Library/Racket} in the user's home directory under Mac
@filepath{Library/Racket} in the user's home directory on Mac
OS X and @racket['pref-dir] otherwise. This directory might not
exist.}
@item{@indexed-racket['doc-dir] --- the standard directory for
storing the current user's documents. Under Unix, it's the same as
@racket['home-dir]. Under Mac OS X, it's the
@filepath{Documents} directory in the user's home directory. Under
storing the current user's documents. On Unix, it's the same as
@racket['home-dir]. On Mac OS X, it's the
@filepath{Documents} directory in the user's home directory. On
Windows, it is the user's documents folder as specified by the
Windows registry; the documents folder is usually @filepath{My Documents}
in the user's home directory.}
@item{@indexed-racket['desk-dir] --- the directory for the current user's
desktop. Under Unix, it's the same as @racket['home-dir]. Under
desktop. On Unix, it's the same as @racket['home-dir]. On
Windows, it is the user's desktop folder as specified by the Windows
registry; the documents folder is usually @filepath{Desktop} in the
user's home directory. Under Mac OS X, it is the desktop directory,
which is specifically @filepath{~/Desktop} under Mac OS X.}
user's home directory. On Mac OS X, it is the desktop directory,
which is specifically @filepath{~/Desktop} on Mac OS X.}
@item{@indexed-racket['sys-dir] --- the directory containing the
operating system for Windows. Under @|AllUnix|, the
operating system for Windows. On @|AllUnix|, the
result is @racket["/"].}
@item{@indexed-racket['exec-file] --- the path of the Racket
@ -152,8 +152,8 @@ by @racket[kind], which must be one of the following:
(listof path?)]{
Parses a string or byte string containing a list of paths, and returns
a list of path strings. Under @|AllUnix|, paths in a path list are
separated by a @litchar{:}; under Windows, paths are separated by a
a list of path strings. On @|AllUnix|, paths in a path list are
separated by a @litchar{:}; on Windows, paths are separated by a
@litchar{;}, and all @litchar{"}s in the string are discarded. Whenever the path
list contains an empty path, the list
@racket[default-path-list] is spliced into the returned list of
@ -179,7 +179,7 @@ This procedure is used by the Racket executable to find the
standard library collection directory (see @secref["collects"]). In
this case, @racket[program] is the name used to start Racket and
@racket[related] is @racket["collects"]. The @racket[related-sub]
argument is used because, under @|AllUnix|, @racket[program-sub] may
argument is used because, on @|AllUnix|, @racket[program-sub] may
involve to a sequence of soft links; in this case,
@racket[related-sub] determines which link in the chain is relevant.
@ -202,10 +202,10 @@ variable is defined, @racket[find-executable-path] tries each path in
algorithm described above for path-containing
@racket[program-sub]s. If the @envvar{PATH} environment variable is
not defined, @racket[program-sub] is prefixed with the current
directory and used in the search algorithm above. (Under Windows, the
directory and used in the search algorithm above. (On Windows, the
current directory is always implicitly the first item in
@envvar{PATH}, so @racket[find-executable-path] checks the current
directory first under Windows.)}
directory first on Windows.)}
@;------------------------------------------------------------------------
@section[#:tag "fileutils"]{Files}
@ -215,7 +215,7 @@ directory first under Windows.)}
Returns @racket[#t] if a file (not a directory) @racket[path] exists,
@racket[#f] otherwise.
Under Windows, @racket[file-exists?] reports @racket[#t] for all
On Windows, @racket[file-exists?] reports @racket[#t] for all
variations of the special filenames (e.g., @racket["LPT1"],
@racket["x:/baddir/LPT1"]).}
@ -257,10 +257,10 @@ a directory. Unless @racket[exists-ok?] is provided as a true value,
file when @racket[old] is a directory, and vice versa.
If @racket[new] exists and is replaced, the replacement is atomic
under Unix and Mac OS X, but it is not guaranteed to be atomic under
on Unix and Mac OS X, but it is not guaranteed to be atomic on
Windows. Furthermore, if @racket[new] exists and is opened by any
process for reading or writing, then attempting to replace it will
typically fail under Windows.
typically fail on Windows.
If @racket[old] is a link, the link is renamed rather than the
destination of the link, and it counts as a file for replacing any
@ -275,7 +275,7 @@ existing @racket[new].}
Returns the file or directory's last modification date as
platform-specific seconds (see also @secref["time"]) when
@racket[secs-n] is not provided or is @racket[#f]. (For FAT
filesystems under Windows, directories do not have modification
filesystems on Windows, directories do not have modification
dates. Therefore, the creation date is returned for a directory, but
the modification date is returned for a file.)
@ -294,7 +294,7 @@ called, and the default @racket[fail-thunk] raises
When given one argument or @racket[#f] as the second argument, returns
a list containing @indexed-racket['read], @indexed-racket['write],
and/or @indexed-racket['execute] to indicate permission the given file
or directory path by the current user and group. Under @|AllUnix|,
or directory path by the current user and group. On @|AllUnix|,
permissions are checked for the current effective user instead of the
real user.
@ -317,9 +317,9 @@ members of the file or directory's group, or other users:
@item{@racketvalfont{#o004} : others have execute permission}
]
See also @racket[user-read-bit], etc. Under Windows, permissions from
See also @racket[user-read-bit], etc. On Windows, permissions from
all three (owner, group, and others) are always the same, and read and
execute permission are always available. Under @|AllUnix|,
execute permission are always available. On @|AllUnix|,
higher bits have a platform-specific meaning.
If an integer is supplied as the second argument, its is used as an
@ -346,7 +346,7 @@ identity of the referenced file or directory (if any).}
@defproc[(file-size [path path-string?]) exact-nonnegative-integer?]{
Returns the (logical) size of the specified file in bytes. Under Mac
Returns the (logical) size of the specified file in bytes. On Mac
OS X, this size excludes the resource-fork size. On error (e.g., if no
such file exists), the @exnraise[exn:fail:filesystem].}
@ -356,18 +356,18 @@ such file exists), the @exnraise[exn:fail:filesystem].}
Creates the file @racket[dest] as a copy of @racket[src]. If the file
is not successfully copied, the @exnraise[exn:fail:filesystem]. If
@racket[dest] already exists, the copy will fail. File permissions are
preserved in the copy. Under Mac OS X, the resource fork is also
preserved in the copy. On Mac OS X, the resource fork is also
preserved in the copy. If @racket[src] refers to a link, the target of
the link is copied, rather than the link itself.}
@defproc[(make-file-or-directory-link [to path-string?] [path path-string?])
void?]{
Creates a link @racket[path] to @racket[to] under @|AllUnix|. The
Creates a link @racket[path] to @racket[to] on @|AllUnix|. The
creation will fail if @racket[path] already exists. The @racket[to]
need not refer to an existing file or directory, and @racket[to] is
not expanded before writing the link. If the link is not created
successfully,the @exnraise[exn:fail:filesystem]. Under Windows, the
successfully,the @exnraise[exn:fail:filesystem]. On Windows, the
@exnraise[exn:fail:unsupported] always.}
@;------------------------------------------------------------------------
@ -424,14 +424,14 @@ directory is not deleted successfully, the
@margin-note{See also the @scheme[in-directory] sequence constructor.}
Returns a list of all files and directories in the directory specified
by @racket[path]. Under Windows, an element of the list may start with
by @racket[path]. On Windows, an element of the list may start with
@litchar{\\?\REL\\}.}
@defproc[(filesystem-root-list) (listof path?)]{
Returns a list of all current root directories. Obtaining this list
can be particularly slow under Windows.}
can be particularly slow on Windows.}
@;------------------------------------------------------------------------
@section[#:tag "runtime-path"]{Declaring Paths Needed at Run Time}
@ -937,7 +937,7 @@ then the cache is used only if the file has a timestamp that is the
same as the last time the file was read. Otherwise, the file is
re-consulted.
Under platforms for which @racket[preferences-lock-file-mode] returns
On platforms for which @racket[preferences-lock-file-mode] returns
@racket['file-lock] and when @racket[use-lock?] is true,
preference-file reading is guarded by a lock; multiple readers can
share the lock, but writers take the lock exclusively. If the
@ -1017,7 +1017,7 @@ indicates that a write lock is held, and readers need no lock (because
the preferences file is atomically updated via
@racket[rename-file-or-directory]).
The @racket['file-lock] mode is currently used under Windows. In
The @racket['file-lock] mode is currently used on Windows. In
@racket['file-lock] mode, shared and exclusive locks (in the sense of
@racket[port-try-file-lock?]) on the lock file reflect reader and
writer locks on the preference-file content. (The preference file

2
collects/scribblings/reference/networking.scrbl
View File

@ -45,7 +45,7 @@ accepts only connections to @racket["127.0.0.1"] (the loopback
interface) from the local machine.
(Racket implements a listener with multiple sockets, if necessary, to
accommodate multiple addresses with different protocol families. Under
accommodate multiple addresses with different protocol families. On
Linux, if @racket[hostname] maps to both IPv4 and IPv6 addresses, then
the behavior depends on whether IPv6 is supported and IPv6 sockets can
be configured to listen to only IPv6 connections: if IPv6 is not

16
collects/scribblings/reference/paths.scrbl
View File

@ -129,7 +129,7 @@ Windows paths.
If @racket[str] does not correspond to any path element
(e.g., it is an absolute path, or it can be split), or if it
corresponds to an up-directory or same-directory indicator under
corresponds to an up-directory or same-directory indicator on
@|AllUnix|, then @exnraise[exn:fail:contract].
As for @racket[path->string], information can be lost from
@ -155,7 +155,7 @@ elements is necessary.}
@defproc[(path-element->string [path path?]) string?]{
Like @racket[path->string], except that trailing path separators are
removed (as by @racket[split-path]). Under Windows, any
removed (as by @racket[split-path]). On Windows, any
@litchar{\\?\REL} encoding prefix is also removed; see
@secref["windowspaths"] for more information on Windows paths.
@ -326,7 +326,7 @@ This procedure does not access the filesystem.}
Returns @racket[path] if @racket[path] syntactically refers to a
directory and ends in a separator, otherwise it returns an extended
version of @racket[path] that specifies a directory and ends with a
separator. For example, under @|AllUnix|, the path @filepath{x/y/}
separator. For example, on @|AllUnix|, the path @filepath{x/y/}
syntactically refers to a directory and ends in a separator, but
@filepath{x/y} would be extended to @filepath{x/y/}, and @filepath{x/..} would be
extended to @filepath{x/../}. The @racket[path] argument can be a path for
@ -338,7 +338,7 @@ This procedure does not access the filesystem.}
@defproc[(resolve-path [path path-string?]) path?]{
@tech{Cleanse}s @racket[path] and returns a path that references the
same file or directory as @racket[path]. Under @|AllUnix|, if
same file or directory as @racket[path]. On @|AllUnix|, if
@racket[path] is a soft link to another path, then the referenced path
is returned (this may be a relative path with respect to the directory
owning @racket[path]), otherwise @racket[path] is returned (after
@ -354,7 +354,7 @@ this chapter) without consulting the filesystem.}
@defproc[(expand-user-path [path path-string?]) path?]{
@techlink{Cleanse}s @racket[path]. In addition, under @|AllUnix|, a
@techlink{Cleanse}s @racket[path]. In addition, on @|AllUnix|, a
leading @litchar{~} is treated as user's home directory and expanded;
the username follows the @litchar{~} (before a @litchar{/} or the end
of the path), where @litchar{~} by itself indicates the home directory
@ -373,7 +373,7 @@ accesses the same file or directory (if it exists) as @racket[path].
In general, the pathname is normalized as much as possible---without
consulting the filesystem if @racket[use-filesystem?] is @racket[#f],
and (under Windows) without changing the case of letters within the
and (on Windows) without changing the case of letters within the
path. If @racket[path] syntactically refers to a directory, the
result ends with a directory separator.
@ -451,9 +451,9 @@ directory or file name. Three values are returned:
@item{a directory-name path,}
@item{a filename,}
@item{@racket['up] if the last part of @racket[path] specifies the parent
directory of the preceding path (e.g., @litchar{..} under Unix), or}
directory of the preceding path (e.g., @litchar{..} on Unix), or}
@item{@racket['same] if the last part of @racket[path] specifies the
same directory as the preceding path (e.g., @litchar{.} under Unix).}
same directory as the preceding path (e.g., @litchar{.} on Unix).}
]}
@item{@racket[must-be-dir?] is @racket[#t] if @racket[path] explicitly

10
collects/scribblings/reference/runtime.scrbl
View File

@ -69,18 +69,18 @@ platform-specific format.}
Returns a string to identify the current user's language and
country.
Under Unix and Mac OS X, the string is five characters: two lowercase
On Unix and Mac OS X, the string is five characters: two lowercase
ASCII letters for the language, an underscore, and two uppercase ASCII
letters for the country. Under Windows, the string can be arbitrarily
letters for the country. On Windows, the string can be arbitrarily
long, but the language and country are in English (all ASCII letters
or spaces) separated by an underscore.
Under Unix, the result is determined by checking the
On Unix, the result is determined by checking the
@indexed-envvar{LC_ALL}, @indexed-envvar{LC_TYPE}, and
@indexed-envvar{LANG} environment variables, in that order (and the
result is used if the environment variable's value starts with two
lowercase ASCII letters, an underscore, and two uppercase ASCII
letters, followed by either nothing or a period). Under Windows and
letters, followed by either nothing or a period). On Windows and
Mac OS X, the result is determined by system calls.}
@ -90,7 +90,7 @@ Mac OS X, the result is determined by system calls.}
Returns a relative directory path. This string can be used to build
paths to system-specific files. For example, when Racket is running
under Solaris on a Sparc architecture, the subpath starts
on Solaris on a Sparc architecture, the subpath starts
@racket["sparc-solaris"], while the subpath for Windows on an i386
architecture starts @racket["win32\\i386"].

14
collects/scribblings/reference/startup.scrbl
View File

@ -21,19 +21,19 @@ The core Racket run-time system is available in two main variants:
@itemize[
@item{Racket, which provides the primitives libraries on which
@racketmodname[racket/base] is implemented. Under Unix and Mac
@racketmodname[racket/base] is implemented. On Unix and Mac
OS X, the executable is called
@as-index{@exec{racket}}. Under Windows, the executable is
@as-index{@exec{racket}}. On Windows, the executable is
called @as-index{@exec{Racket.exe}}.}
@item{GRacket, which is a GUI variant of @exec{racket} to the degree
that the system distinguishes them. Under Unix, the executable
that the system distinguishes them. On Unix, the executable
is called @as-index{@exec{gracket}}, and single-instance flags
and X11-related flags are handled and communicated specially to
the @racket[racket/gui/base] library. Under Windows, the
the @racket[racket/gui/base] library. On Windows, the
executable is called @as-index{@exec{GRacket.exe}}, and it is a
GUI application (as opposed to a console application) that
implements singe-instance support. Under Mac OS X, the
implements singe-instance support. On Mac OS X, the
@exec{gracket} script launches @as-index{@exec{GRacket.app}}.}
]
@ -316,7 +316,7 @@ If no command-line arguments are supplied other than
@tech{configuration options}, then the @Flag{i}/@DFlag{repl} flag is
effectively added.
For GRacket under X11, the follow flags are recognized when they appear
For GRacket on Unix, the follow flags are recognized when they appear
at the beginning of the command line, and they count as configuration
options (i.e., they do not disable the read-eval-print loop or prevent
the insertion of @Flag{u}/@DFlag{require-script}):
@ -352,7 +352,7 @@ the insertion of @Flag{u}/@DFlag{require-script}):
]
Similarly, under Mac OS X, a leading switch starting with
Similarly, on Mac OS X, a leading switch starting with
@FlagFirst{psn_} is treated as a special configuration option. It
indicates that Finder started the application, so the current input,
output, and error output are redirected to a GUI window.

2
collects/scribblings/reference/string-input.scrbl
View File

@ -60,7 +60,7 @@ must be one of the following symbols:
Return and linefeed characters are detected after the conversions that
are automatically performed when reading a file in text mode. For
example, reading a file in text mode under Windows automatically
example, reading a file in text mode on Windows automatically
changes return-linefeed combinations to a linefeed. Thus, when a file
is opened in text mode, @scheme['linefeed] is usually the appropriate
@scheme[read-line] mode.}

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

@ -29,17 +29,17 @@ 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. Under
the @racket[arg]s are command-line arguments for the program. 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
encoding (see @secref["encodings"]). Under Windows, command-line
encoding (see @secref["encodings"]). On Windows, command-line
arguments are passed as strings, and bytes strings are converted using
UTF-8.
Under Windows, the first @racket[arg] can be replaced with
On Windows, the first @racket[arg] can be replaced with
@indexed-racket['exact], which triggers a Windows-specific behavior:
the sole @racket[arg] is used exactly as the command-line for the
subprocess. Otherwise, under Windows, a command-line string is
subprocess. Otherwise, on Windows, a command-line string is
constructed from @racket[command] and @racket[arg] so that a typical
Windows console application can parse it back to an array of
arguments. If @racket['exact] is provided on a non-Windows platform,
@ -132,14 +132,14 @@ current platform:
@item{@racket[force?] is true, not a group, all platforms: Terminates
the process if the process still running.}
@item{@racket[force?] is false, not a group, under Unix or Mac OS X:
@item{@racket[force?] is false, not a group, on Unix or Mac OS X:
Sends the process an interrupt signal instead of a kill
signal.}
@item{@racket[force?] is false, not a group, under Windows: No action
@item{@racket[force?] is false, not a group, on Windows: No action
is taken.}
@item{@racket[force?] is true, a group, under Unix or Mac OS X:
@item{@racket[force?] is true, a group, on Unix or Mac OS X:
Terminates all processes in the group, but only if
@racket[subprocess-status] has never produced a
non-@racket['running] result for the subprocess and only if
@ -149,15 +149,15 @@ current platform:
terminated while the continued existence of the group is
unknown).}
@item{@racket[force?] is true, a group, under Windows: Terminates
@item{@racket[force?] is true, a group, on Windows: Terminates
the process if the process still running.}
@item{@racket[force?] is false, a group, under Unix or Mac OS X: The
@item{@racket[force?] is false, a group, on Unix or Mac OS X: The
same as when @racket[force?] is @scheme[#t], but when the group
is sent a signal, it is an interrupt signal instead of a kill
signal.}
@item{@racket[force?] is false, a group, under Windows: All processes
@item{@racket[force?] is false, a group, on Windows: All processes
in the group receive a CTRL-BREAK signal (independent of
whether the immediate subprocess has terminated).}
@ -339,7 +339,7 @@ is executed directly (instead of through a shell command), and the
specified string arguments (which must contain no nul
characters).
Under Windows, the first argument after @racket[command] can be
On Windows, the first argument after @racket[command] can be
@racket['exact], and the final @racket[arg] is a complete command
line. See @racket[subprocess] for details.}
@ -364,8 +364,8 @@ Like @racket[system*], but returns the exit code like
input-port?
((or/c 'status 'wait 'interrupt 'kill) . -> . any))]{
Executes a shell command asynchronously (using @exec{sh} under Unix
and Mac OS X, @exec{cmd} under Windows). The result is a list of five
Executes a shell command asynchronously (using @exec{sh} on Unix
and Mac OS X, @exec{cmd} on Windows). The result is a list of five
values:
@itemize[
@ -395,10 +395,10 @@ values:
the subprocess has completed.}
@item{@racket['interrupt] sends the subprocess an interrupt signal
under @|AllUnix|, and takes no action under Windows. The result is
on @|AllUnix|, and takes no action on Windows. The result is
@|void-const|.
@margin-note{Under Unix and Mac OS X, if @racket[command] runs a
@margin-note{On Unix and Mac OS X, if @racket[command] runs a
single program, then @exec{sh} typically runs the program in
such a way that it replaces @exec{sh} in the same process. For
reliable and precise control over process creation, however, use
@ -408,7 +408,7 @@ values:
@|void-const|. Note that the immediate process created by
@racket[process] is a shell process that may run another program;
terminating the shell process may not terminate processes that
the shell starts, particularly under Windows.}
the shell starts, particularly on Windows.}
]}
@ -430,7 +430,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. Under
is executed directly, and the @racket[arg]s are the arguments. On
Windows, as for @racket[system*], the first @racket[arg] can be
replaced with @racket['exact].}

2
collects/scribblings/reference/time.scrbl
View File

@ -96,7 +96,7 @@ is in microseconds.}
Returns an amount of processor time in @tech{fixnum} milliseconds
that has been consumed by the Racket process on the underlying
operating system. (Under @|AllUnix|, this includes both user and
operating system. (On @|AllUnix|, this includes both user and
system time.) If @racket[thread] is @racket[#f], the reported time
is for all Racket threads, otherwise the result is specific to the
time while @racket[thread] ran.

2
collects/scribblings/reference/unix-paths.scrbl
View File

@ -35,4 +35,4 @@ _path)]. Since that is not the case for other platforms, however,
@racket[path-element->bytes] and @racket[path-element->string] should
be used when converting individual path elements.
Under Mac OS X, Finder aliases are zero-length files.
On Mac OS X, Finder aliases are zero-length files.

9
collects/scribblings/scribble/style.scrbl
View File

@ -58,6 +58,15 @@ than a hidden abstraction in the document implementation.
Hyphenate the words ``sub-form'' and ``sub-expression.''
Use ``Windows,'' ``Mac OS X,'' and ``Unix'' for the three
``platforms'' (as opposed to ``systems'') on which Racket runs. Use
``Unix'' as a generic term for Unix-like operating systems---notably
including Linux---other than Mac OS X. Use ``Unix'' even when ``Gtk''
or ``the X11 windowing system'' would be more precisely correct, but
use ``X11'' as adjective when necessary, such as ``X11 display.''
Racket runs ``on'' a platform, as opposed to ``under'' a platform.
@section{Typesetting Code}
Use @racketidfont{id} or a name that ends @racketidfont{-id} in

9
collects/scribblings/slideshow/guide.scrbl
View File

@ -243,10 +243,11 @@ flags.
@section{Printing}
The @Flag{p} or @DFlag{print} command-line flag causes Slideshow
to print slides instead of showing them on the screen. Under
Unix, the result is always PostScript. For all platforms,
@Flag{P} or @DFlag{ps} generates PostScript.
The @Flag{p} or @DFlag{print} command-line flag causes Slideshow to
print slides instead of showing them on the screen using the current
platform's printing system. The @Flag{P} or @DFlag{ps} generates
PostScript directly, while @Flag{D} or @DFlag{pdf} generates
PDF directly.
PS-to-PDF converters vary on how well they handle landscape
mode. Here's a Ghostscript command that converts slides reliably

2
collects/slatex/slatex-wrap.scrbl
View File

@ -12,7 +12,7 @@
@defmodule[slatex/slatex-wrapper]
To use SLaTeX as a standalone program, either drag your
@filepath{.tex} file onto SLaTeX (under Windows or MacOS X), or type
@filepath{.tex} file onto SLaTeX (on Windows or MacOS X), or type
@exec{slatex file} in a command shell.
@emph{NOTE:} If you compile your @filepath{.tex} file without using

2
collects/slideshow/doc.txt
View File

@ -289,7 +289,7 @@ Printing
========
The -p or --print command-line flag causes slideshow to print slides
instead of showing them on the screen. Under Unix, the result is
instead of showing them on the screen. On Unix, the result is
always PostScript. For all platforms, -P or --ps generates PostScript.
PS-to-PDF converters vary on how well they handle landscape

2
collects/teachpack/2htdp/scribblings/image.scrbl
View File

@ -175,7 +175,7 @@ Unlike @racket[scene+curve], if the line passes outside of @racket[image], the i
The @racket[face] and the @racket[family] combine to give the complete typeface. If
@racket[face] is available on the system, it is used, but if not then a default typeface
based on the @racket[family] is chosen. The @racket[style] controls if the face is italic
or not (under Windows and Mac OS X, @racket['slant] and @racket['italic] are the same),
or not (on Windows and Mac OS X, @racket['slant] and @racket['italic] are the same),
the @racket[weight] controls if it is boldface (or light), and @racket[underline?]
determines if the face is underlined. For more details on these arguments, see @racket[font%],
which ultimately is what this code uses to draw the font.