From 8f9190c237f8f349ebad51daccd71877e96737bf Mon Sep 17 00:00:00 2001
From: Matthew Butterick <mb@mbtype.com>
Date: Sun, 28 Jun 2015 12:19:22 -0700
Subject: [PATCH] doc clarification

---
 scribblings/world.scrbl | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/scribblings/world.scrbl b/scribblings/world.scrbl
index 05ea927..badbbf4 100644
--- a/scribblings/world.scrbl
+++ b/scribblings/world.scrbl
@@ -34,7 +34,7 @@ A parameter that determines whether the @racket[world:directory-require] file is
 
 @section{Settable values}
 
-These values can be changed by overriding them in your @racket["directory-require.rkt"] source file. Within this file, create a submodule called @racket[config]. (More about @secref["submodules" #:doc '(lib "scribblings/guide/guide.scrbl")].) Then within this submodule, use @racket[define] to make variable with the same name as the one in @racket[pollen/world], but without the @racket[world:] prefix. Assign it whatever value you like. Repeat as needed. When Pollen runs, these definitions will supersede those in @racket[pollen/world].
+These values can be changed by overriding them in your @racket["directory-require.rkt"] source file. Within this file, @seclink["submodules" #:doc '(lib "scribblings/guide/guide.scrbl")]{create a submodule} called @racket[config]. Then within this submodule, use @racket[define] to make a variable with the same name as the one in @racket[pollen/world], but without the @racket[world:] prefix. Assign it whatever value you like. Repeat as needed. When Pollen runs, these definitions will supersede those in @racket[pollen/world].
 
 For instance, suppose you wanted the main export of every Pollen source file to be called @racket[van-halen] rather than @racket[doc], the extension of Pollen markup files to be @racket[.rock] rather than @racket[.pm], and the command character to be @litchar{🎸} instead of @litchar{◊}. Your @racket["directory-require.rkt"] would look like this:
 
@@ -42,6 +42,8 @@ For instance, suppose you wanted the main export of every Pollen source file to
 @codeblock{
 #lang racket/base
 
+;; ... the usual definitions and tag functions ...
+
 (module config racket/base
   (provide (all-defined-out))
   (define main-export 'van-halen)
@@ -64,11 +66,11 @@ Determines the default HTTP port for the project server. Initialized to @racket[
 
 @defoverridable[meta-export symbol?]{The meta hashtable exported from a compiled Pollen source file. Initialized to @racket[metas].}
 
-@defoverridable[world:meta-tag-name symbol?]{Name of the tag used to mark metas within Pollen source.}
+@defoverridable[meta-tag-name symbol?]{Name of the tag used to mark metas within Pollen source.}
 
-@defoverridable[world:directory-require string?]{File implicitly required into every Pollen source file from its directory. Initialized to @filepath{directory-require.rkt}.}
+@defoverridable[directory-require string?]{File implicitly required into every Pollen source file from its directory. Initialized to @filepath{directory-require.rkt}.}
 
-@defoverridable[world:server-extras-dir string?]{Name of directory where server support files live. Initialized to @tt{server-extras}.}
+@defoverridable[server-extras-dir string?]{Name of directory where server support files live. Initialized to @tt{server-extras}.}
 
 
 
@@ -113,9 +115,9 @@ File extensions for Pollen source files, initialized to the following values:
 @defoverridable[template-meta-key symbol?]{Meta key used to store a template name for that particular source file. Initialized to @racket['template].}
 
 @deftogether[(
-@(defoverridable world:newline string?)
-@(defoverridable world:linebreak-separator string?)
-@(defoverridable world:paragraph-separator string?)
+@(defoverridable newline string?)
+@(defoverridable linebreak-separator string?)
+@(defoverridable paragraph-separator string?)
 )]    
 Default separators used in decoding. The first two are initialized to @racket["\n"]; the third to @racket["\n\n"].