From 744df67d4e9564bb34cbe6c1efe68499ce9e3d21 Mon Sep 17 00:00:00 2001 From: Matthew Flatt Date: Wed, 27 Aug 2008 12:28:24 +0000 Subject: [PATCH] fix some remaining Latex-isms that Eli found in the docs svn: r11454 --- collects/scribble/scribble.css | 4 ++++ collects/scribble/scribble.tex | 2 ++ collects/scribblings/gui/blurbs.ss | 3 +++ collects/scribblings/gui/style-delta-class.scrbl | 4 ++-- collects/scribblings/gui/timer-class.scrbl | 6 +++--- collects/scribblings/gui/window-intf.scrbl | 4 ++-- collects/scribblings/inside/threads.scrbl | 14 +++++++------- collects/scribblings/reference/bytes.scrbl | 8 ++++---- collects/scribblings/reference/custom-ports.scrbl | 2 +- collects/scribblings/reference/paths.scrbl | 2 +- 10 files changed, 29 insertions(+), 20 deletions(-) diff --git a/collects/scribble/scribble.css b/collects/scribble/scribble.css index 38b12c61bb..d40e560258 100644 --- a/collects/scribble/scribble.css +++ b/collects/scribble/scribble.css @@ -436,6 +436,10 @@ i { .hspace { } +.slant { + font-style: oblique; +} + .inferencetop td { border-bottom: 1px solid black; text-align: center; diff --git a/collects/scribble/scribble.tex b/collects/scribble/scribble.tex index b5a89457c1..1ea92c57ec 100644 --- a/collects/scribble/scribble.tex +++ b/collects/scribble/scribble.tex @@ -77,6 +77,8 @@ \newcommand{\preDoc}{\sloppy} \newcommand{\postDoc}{} +\newcommand{\slant}[1]{{\textsl{#1}}} + \newenvironment{leftindent}{\begin{quote}}{\end{quote}} \newenvironment{insetpara}{\begin{quote}}{\end{quote}} diff --git a/collects/scribblings/gui/blurbs.ss b/collects/scribblings/gui/blurbs.ss index 4e40a47d65..921a626cd5 100644 --- a/collects/scribblings/gui/blurbs.ss +++ b/collects/scribblings/gui/blurbs.ss @@ -283,5 +283,8 @@ information@|details|, even if the editor currently has delayed refreshing (see (define (boxisfillnull which what) @elem{The @|which| box is filled with @|what|, unless @|which| is @scheme[#f].}) + (define (slant . s) + (make-element "slant" (decode-content s))) + ) diff --git a/collects/scribblings/gui/style-delta-class.scrbl b/collects/scribblings/gui/style-delta-class.scrbl index 615e53e462..5917802c9a 100644 --- a/collects/scribblings/gui/style-delta-class.scrbl +++ b/collects/scribblings/gui/style-delta-class.scrbl @@ -11,9 +11,9 @@ by a delta include: @item{changing the font size to a new value} @item{enlarging the font by an additive amount} @item{enlarging the font by a multiplicative amount, etc.} -@item{changing the font style (normal, @italic{italic}, or {\sl slant})} +@item{changing the font style (normal, @italic{italic}, or @slant{slant})} @item{toggling the font style} -@item{changing the font to @italic{italic} if it is currently {\sl slant}, etc.} +@item{changing the font to @italic{italic} if it is currently @slant{slant}, etc.} @item{changing the font weight, etc.} @item{changing the underline, etc.} @item{changing the vertical alignment, etc.} diff --git a/collects/scribblings/gui/timer-class.scrbl b/collects/scribblings/gui/timer-class.scrbl index c9818ce4e6..1592c93b05 100644 --- a/collects/scribblings/gui/timer-class.scrbl +++ b/collects/scribblings/gui/timer-class.scrbl @@ -72,9 +72,9 @@ The timer's alarm expires after @scheme[msec] milliseconds, at which point @method[timer% notify] is called (on an event boundary). If @scheme[just-once?] is @scheme[#f], the timer expires @italic{every} @scheme[msec] milliseconds until the timer is explicitly -stopped;\footnote{More precisely, the timer expires @scheme[msec] -milliseconds after @method[timer% notify] returns each time} -otherwise, the timer expires only once. +stopped. (More precisely, the timer expires @scheme[msec] +milliseconds after @method[timer% notify] returns each time.) +Otherwise, the timer expires only once. } diff --git a/collects/scribblings/gui/window-intf.scrbl b/collects/scribblings/gui/window-intf.scrbl index 62e1df4ea1..25777c8e1d 100644 --- a/collects/scribblings/gui/window-intf.scrbl +++ b/collects/scribblings/gui/window-intf.scrbl @@ -110,7 +110,7 @@ Returns the window's cursor, or @scheme[#f] if this window's cursor exact-integer?]{ Returns an exact integer representing a handle to the window in the -current platform's GUI toolbox. Cast this number from a C \cpp{long} +current platform's GUI toolbox. Cast this number from a C @tt{long} to a platform-specific C type: @itemize{ @@ -153,7 +153,7 @@ Gets a window's label, if any. Control windows generally display their label can be an icon symbol @scheme['app], @scheme['caution], or @scheme['stop]. -The label string may contain ampersands (@litchar{&}), which serve as +The label string may contain @litchar{&}s, which serve as keyboard navigation annotations for controls under Windows and X. The ampersands are not part of the displayed label of a control; instead, ampersands are removed in the displayed label (under all platforms), diff --git a/collects/scribblings/inside/threads.scrbl b/collects/scribblings/inside/threads.scrbl index 1f30790161..544b38565f 100644 --- a/collects/scribblings/inside/threads.scrbl +++ b/collects/scribblings/inside/threads.scrbl @@ -230,9 +230,9 @@ request on the blocking file descriptors through @cpp{scheme_wakeup_on_input}. A @cpp{scheme_wakeup_on_input} procedure takes a pointer to an array -of three @cpp{fd_set}s (sortof\footnote{To ensure maximum portability, -use @cpp{MZ_FD_XXX} instead of @cpp{FD_XXX}.}) and returns -@cpp{void}. The @cpp{scheme_wakeup_on_input} does not sleep; it just +of three @cpp{fd_set}s (use @cpp{MZ_FD_SET} instead of @cpp{FD_SET}, etc.) +and returns @cpp{void}. The @cpp{scheme_wakeup_on_input} +function does not sleep immediately; it just sets up callbacks on the specified file descriptors. When input is ready on any of those file descriptors, the callbacks are removed and @cpp{scheme_wake_up} is called. @@ -343,8 +343,8 @@ if the @cpp{float} argument is zero. The second argument to @cpp{scheme_sleep} is conceptually an array of three @cpp{fd_set} records, but always use @cpp{scheme_get_fdset} to get anything other than the zeroth element of this array, and -manipulate each ``@cpp{fd_set}'' with @cpp{MZ_FD_XXX} instead of -@cpp{FD_XXX}. +manipulate each ``@cpp{fd_set}'' with @cpp{MZ_FD_SET}, +@cpp{MZ_FD_CLR}, @|etc| instead of @cpp{FD_SET}, @cpp{FD_CLR}, etc. The following function @cpp{mzsleep} is an appropriate @cpp{scheme_sleep} function for most any Unix or Windows application. @@ -494,8 +494,8 @@ If Scheme decides to sleep, then the @var{fdf} function is called to sets bits in @var{fds}, conceptually an array of three @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_XXX} - instead of @cpp{FD_XXX}. Under Windows, an ``@cpp{fd_set}'' can + 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 also accommodate OS-level semaphores or other handles via @cpp{scheme_add_fd_handle}. diff --git a/collects/scribblings/reference/bytes.scrbl b/collects/scribblings/reference/bytes.scrbl index d6cdf50595..9bf8e411e1 100644 --- a/collects/scribblings/reference/bytes.scrbl +++ b/collects/scribblings/reference/bytes.scrbl @@ -234,8 +234,8 @@ string. Produces a string by decoding the @scheme[start] to @scheme[end] substring of @scheme[bstr] as a Latin-1 encoding of Unicode code points; i.e., each byte is translated directly to a character using - @scheme[integer->char], so the decoding always succeeds. (See also the - Latin-1 footnote of @secref["encodings"].) The @scheme[err-char] + @scheme[integer->char], so the decoding always succeeds. + The @scheme[err-char] argument is ignored, but present for consistency with the other operations.} @@ -271,8 +271,8 @@ string. of @scheme[str] using Latin-1; i.e., each character is translated directly to a byte using @scheme[char->integer]. If @scheme[err-byte] is not @scheme[#f], it is used for each character in @scheme[str] whose - value is greater than @scheme[255]. (See also the Latin-1 footnote of - @secref["encodings"]. If @scheme[err-byte] is @scheme[#f], and if the + value is greater than @scheme[255]. + If @scheme[err-byte] is @scheme[#f], and if the @scheme[start] to @scheme[end] substring of @scheme[str] has a character with a value greater than @scheme[255], then the @exnraise[exn:fail:contract].} diff --git a/collects/scribblings/reference/custom-ports.scrbl b/collects/scribblings/reference/custom-ports.scrbl index af57077794..8c13d85640 100644 --- a/collects/scribblings/reference/custom-ports.scrbl +++ b/collects/scribblings/reference/custom-ports.scrbl @@ -534,7 +534,7 @@ The arguments implement the port as follows: [done-evt (caddr r)] [ch (cadddr r)] [nack (cddddr r)]) - ;; Note: we don't check that k is $\leq$ the sum of + ;; Note: we don't check that k is @scheme[<=] the sum of ;; previous peeks, because the entire stream is actually ;; known, but we could send an exception in that case. (choice-evt diff --git a/collects/scribblings/reference/paths.scrbl b/collects/scribblings/reference/paths.scrbl index 4827a40c29..5eba779c76 100644 --- a/collects/scribblings/reference/paths.scrbl +++ b/collects/scribblings/reference/paths.scrbl @@ -240,7 +240,7 @@ of @|AllUnix| paths, and see @secref["windowspaths"] for more information on the construction of Windows paths. The following examples assume that the current directory is -\File{/home/joeuser} for Unix examples and \File{C:\Joe's Files} for +@filepath{/home/joeuser} for Unix examples and @filepath{C:\Joe's Files} for Windows examples. @schemeblock[