diff --git a/collects/compiler/cffi.scrbl b/collects/compiler/cffi.scrbl index 9c1ae190d3..b7ff3a7c1c 100644 --- a/collects/compiler/cffi.scrbl +++ b/collects/compiler/cffi.scrbl @@ -188,7 +188,7 @@ error reporting (e.g., with @cpp{scheme_wrong_type}). Each @scheme[argument-type] must be one of the following, which are recognized symbolically: -@itemize{ +@itemize[ @argtype[@scheme[bool] "any value" @cpp{int} @toC{@scheme[#f] @|goesto| 0, anything else @|goesto| 1} @@ -249,7 +249,7 @@ recognized symbolically: @toScheme{@cpp{NULL} @|goesto| @scheme[#f], anything else @|goesto| new c-pointer containing the pointer and identified as type @scheme[_bstr]}] -} +] The @scheme[return-type] must be @schemeidfont{void} or one of the @scheme[arg-type] keywords.} diff --git a/collects/deinprogramm/scribblings/turtle.scrbl b/collects/deinprogramm/scribblings/turtle.scrbl index a71dfab851..d0c5196d2c 100644 --- a/collects/deinprogramm/scribblings/turtle.scrbl +++ b/collects/deinprogramm/scribblings/turtle.scrbl @@ -21,11 +21,11 @@ Zeichnen wird dabei durch das Bewegen einer virtuellen Schildkröte über den Zeichenbereich modelliert. Eine Schildkröte kann durch drei Befehle bewegt werden: -@itemize{ +@itemize[ @item{@scheme[(move n)] Bewegt die Schildkröte um @scheme[n] Pixel ohne zu zeichnen.} @item{@scheme[(draw n)] Bewegt die Schildkröte um @scheme[n] Pixel und zeichnet dabei.} @item{@scheme[(turn n)] Dreht die Schildkröte um n Grad im Uhrzeigersinn.} -} +] Wir stellen jetzt ein Teachpack für DrScheme vor, mit dessen Hilfe solche Turtle-Grafiken erstellt werden können. diff --git a/collects/drscheme/tool-lib.ss b/collects/drscheme/tool-lib.ss index d18f85b627..d43fa5d635 100644 --- a/collects/drscheme/tool-lib.ss +++ b/collects/drscheme/tool-lib.ss @@ -69,12 +69,12 @@ all of the names in the tools library, for use defining keybindings initialization and @scheme[drscheme:eval:build-user-eventspace/custodian] Specifically, it sets these parameters: - @itemize{ + @itemize[ @item{ @scheme[current-namespace] has been set to a newly created empty namespace. This namespace has the following modules copied (with @scheme[namespace-attach-module]) from DrScheme's original namespace: - @itemize{@item{@scheme['mzscheme]}@item{@scheme['mred]}} + @itemize[@item{@scheme['mzscheme]}@item{@scheme['mred]}] }@item{ @scheme[read-curly-brace-as-paren] is @scheme[#t], @@ -94,7 +94,7 @@ all of the names in the tools library, for use defining keybindings @scheme[get-the-snip-class-list] is initialized with all of the snipclasses in DrScheme's eventspace's snip-class-list. - }}}) + }]}) (proc-doc/names drscheme:eval:get-snip-classes @@ -235,12 +235,12 @@ all of the names in the tools library, for use defining keybindings It initializes the user's eventspace's main thread with several parameters: - @itemize{ + @itemize[ @item{ @scheme[current-custodian] is set to a new custodian. }@item{ In addition, it calls @scheme[drscheme:eval:set-basic-parameters]. - }} + }] The @scheme[language-settings] argument is the current language and its settings. See diff --git a/collects/dynext/dynext.scrbl b/collects/dynext/dynext.scrbl index aa17e6fca3..9d312a05c6 100644 --- a/collects/dynext/dynext.scrbl +++ b/collects/dynext/dynext.scrbl @@ -145,11 +145,11 @@ Sets the parameters described in @secref["compile-params"] for a particular known compiler. The acceptable names are platforms-specific: -@itemize{ +@itemize[ @item{Unix: @scheme['cc] or @scheme['gcc]} @item{Windows: @scheme['gcc], @scheme['msvc], or @scheme['borland]} @item{MacOS: @scheme['cw]} -}} +]} @defproc[(get-standard-compilers) (listof symbol?)]{ diff --git a/collects/errortrace/scribblings/errortrace.scrbl b/collects/errortrace/scribblings/errortrace.scrbl index e9f1d518f2..e738d26772 100644 --- a/collects/errortrace/scribblings/errortrace.scrbl +++ b/collects/errortrace/scribblings/errortrace.scrbl @@ -19,7 +19,7 @@ MzScheme's limited stack-trace reporting. @section[#:tag "quick-instructions"]{Quick Instructions} -@itemize{@item{Throw away @filepath{.zo} versions of your source.} +@itemize[@item{Throw away @filepath{.zo} versions of your source.} @item{Prefix your program with @schemeblock[(require errortrace)] @@ -33,7 +33,7 @@ MzScheme's limited stack-trace reporting. @item{When an exception occurs, the exception handler prints something like a stack trace, most recent contexts first.} - } + ] The @schememodname[errortrace] module is strange; don't import it into another module. Instead, the @schememodname[errortrace] @@ -117,7 +117,7 @@ and sorts by either time or call counts.} Returns a list of lists that contain all profiling information accumulated so far: -@itemize{ +@itemize[ @item{the number of times a procedure was called.} @item{the number of milliseconds consumed by the procedure's body across @@ -133,19 +133,19 @@ so far: @item{optionally, a list of unique call paths (i.e. stack traces) recorded if @scheme[profile-paths-enabled] is set to @scheme[#t]. Each call path is a pair of - @itemize{ + @itemize[ @item{a count (the number of times the path occurred), and} @item{a list containing two-element lists. Each two-element list contains - @itemize{ + @itemize[ @item{the calling procedure's name or source expression, and} - @item{the calling procedure's source file or @scheme[#f].}} + @item{the calling procedure's source file or @scheme[#f].}] } - } + ] Collecting this information is relatively expensive.} -}} +]} @defboolparam[profile-paths-enabled on?]{ diff --git a/collects/file/scribblings/gif.scrbl b/collects/file/scribblings/gif.scrbl index ab418bfda9..c07c2a6817 100644 --- a/collects/file/scribblings/gif.scrbl +++ b/collects/file/scribblings/gif.scrbl @@ -18,7 +18,7 @@ images. The @scheme[gif-end] function ends the GIF stream. A GIF stream can be in any one of the following states: -@itemize{ +@itemize[ @item{@scheme['init] : no images or controls have been added to the stream} @@ -31,6 +31,6 @@ A GIF stream can be in any one of the following states: @item{@scheme['done] : nothing more can be added} -} +] @(include-extracted "../gif.ss") diff --git a/collects/framework/main.ss b/collects/framework/main.ss index 5b23fcfcfe..0f16c0fc9d 100644 --- a/collects/framework/main.ss +++ b/collects/framework/main.ss @@ -151,14 +151,14 @@ (name-list val-list) @{Like @scheme[put-preferences], but has more sophisticated error handling. In particular, it - @itemize{ + @itemize[ @item{waits for three consecutive failures before informing the user} @item{gives the user the opportunity to ``steal'' the lockfile after the third failure, and} @item{when failures occur, it remembers what its arguments were and if any preference save eventually succeeds, all of the - past failures are also written at that point.}}}) + past failures are also written at that point.}]}) (proc-doc/names preferences:add-panel @@ -351,7 +351,7 @@ (-> any) () @{@scheme[exit:exit] performs four actions: - @itemize{ + @itemize[ @item{sets the result of the @scheme[exit:exiting?] function to @scheme[#t].} @item{invokes the exit-callbacks, with @scheme[exit:can-exit?] if @@ -359,7 +359,7 @@ @item{invokes @scheme[exit:on-exit] and then} @item{queues a callback that calls @scheme[exit] (a mzscheme procedure) and (if @scheme[exit] returns) sets the result of - @scheme[exit:exiting?] back to @scheme[#t].}}}) + @scheme[exit:exiting?] back to @scheme[#t].}]}) (proc-doc/names exit:user-oks-exit @@ -719,22 +719,22 @@ Otherwise, it invokes the appropriate format handler to open the file (see @scheme[handler:insert-format-handler]). - @itemize{ + @itemize[ @item{If @scheme[filename] is a string, this function checks the result of @scheme[group:get-the-frame-group] to see if the @scheme[filename] is already open by a frame in the group. - @itemize{ + @itemize[ @item{If so, it returns the frame.} @item{If not, this function calls @scheme[handler:find-format-handler] with @scheme[filename]. - @itemize{ + @itemize[ @item{If a handler is found, it is applied to @scheme[filename] and it's result is the final result.} - @item{If not, @scheme[make-default] is used.}}}}} + @item{If not, @scheme[make-default] is used.}]}]} @item{If @scheme[filename] is @scheme[#f], @scheme[make-default] - is used.}}}) + is used.}]}) (parameter-doc handler:current-create-new-window @@ -966,13 +966,13 @@ @{This returns a keymap for handling standard editing operations. It binds these keys: - @itemize{ + @itemize[ @item{@scheme["z"]: undo} @item{@scheme["y"]: redo} @item{@scheme["x"]: cut} @item{@scheme["c"]: copy} @item{@scheme["v"]: paste} - @item{@scheme["a"]: select all}} + @item{@scheme["a"]: select all}] where each key is prefixed with the menu-shortcut key, based on the platform. Under unix, the shortcut is @scheme["a:"]; under windows the shortcut key is @scheme["c:"] and under MacOS, the shortcut key @@ -1055,7 +1055,7 @@ This function extends a @scheme[keymap%] with the following functions: - @itemize{ + @itemize[ @item{@mapdesc[ring-bell any] --- Rings the bell (using @scheme[bell]) and removes the search panel from the frame, if there.} @@ -1128,12 +1128,12 @@ @item{@mapdesc[end-macro key] --- Stops building a keyboard macro} @item{@mapdesc[do-macro key] --- Executes the last keyboard macro} @item{@mapdesc[toggle-overwrite key] --- Toggles overwriting - mode}} + mode}] These functions are bound to the following keys (C = control, S = shift, A = alt, M = ``meta'', D = command): - @itemize{ + @itemize[ @item{C-g : ``ring-bell''} @item{M-C-g : ``ring-bell''} @item{C-c C-g : ``ring-bell''} @@ -1213,7 +1213,7 @@ @item{MIDDLEBUTTON : ``paste-click-region''} @item{C-RIGHTBUTTON : ``copy-clipboard''} @item{INSERT : ``toggle-overwrite''} - @item{M-o : ``toggle-overwrite''}}}) + @item{M-o : ``toggle-overwrite''}]}) (proc-doc/names keymap:setup-search diff --git a/collects/games/cards/cards.scrbl b/collects/games/cards/cards.scrbl index 6fa97b5513..cd360fb306 100644 --- a/collects/games/cards/cards.scrbl +++ b/collects/games/cards/cards.scrbl @@ -302,29 +302,29 @@ Removes @scheme[card] from the table.} indicated by @scheme[which]. The @scheme[action] argument must be one of the following: - @itemize{ + @itemize[ - @item[@scheme['drag/one]]{ --- drag only the clicked-on card.} + @item{@scheme['drag/one] --- drag only the clicked-on card.} - @item[@scheme['drag-raise/one]]{ --- like drag/one, but raise the + @item{@scheme['drag-raise/one] --- like drag/one, but raise the card to the top on a click.} - @item[@scheme['drag/above]]{ --- drag the card along with any card + @item{@scheme['drag/above] --- drag the card along with any card on top of the card (i.e., more towards the front and overlapping with the card). The on-top-of relation is closed transitively.} - @item[@scheme['drag-raise/above]]{ --- like @scheme['drag/above], + @item{@scheme['drag-raise/above] --- like @scheme['drag/above], but raises.} - @item[@scheme['drag-below]]{ --- drag the card along with any card + @item{@scheme['drag-below] --- drag the card along with any card underneath the card (i.e., more towards the back and overlapping with the card). The underneath relation is closed transitively.} - @item[@scheme['drag-raise/below]]{ --- like @scheme['drag/below], + @item{@scheme['drag-raise/below] --- like @scheme['drag/below], but raises.} - } + ] The initial settings are: @scheme['drag-raise/above] for @scheme['left], @scheme['drag/one] for @scheme['middle], and diff --git a/collects/games/chat-noir/chat-noir-literate.ss b/collects/games/chat-noir/chat-noir-literate.ss index 1a500a1991..4b5120205c 100644 --- a/collects/games/chat-noir/chat-noir-literate.ss +++ b/collects/games/chat-noir/chat-noir-literate.ss @@ -1133,10 +1133,10 @@ based on the state of the key event. The @scheme[clack] function handles mouse input. It has three tasks and each corresponds to a helper function: -@itemize{ +@itemize[ @item{block the clicked cell (@scheme[block-cell/world]),} @item{move the cat (@scheme[move-cat]), and} -@item{update the black dot as the mouse moves around (@scheme[update-world-posn]).}} +@item{update the black dot as the mouse moves around (@scheme[update-world-posn]).}] The helper functions are combined in the body of @scheme[clack], first checking to see if the mouse event corresponds to a player's move (via the @scheme[player-moved?] function. diff --git a/collects/html/html.scrbl b/collects/html/html.scrbl index 9b8d446116..a523b5d893 100644 --- a/collects/html/html.scrbl +++ b/collects/html/html.scrbl @@ -117,10 +117,10 @@ A @scheme[html-content] is either } A @scheme[Contents-of-html] is either -@itemize{ +@itemize[ @item{@scheme[body]} @item{@scheme[head]} -} +] @defstruct[(div html-full)()]{ diff --git a/collects/macro-debugger/macro-debugger.scrbl b/collects/macro-debugger/macro-debugger.scrbl index 07df4fee74..f80a66fd02 100644 --- a/collects/macro-debugger/macro-debugger.scrbl +++ b/collects/macro-debugger/macro-debugger.scrbl @@ -243,7 +243,7 @@ selects an identifier, all terms in the same equivalence class as the selected term are highlighted in yellow. The available secondary partitionings are: -@itemize{ +@itemize[ @item{@scheme[bound-identifier=?]} @item{@scheme[module-identifier=?]} @item{@scheme[module-or-top-identifier=?]} @@ -263,14 +263,14 @@ The available secondary partitionings are: The bindings of the two identifiers were imported into the current context by requiring the same module. } -} +] @subsection{Properties} When the properties pane is shown, it displays properties of the selected syntax object. The properties pane has two tabbed pages: -@itemize{ +@itemize[ @item{@bold{Term}: If the selection is an identifier, shows the binding information @@ -282,7 +282,7 @@ selected syntax object. The properties pane has two tabbed pages: Displays source location information and other properties (see @scheme[syntax-property]) carried by the syntax object. } -} +] @subsection{Interpreting syntax} diff --git a/collects/mrlib/scribblings/hierlist/hierlist.scrbl b/collects/mrlib/scribblings/hierlist/hierlist.scrbl index b6af86f75e..96d99afcf1 100644 --- a/collects/mrlib/scribblings/hierlist/hierlist.scrbl +++ b/collects/mrlib/scribblings/hierlist/hierlist.scrbl @@ -12,7 +12,7 @@ arrow that the user can click to hide or show the sub-list's items. The list control supports the following default keystrokes: -@itemize{ +@itemize[ @item{Down: move to the next entry at the current level (skipping lower levels).} @@ -24,7 +24,7 @@ The list control supports the following default keystrokes: @item{Return: open/close the current selected level (only valid for lists).} -} +] @local-table-of-contents[] diff --git a/collects/mrlib/scribblings/interactive-value-port.scrbl b/collects/mrlib/scribblings/interactive-value-port.scrbl index a4548c8c72..46330874a1 100644 --- a/collects/mrlib/scribblings/interactive-value-port.scrbl +++ b/collects/mrlib/scribblings/interactive-value-port.scrbl @@ -14,13 +14,13 @@ Sets @scheme[port]'s display handler (via @scheme[port-display-handler]) so that when it encounters these values: -@itemize{ +@itemize[ @item{exact, real, non-integral numbers} @item{syntax objects} -} +] it uses @scheme[write-special] to send snips to the port, instead of those values. Otherwise, it behaves like the diff --git a/collects/mrlib/scribblings/path-dialog.scrbl b/collects/mrlib/scribblings/path-dialog.scrbl index 8439e53642..0ab2690b71 100644 --- a/collects/mrlib/scribblings/path-dialog.scrbl +++ b/collects/mrlib/scribblings/path-dialog.scrbl @@ -72,7 +72,7 @@ user to create a new directory. The @scheme[filters] argument is one of: -@itemize{ +@itemize[ @item{@scheme[(list (list _filter-name _filter-glob) ...)] --- a list of pattern names (e.g., @scheme["Scheme Files"]) and glob @@ -89,7 +89,7 @@ The @scheme[filters] argument is one of: @scheme["*.*"] under Windows and @scheme["*"] on other platforms.} -} +] The @scheme[show-file?] predicate is used to filter file paths that are shown in the dialog. The predicate is applied to the file name as diff --git a/collects/mzlib/scribblings/etc.scrbl b/collects/mzlib/scribblings/etc.scrbl index 28fcd5ee56..dd0612a5df 100644 --- a/collects/mzlib/scribblings/etc.scrbl +++ b/collects/mzlib/scribblings/etc.scrbl @@ -138,7 +138,7 @@ an additional keyword tag before the binding variables. Each @scheme[clause] has one of the following forms: -@itemize{ +@itemize[ @item{@scheme[(val target expr)] : Binds @scheme[target] non-recursively to @scheme[expr].} @@ -157,7 +157,7 @@ Each @scheme[clause] has one of the following forms: @item{@scheme[(_ expr ...)] : Evaluates the @scheme[expr]s without binding any variables.} -} +] The clauses bind left-to-right. When a @scheme[target] is @scheme[(values id ...)], multiple values returned by the diff --git a/collects/mzlib/scribblings/include.scrbl b/collects/mzlib/scribblings/include.scrbl index fadd29f02b..c636ab6c92 100644 --- a/collects/mzlib/scribblings/include.scrbl +++ b/collects/mzlib/scribblings/include.scrbl @@ -20,7 +20,7 @@ Inlines the syntax in the designated file in place of the @scheme[include] expression. The @scheme[path-spec] can be any of the following: -@itemize{ +@itemize[ @item{A literal string that specifies a path to include, parsed according to the platform's conventions (which means that it is @@ -45,7 +45,7 @@ following: directory using @scheme[build-path] to obtain the path to include.} -} +] If @scheme[path-spec] specifies a relative path to include, the path is resolved relative to the source for the @scheme[include] diff --git a/collects/mzlib/scribblings/kw.scrbl b/collects/mzlib/scribblings/kw.scrbl index 34e87d7ad5..7b87956a21 100644 --- a/collects/mzlib/scribblings/kw.scrbl +++ b/collects/mzlib/scribblings/kw.scrbl @@ -191,7 +191,7 @@ and keyword arguments---may contain specifications for rest-like arguments and/or mode keywords. Up to five rest-like arguments can be declared, each with an @scheme[_id] to bind: -@itemize{ +@itemize[ @item{@as-index{@scheme[#:rest]} --- The variable is bound to the list of ``rest'' arguments, which is the list of all values after @@ -233,7 +233,7 @@ declared, each with an @scheme[_id] to bind: binding. (When no @scheme[#:body] variables are specified, then @scheme[#:other-keys+body] is the same as @scheme[#:other-keys].)} -} +] In the following example, all rest-like arguments are used and have different bindings: @@ -252,10 +252,10 @@ bindings: Note that the following invariants always hold: -@itemize{ +@itemize[ @item{@scheme[_rest] = @scheme[(append _all-keys _body)]} @item{@scheme[_other-keys+body] = @scheme[(append _other-keys _body)]} -} +] To write a procedure that uses a few keyword argument values, and that also calls another procedure with the same list of arguments @@ -333,7 +333,7 @@ suffix: Finally, the argument list of a @scheme[lambda/kw] can contain keywords that serve as mode flags to control error reporting. -@itemize{ +@itemize[ @item{@as-index{@scheme[#:allow-other-keys]} --- The keyword-value sequence at the call site @italic{can} include keywords that are not @@ -374,12 +374,12 @@ keywords that serve as mode flags to control error reporting. @item{@as-index{@scheme[#:forbid-anything]} --- Forbids all of the above, ensuring that calls are as restricted as possible.} -} +] These above mode markers are rarely needed, because the default modes are determined by the declared rest-like arguments: -@itemize{ +@itemize[ @item{The default is to allow other keys if a @scheme[#:rest], @scheme[#:other-keys+body], @scheme[#:all-keys], or @@ -393,12 +393,12 @@ are determined by the declared rest-like arguments: @scheme[#:body], or @scheme[#:other-keys+body] variable is declared (and a @scheme[#:body] argument requires allowing them).} -} +] Here's an alternate specification, which maps rest-like arguments to the behavior that they imply: -@itemize{ +@itemize[ @item{@scheme[#:rest]: Everything is allowed (a body, other keys, and duplicate keys);} @@ -421,7 +421,7 @@ the behavior that they imply: overridden by an explicit @scheme[#:allow-...] or a @scheme[#:forbid-...] mode.} -} +] @; ---------------------------------------- diff --git a/collects/mzlib/scribblings/restart.scrbl b/collects/mzlib/scribblings/restart.scrbl index 6ea4c861d6..c5deadb494 100644 --- a/collects/mzlib/scribblings/restart.scrbl +++ b/collects/mzlib/scribblings/restart.scrbl @@ -38,7 +38,7 @@ created for the ``restarted'' MzScheme. (The new namespace is installed as the current namespace in the new thread.) In the new thread, restarting performs the following actions: -@itemize{ +@itemize[ @item{The @scheme[init-namespace] procedure is called with no arguments. The return value is ignored.} @@ -53,7 +53,7 @@ thread, restarting performs the following actions: @scheme[read-eval-print-loop] returns, the return value for @scheme[restart-mzscheme] is set to @scheme[#t].} -} +] Before evaluating command-line arguments, an exit handler is installed that immediately returns from @scheme[restart-mzscheme] with the value diff --git a/collects/mzlib/scribblings/sandbox.scrbl b/collects/mzlib/scribblings/sandbox.scrbl index e58f93cbb7..c2914d13d6 100644 --- a/collects/mzlib/scribblings/sandbox.scrbl +++ b/collects/mzlib/scribblings/sandbox.scrbl @@ -62,7 +62,7 @@ exn:fail:resource-resource Like @scheme-make-evaluator or @scheme[make-module-evaluator], but with several differences: -@itemize{ +@itemize[ @item{The @scheme[language] argument can be one of a fixed set of symbols: @scheme['r5rs], etc. They are converted by adding a @@ -79,4 +79,4 @@ with several differences: detect @scheme[require]), and the @scheme[require]d modules are added to the @scheme[#:allow] list for @|scheme-make-evaluator|.} -}} +]} diff --git a/collects/mzlib/scribblings/string.scrbl b/collects/mzlib/scribblings/string.scrbl index 2853d79123..d1d9a96bb6 100644 --- a/collects/mzlib/scribblings/string.scrbl +++ b/collects/mzlib/scribblings/string.scrbl @@ -77,13 +77,13 @@ returned, and if @scheme[str] contains multiple expressions, the result will be contain multiple values from all subexpressions. The @scheme[err-handler] argument can be: -@itemize{ +@itemize[ @item{@scheme[#f] (the default) which means that errors are not caught;} @item{a one-argument procedure, which will be used with an exception (when an error occurs) and its result will be returned} @item{a thunk, which will be used to produce a result.} -}} +]} @defproc[(expr->string [expr any/c]) string?]{ diff --git a/collects/mzscheme/mzscheme.scrbl b/collects/mzscheme/mzscheme.scrbl index 7ea66a6a79..082344b3b7 100644 --- a/collects/mzscheme/mzscheme.scrbl +++ b/collects/mzscheme/mzscheme.scrbl @@ -344,7 +344,7 @@ exception is raised.} Creates and returns a new hash table. If provided, each @scheme[flag] must one of the following: - @itemize{ + @itemize[ @item{@indexed-scheme['weak] --- creates a hash table with weakly-held keys via @scheme[make-weak-hash], @@ -358,7 +358,7 @@ must one of the following: keys using @scheme[eqv?] instead of @scheme[eq?] using @scheme[make-hasheqv] or @scheme[make-weak-hasheqv].} - } + ] By default, key comparisons use @scheme[eq?] (i.e., the hash table is created with @scheme[make-hasheq]). If the second @scheme[flag] is diff --git a/collects/net/scribblings/url.scrbl b/collects/net/scribblings/url.scrbl index 287c374e2c..56f6e2af0c 100644 --- a/collects/net/scribblings/url.scrbl +++ b/collects/net/scribblings/url.scrbl @@ -327,7 +327,7 @@ exception.} A parameter that determines a mapping of proxy servers used for connections. Each mapping is a list of three elements: -@itemize{ +@itemize[ @item{the URL scheme, such as @scheme["http"];} @@ -335,7 +335,7 @@ connections. Each mapping is a list of three elements: @item{the proxy server port number.} -} +] Currently, the only proxiable scheme is @scheme["http"]. The default mapping is the empty list (i.e., no proxies).} diff --git a/collects/openssl/openssl.scrbl b/collects/openssl/openssl.scrbl index e36ea3de8d..aa191dbe1c 100644 --- a/collects/openssl/openssl.scrbl +++ b/collects/openssl/openssl.scrbl @@ -16,7 +16,7 @@ generic @scheme[ports->ssl-ports] interface. To use this library, you will need OpenSSL installed on your machine, but -@itemize{ +@itemize[ @item{for Windows, the PLT Scheme distribution for Windows includes the necessary DLLs.} @@ -26,7 +26,7 @@ but @item{for Unix, @filepath{libssl.so} and @filepath{libcrypto.so} are likely to be installed on your machine, already.} -} +] @defthing[ssl-available? boolean?]{ @@ -106,13 +106,13 @@ section @secref["cert-procs"] below for more information on certificates. The @scheme[protocol] must be one of the following: -@itemize{ +@itemize[ @item{@scheme['sslv2-or-v3] : SSL protocol versions 2 or 3, as appropriate (this is the default)} @item{@scheme['sslv2] : SSL protocol version 2} @item{@scheme['sslv3] : SSL protocol version 3} @item{@scheme['tls] : the TLS protocol version 1} -} +] By default, the context returned by @scheme[ssl-make-client-context] does not request verification of a server's certificate. Use @scheme[ssl-set-verify!] diff --git a/collects/parser-tools/parser-tools.scrbl b/collects/parser-tools/parser-tools.scrbl index a49958ddf7..86f1163c82 100644 --- a/collects/parser-tools/parser-tools.scrbl +++ b/collects/parser-tools/parser-tools.scrbl @@ -60,7 +60,7 @@ style lexer and parser generators. An @scheme[re] is matched as follows: - @itemize{ + @itemize[ @item{@scheme[id] --- expands to the named @deftech{lexer abbreviation}; abbreviations are defined via @scheme[define-lex-abbrev] or supplied by modules like @schememodname[parser-tools/lex-sre].} @@ -78,7 +78,7 @@ style lexer and parser generators. The sub-expression must be a set of characters @scheme[re].} @item{@scheme[(id datum ...)] --- expands the @deftech{lexer macro} named @scheme[id]; macros are defined via @scheme[define-lex-trans].} - } + ] Note that both @scheme[(concatenation)] and @scheme[""] match the empty string, @scheme[(union)] matches nothing, @@ -106,7 +106,7 @@ The suggested prefix is @scheme[:], so that @scheme[:*] and Since negation is not a common operator on regular expressions, here are a few examples, using @scheme[:] prefixed SRE syntax: -@itemize{ +@itemize[ @item{@schemeblock0[(complement "1")] @@ -150,13 +150,13 @@ are a few examples, using @scheme[:] prefixed SRE syntax: words, @scheme[(:* (complement "xx"))] = @scheme[any-string]. It is usually not correct to place a @scheme[:*] around a @scheme[complement].} -} +] The following binding have special meaning inside of a lexer action: - @itemize{ + @itemize[ @item{@scheme[start-pos] --- a @scheme[position] struct for the first character matched.} @item{@scheme[end-pos] --- a @scheme[position] struct for the character after the last character in the match.} @item{@scheme[lexeme] --- the matched string.} @@ -181,7 +181,7 @@ are a few examples, using @scheme[:] prefixed SRE syntax: @scheme[((comment) (return-without-pos (get-token input-port)))] will cause the value of the recursive call to be returned without wrapping position around it.} - } + ] The lexer raises an exception @scheme[(exn:read)] if none of the regular expressions match the input. Hint: If @scheme[(any-char @@ -197,7 +197,7 @@ are a few examples, using @scheme[:] prefixed SRE syntax: special). The non-@scheme[re] @scheme[trigger] forms handle these cases: - @itemize{ + @itemize[ @item{The @scheme[(eof)] rule is matched when the input port returns an @scheme[eof-object] value. If no @scheme[(eof)] @@ -214,7 +214,7 @@ are a few examples, using @scheme[:] prefixed SRE syntax: port returns a value other than a character, @scheme[eof-object], or @scheme[special-comment] structure. If no @scheme[(special)] rule is present, the lexer returns - @scheme[(void)].}} + @scheme[(void)].}] End-of-files, specials, special-comments and special-errors can never be part of a lexeme with surrounding characters. @@ -508,7 +508,7 @@ the right choice when using @scheme[lexer] in other situations. are no duplicates and all non-@italic{OPTIONAL} declarations are present: - @itemize{ + @itemize[ @item{@schemeblock0[(grammar (non-terminal-id ((grammar-id ...) maybe-prec expr) @@ -642,7 +642,7 @@ the right choice when using @scheme[lexer] in other situations. Causes the parser generator not to report shift/reduce or reduce/reduce conflicts.} - } + ] The result of a @scheme[parser] expression with one @scheme[start] non-terminal is a function, @scheme[_parse], that takes one diff --git a/collects/planet/planet.scrbl b/collects/planet/planet.scrbl index c1c47501d4..a27b834dfb 100644 --- a/collects/planet/planet.scrbl +++ b/collects/planet/planet.scrbl @@ -312,7 +312,7 @@ where @italic{command} is a subcommand from the following list, and @(define (cmd name desc) @item{@(seclink name (exec name)): @desc}) -@itemize{ +@itemize[ @cmd["create"]{create a PLaneT archive from a directory} @cmd["install"]{download and install a given package} @cmd["remove"]{remove the specified package from the local cache} @@ -325,7 +325,7 @@ where @italic{command} is a subcommand from the following list, and @cmd["url"]{get a URL for the given package} @cmd["open"]{unpack the contents of the given package} @cmd["structure"]{display the structure of a given .plt archive} - @cmd["print"]{display a file within of the given .plt archive}} + @cmd["print"]{display a file within of the given .plt archive}] Each of these commands is described in more detail below. All the functionality of the command-line tool is also provided with a programmatic interface by @@ -339,9 +339,9 @@ Create a PLaneT archive in the current directory whose contents are the directory @exec{}. @exec{