X-Git-Url: https://jxself.org/git/?p=ibg.git;a=blobdiff_plain;f=appendices%2Fc.rst;h=bbd896db84cd3019eb384e5aae164282b7d78e47;hp=4dfb8b3a00d4769fa6caa35be0c271791fe7840b;hb=HEAD;hpb=95b5702817b987123d71d432f81eeb0c7101b59c diff --git a/appendices/c.rst b/appendices/c.rst index 4dfb8b3..bbd896d 100644 --- a/appendices/c.rst +++ b/appendices/c.rst @@ -9,10 +9,9 @@ .. image:: /images/picW.png :align: left -|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 ================== @@ -94,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. @@ -112,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):: @@ -134,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.