Use standard newsgroup role.

[ibg.git] / about.rst

diff --git a/about.rst b/about.rst
index 13b4b0b4fe44b69ec0d2495d0b0b287045232191..e8024b5eb20552b7e4957513d00047a056236677 100644 (file)
--- a/about.rst
+++ b/about.rst
@@ -2,6 +2,8 @@
  About this guide
 ==================
 
+.. highlight:: inform6
+
 .. epigraph::
 
    | *If they asked me, I could write a book;*
@@ -9,7 +11,16 @@
 
    -- with apologies to Richard Rodgers and Lorenz Hart.
 
-Text adventures, otherwise known collectively as interactive fiction (IF),
+.. only:: html
+
+  .. image:: /images/picT.png
+     :align: left
+
+.. raw:: latex
+
+    \dropcap{t}
+
+ext adventures, otherwise known collectively as interactive fiction (IF),
 were highly popular computer games during the 1980s.  As technology evolved
 they faded from the market, unable to compete with increasingly
 sophisticated graphical games; however, IF was far from dead.  The Internet
@@ -85,9 +96,7 @@ words which are part of the Inform system (like ``print``, ``Include``,
 glossary -- Appendix G on page 273.  We switch to italic type for a
 placeholder: for example you should read the Inform statement:
 
-.. parsed-literal::
-
-   print "*string*";
+   :samp:`print "{string}";`
 
 as meaning "display on the player's screen the arbitrary character or
 characters which are represented here by the placeholder *string*".
@@ -148,7 +157,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,
@@ -156,7 +165,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.
 
@@ -194,11 +203,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.