diff --git a/collects/scribblings/scribble/base.scrbl b/collects/scribblings/scribble/base.scrbl index 59586d52..db7f935c 100644 --- a/collects/scribblings/scribble/base.scrbl +++ b/collects/scribblings/scribble/base.scrbl @@ -233,7 +233,7 @@ beginning of each line. The @racket[str]s are @emph{not} decoded with @racket[decode-content], so @racket[(verbatim "---")] renders with three hyphens instead of an -em-dash. Beware, however, that @emph{reading} +em dash. Beware, however, that @emph{reading} @litchar["@"]@racket[verbatim] converts @litchar["@"] syntax within the argument, and such reading occurs well before arguments to @racket[verbatim] are delivered at run-time. To disable simple diff --git a/collects/scribblings/scribble/how-to-paper.scrbl b/collects/scribblings/scribble/how-to-paper.scrbl index 3bd44e62..99d9001a 100644 --- a/collects/scribblings/scribble/how-to-paper.scrbl +++ b/collects/scribblings/scribble/how-to-paper.scrbl @@ -101,10 +101,8 @@ Add more text to @filepath{mouse.scrbl} so that it looks like this: of the second @racket[section] call, has a single paragraph. Run the @exec{scribble} command(s) from @secref["first-example"] -again. You may notice the curly double-quotes in the output; in PDF -output, the @litchar{---} turned into an em-dash. For HTML, it turned -into a en-dash with surrounding spaces, which is a typical convention -for em-dashes in HTML. +again. You may notice the curly double-quotes in the output, and +the @litchar{---} turned into an em dash. @;---------------------------------------- @section{Splitting the Document Source} @@ -526,7 +524,7 @@ recognized by @racket[decode]. A different but related @defterm{content decoding} takes place within a paragraph or section title. Content decoding is responsible for -converting @litchar{---} to an em-dash or for converting @litchar{"} +converting @litchar{---} to an em dash or for converting @litchar{"} and @litchar{'} to suitable curly quotes. The decoding process for document's stream is ultimately determined by diff --git a/collects/scribblings/scribble/style.scrbl b/collects/scribblings/scribble/style.scrbl index 169e7353..f3a35551 100644 --- a/collects/scribblings/scribble/style.scrbl +++ b/collects/scribblings/scribble/style.scrbl @@ -125,9 +125,8 @@ Refrain from referring to documentation ``above'' or ``below,'' and instead have a hyperlink point to the right place. In prose, use @litchar{``} and @litchar{''} quotation marks instead of -@litchar{"}. Use @litchar{---} for an em-dash, and do not include -spaces on either side, though it will typeset as an en-dash and spaces -in HTML output. Use American style for quotation marks and punctuation +@litchar{"}. Use @litchar{---} for an em dash, and do not include +spaces on either side. Use American style for quotation marks and punctuation @; [Eli] BTW, I've asked several people about this, and the general @; agreement that I've seen is that this is a rather arbitrary rule @; and there's no harm in doing the more logical thing of putting