Tick some things off the TODO list.
[ibg.git] / about.rst
index e8024b5eb20552b7e4957513d00047a056236677..aa6f5c93e5f24adfe6d2f7da6d6fba4b411a0d17 100644 (file)
--- a/about.rst
+++ b/about.rst
@@ -6,8 +6,8 @@
 
 .. epigraph::
 
-   | *If they asked me, I could write a book;*
-   | *About the way you TALK, and LISTEN; And LOOK.*
+   | |CENTER| *If they asked me, I could write a book;*
+   | |CENTER| *About the way you TALK, and LISTEN; And LOOK.*
 
    -- with apologies to Richard Rodgers and Lorenz Hart.
 
@@ -58,13 +58,13 @@ Scope and approach
 
 Because this is only an introduction to Inform, many features are treated
 rather superficially, or ignored altogether.  The definitive text is Graham
-Nelson's Inform *Designer's Manual* (Fourth Edition, July 2001), commonly
-known as the DM4; you cannot hope to use Inform successfully without having
-this splendid book by your side.  Our guide should be seen merely as a
-supplement to the DM4, offering step-by-step descriptions of those aspects
-of Inform which are most important on first acquaintance.  In any matter
-where we seem at odds with what Graham has written, you should assume that
-he is right and that we are, well, confused.
+Nelson's |DM4| (Fourth Edition, July 2001), commonly known as the DM4; you
+cannot hope to use Inform successfully without having this splendid book by
+your side.  Our guide should be seen merely as a supplement to the DM4,
+offering step-by-step descriptions of those aspects of Inform which are
+most important on first acquaintance.  In any matter where we seem at odds
+with what Graham has written, you should assume that he is right and that
+we are, well, confused.
 
 As a tutorial, this guide is intended to be printed out and then read
 sequentially; it isn't meant for online usage or designed as a reference
@@ -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``,
-``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}";`
 
@@ -130,8 +141,8 @@ locations:
 *   http://www.inform-fiction.org/
 
     The Inform home page, maintained by Graham Nelson and a small team of
-    helpers.  Most important, this is where you can find the *Inform
-    Designer's Manual* in PDF format.
+    helpers.  Most important, this is where you can find the |DM4| in PDF
+    format.
 
 *   http://mirror.ifarchive.org/
 
@@ -211,19 +222,18 @@ for devising it all, thereby giving us the opportunity -- first
 independently and later in enjoyable collaboration -- of using, and
 eventually of presenting, the Inform text adventure development system.
 
-| *Roger Firth*
-| *Wallingford, England*
+| |FILL| *Roger Firth*
+| |FILL| *Wallingford, England*
 
-| *Sonja Kesserich*
-| *Madrid, Spain*
+| |FILL| *Sonja Kesserich*
+| |FILL| *Madrid, Spain*
 
-| *August 2004*
+| |FILL| *August 2004*
 
 .. rubric:: Footnotes
 
 .. [#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.