X-Git-Url: https://jxself.org/git/?a=blobdiff_plain;f=appendices%2Fc.rst;h=b3277c28ad53f54357841328a4b7aeb5edba25b9;hb=fb8b7c14f10733e913e2b87f9a82e5b44c0dc7be;hp=2fd1e4efd136a5923d899b645b4fb10d630235fc;hpb=f0b3c1de40eb2b2f228e43e99bf0535b1c2ea5da;p=ibg.git diff --git a/appendices/c.rst b/appendices/c.rst index 2fd1e4e..b3277c2 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 ================== @@ -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.