@require[....]* to @(require ...*)

svn: r8269

collects/scribblings/guide/welcome.scrbl

@@ -139,7 +139,7 @@ evaluation context to the inside of the module, just like DrScheme's
 @onscreen{Run} button.
 
 @; ----------------------------------------------------------------------
-@section{A Note to Readers with Scheme/Lisp Experience}
+@section[#:tag "use-module"]{A Note to Readers with Scheme/Lisp Experience}
 
 If you already know something about Scheme or Lisp, you might be
 tempted to put just
@@ -159,7 +159,7 @@ into @filepath{piece.ss} and run @exec{mzscheme} with
 
 That will work, because @exec{mzscheme} is willing to imitate a
 traditional Scheme environment, but we strongly recommend against using
-@scheme[load].
+@scheme[load] or writing programs outside of a module.
 
 Writing definitions outside of a module leads to bad error messages,
 bad performance, and awkward scripting to combine and run

collects/scribblings/scribble/basic.scrbl

@@ -1,7 +1,7 @@
 #lang scribble/doc
-@require[scribble/manual]
+@(require scribble/manual
-@require["utils.ss"]
+          "utils.ss"
-@require[(for-syntax scheme/base)]
+          (for-syntax scheme/base))
 
 @define-syntax[def-section-like
                (syntax-rules ()

collects/scribblings/scribble/decode.scrbl

@@ -1,6 +1,6 @@
 #lang scribble/doc
-@require[scribble/manual]
+@(require scribble/manual
-@require["utils.ss"]
+          "utils.ss")
 
 @title[#:tag "decode"]{Decoding Text}
 

collects/scribblings/scribble/doclang.scrbl

@@ -1,6 +1,6 @@
 #lang scribble/doc
-@require[scribble/manual]
+@(require scribble/manual
-@require["utils.ss"]
+          "utils.ss")
 
 @title[#:tag "doclang"]{Document Language}
 

collects/scribblings/scribble/docreader.scrbl

@@ -1,7 +1,7 @@
 #lang scribble/doc
-@require[scribble/manual]
+@(require scribble/manual
-@require[scribble/bnf]
+          scribble/bnf
-@require["utils.ss"]
+          "utils.ss")
 
 @title[#:tag "docreader"]{Document Reader}
 

collects/scribblings/scribble/how-to.scrbl

@@ -1,7 +1,7 @@
 #lang scribble/doc
-@require[scribble/manual
+@(require scribble/manual
-         scribble/bnf]
+          scribble/bnf
-@require["utils.ss"]
+          "utils.ss")
 
 @title{How to Scribble Documentation}
 
@@ -154,13 +154,13 @@ means
 For more information on the syntax of @litchar["@"], see
 @secref["reader"].
 
-In a document that starts @tt{#lang scribble/doc},
+In a document that starts @hash-lang[] @schememodname[scribble/doc],
 the top level is a text-mode sequence. The parsed sequence is further
 decoded to turn it into a hierarchy of sections and paragraphs. For
 example, a linear sequence of @scheme[section] declarations with
 interleaved text is turned into a list of @scheme[part] instances with
-all text assigned to a particular part. See @secref["decode"] for more
+all text assigned to a particular part. See @secref["layers"] for more
-information on the decoding process.
+information on these layers.
 
 @; ----------------------------------------
 @section[#:tag "scheme-hyperlinks"]{Scheme Typesetting and Hyperlinks}

collects/scribblings/scribble/layers.scrbl

@@ -3,7 +3,7 @@
           scribble/bnf
           "utils.ss")
 
-@title{Scribble Layers}
+@title[#:tag "layers"]{Scribble Layers}
 
 Scribble is made of independently usable parts.  For example, the
 Scribble reader can be used in any situation that requires lots of

collects/scribblings/scribble/reader.scrbl

@@ -1,9 +1,9 @@
 #lang scribble/doc
-@require[scribble/manual]
+@(require scribble/manual
-@require[scribble/bnf]
+          scribble/bnf
-@require[scribble/eval]
+          scribble/eval
-@require["utils.ss"]
+          "utils.ss"
-@require[(for-syntax scheme/base)]
+          (for-syntax scheme/base))
 
 @(define read-eval (make-base-eval))
 @interaction-eval[#:eval read-eval (require (for-syntax scheme/base))]

collects/scribblings/scribble/renderer.scrbl

@@ -1,7 +1,7 @@
 #lang scribble/doc
-@require[scribble/manual]
+@(require scribble/manual
-@require["utils.ss"]
+          "utils.ss"
-@require[(for-label scheme/class)]
+          (for-label scheme/class))
 
 @(define-syntax-rule (defmodule/local lib . content)
    (begin

collects/scribblings/scribble/scheme.scrbl

@@ -1,6 +1,6 @@
 #lang scribble/doc
-@require[scribble/manual]
+@(require scribble/manual
-@require["utils.ss"]
+          "utils.ss")
 
 @title[#:tag "scheme"]{Scheme}
 

collects/scribblings/scribble/scribble.scrbl

@@ -1,7 +1,7 @@
 #lang scribble/doc
-@require[scribble/manual]
+@(require scribble/manual
-@require[scribble/bnf]
+          scribble/bnf
-@require["utils.ss"]
+          "utils.ss")
 
 @title{@bold{Scribble}: PLT Documentation Tool}