Use pagestyle for standard page headings.

[ibg.git] / about.rst

diff --git a/about.rst b/about.rst
index a1af7f9c1ee4408fc88254768d2e234cb7bab1ba..ae816b9e731f76c6ae2b40182efc26fb9f97ced1 100644 (file)
--- a/about.rst
+++ b/about.rst
@@ -1,7 +1,3 @@
-.. raw:: latex
-
-   \newpage
-
 ==================
  About this guide
 ==================
@@ -96,13 +92,22 @@ Presentation and style
 Most of the guide's text appears in this typeface, except where we're using
 words which are part of the Inform system (like ``print``, ``Include``,
 ``VerbLib``) or are extracted from one of our games (like ``bird``,
-``nest``, ``top_of_tree``).  Terms in **bold type** are included in the
-glossary -- Appendix G on page 273.  We switch to italic type for a
-placeholder: for example you should read the Inform statement:
+``nest``, ``top_of_tree``).
+
+.. only:: html
+
+   Terms that are included in the :doc:`Glossary <appendices/g>` appear as
+   links to that glossary entry.
 
-.. parsed-literal::
+.. only:: latex
 
-   print "*string*";
+   Terms that are included in the :doc:`Glossary <appendices/g>` appear in
+   blue italic.  In the PDF version, these are links to the glossary entry.
+
+We switch to italic type for a placeholder: for example you should read the
+Inform statement:
+
+   :samp:`print "{string}";`
 
 as meaning "display on the player's screen the arbitrary character or
 characters which are represented here by the placeholder *string*".
@@ -163,7 +168,7 @@ locations:
     A more general list of FAQs about IF authorship, covering both Inform
     and the other main systems.
 
-*   news:rec.arts.int-fiction
+*   :newsgroup:`rec.arts.int-fiction`
 
     The Usenet newsgroup for authors of IF, commonly known by the
     abbreviation RAIF.  Here you'll find discussion on IF technology,
@@ -171,7 +176,7 @@ locations:
     assistance with your own "how do I..." questions (but please, look in
     the manual first).
 
-*   news:rec.games.int-fiction
+*   :newsgroup:`rec.games.int-fiction`
 
     The complementary newsgroup for IF *players*, often known as RGIF.
 
@@ -209,11 +214,6 @@ The drop capitals, and their associated poem, are from "A Picture
 Alphabet", digitised from a collection of public domain woodcuts, circa
 1834, by Steven J.  Lundeen of emerald city fontwerks.
 
-.. todo::
-
-   Reference to the drop-caps should only apply to those places they're
-   used (just the PDF?).
-
 All credit to the generosity of http://briefcase.yahoo.com/ for making
 international file-sharing such a breeze.
 
@@ -234,7 +234,6 @@ eventually of presenting, the Inform text adventure development system.
 
 .. [#play]
    If you feel confused about IF in general or about this distinction
-   between writing and playing in particular, try glancing ahead at "Just
-   what is interactive fiction?" on page 13 and at "How to play an IF game"
-   on page 209; also, you may find the Ifaq at
-   http://www.plover.net/~textfire/raiffaq/ifaq/ helpful.
+   between writing and playing in particular, try glancing ahead at
+   :doc:`chapters/01` and at :doc:`appendices/a`; also, you may find the
+   Ifaq at http://www.plover.net/~textfire/raiffaq/ifaq/ helpful.