Do a bunch of proofreading fixes.

[ibg.git] / about.rst

diff --git a/about.rst b/about.rst
index 9cf8063c53c200cb9c55bba1895c2176982571dd..ae816b9e731f76c6ae2b40182efc26fb9f97ced1 100644 (file)
--- a/about.rst
+++ b/about.rst
@@ -92,9 +92,20 @@ 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``,
 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.
+
+.. only:: latex
+
+   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}";`
 
 
    :samp:`print "{string}";`
 


@@ -157,7 +168,7 @@ locations:
     A more general list of FAQs about IF authorship, covering both Inform
     and the other main systems.
 
     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,
 
     The Usenet newsgroup for authors of IF, commonly known by the
     abbreviation RAIF.  Here you'll find discussion on IF technology,


@@ -165,7 +176,7 @@ locations:
     assistance with your own "how do I..." questions (but please, look in
     the manual first).
 
     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.
 
 
     The complementary newsgroup for IF *players*, often known as RGIF.
 


@@ -223,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
 
 .. [#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.