X-Git-Url: https://jxself.org/git/?p=ibg.git;a=blobdiff_plain;f=appendices%2Fc.rst;h=bbd896db84cd3019eb384e5aae164282b7d78e47;hp=2fd1e4efd136a5923d899b645b4fb10d630235fc;hb=HEAD;hpb=f0b3c1de40eb2b2f228e43e99bf0535b1c2ea5da diff --git a/appendices/c.rst b/appendices/c.rst index 2fd1e4e..bbd896d 100644 --- a/appendices/c.rst +++ b/appendices/c.rst @@ -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 ================== @@ -98,9 +93,13 @@ you do, though, you'll get this:: ** The room "(street)" has no "description" property ** > +.. Generated by autoindex +.. index:: + pair: description; library property + 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 +115,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):: @@ -138,12 +137,16 @@ description is sufficient (and less trouble):: > +.. Generated by autoindex +.. index:: + pair: name; library property + You'll notice a couple of interesting points. Because we didn't supply 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.