Add special RST roles for the Inform entities.
[ibg.git] / appendices / c.rst
index 2fd1e4efd136a5923d899b645b4fb10d630235fc..b3277c28ad53f54357841328a4b7aeb5edba25b9 100644 (file)
@@ -9,14 +9,9 @@
   .. image:: /images/picW.png
      :align: left
 
-.. raw:: latex
-
-    \dropcap{w}
-
-illiam Tell, our second game, is also very straightforward. See "William 
-Tell: a tale is born" on page 69, "William Tell: the early years" on 
-page 79, "William Tell: in his prime" on page 91 and "William Tell: the 
-end is nigh" on page 103.
+|W|\illiam Tell, our second game, is also very straightforward.  See
+:doc:`/chapters/06`, :doc:`/chapters/07`, :doc:`/chapters/08` and
+:doc:`/chapters/09`.
 
 Transcript of play
 ==================
@@ -99,8 +94,8 @@ you do, though, you'll get this::
        >
 
 Whoops! We've fallen foul of Inform's rule saying that every room must 
-have a ``description`` property, to be displayed by the interpreter when 
-you enter that room. Our ``street`` stub hasn't got a ``description``, 
+have a :prop:`description` property, to be displayed by the interpreter when 
+you enter that room. Our ``street`` stub hasn't got a :prop:`description`, 
 so although the game compiles successfully, it still causes an error to 
 be reported at run-time.
 
@@ -116,7 +111,7 @@ class, thus:
 By doing this, we ensure that *every* room has a description of some 
 form; normally we'd override this default value with something 
 meaningful -- "The narrow street runs north towards the town square..." 
-and so on -- by including a ``description`` property in the object's 
+and so on -- by including a :prop:`description` property in the object's 
 definition. However, in a stub object used only for testing, a default 
 description is sufficient (and less trouble)::
 
@@ -143,7 +138,7 @@ external names with our ``street`` , ``bow`` and ``quiver`` stubs, the
 compiler has provided some for us -- ``(street)`` , ``(bow)`` and 
 ``(quiver)`` -- simply by adding parentheses around the internal IDs 
 which we used. And, because our ``bow`` and ``quiver`` stubs have no 
-``name`` properties, we can't actually refer to those objects when 
+:prop:`name` properties, we can't actually refer to those objects when 
 playing the game. Neither of these points would be acceptable in a 
 finished game, but for testing purposes at this early stage -- they'll 
 do.