X-Git-Url: https://jxself.org/git/?p=ibg.git;a=blobdiff_plain;f=chapters%2F15.rst;h=7eb272695dee849592082a1332eb0d2af2e96289;hp=ae0eff2fddf1b32f758898c8a888a733b31c217d;hb=9f5abf3a7762275e6ae1f1a29c6594994ba07e2c;hpb=2a223f38ada318aa468e46210b7f92941816100e diff --git a/chapters/15.rst b/chapters/15.rst index ae0eff2..7eb2726 100644 --- a/chapters/15.rst +++ b/chapters/15.rst @@ -7,11 +7,7 @@ Compiling your game .. image:: /images/picA.png :align: left -.. raw:: latex - - \dropcap{a} - -lmost as rarely as an alchemist producing gold from base metal, the +|A|\lmost as rarely as an alchemist producing gold from base metal, the compilation process turns your source file into a story file (though the more usual outcome is a reproachful explanation of why -- *again* -- that hasn't happened). The magic is performed by the compiler program, @@ -122,9 +118,13 @@ punctuation is missing:: > Object door Compiled with 1 error (no output) +.. Generated by autoindex +.. index:: + pair: door; library attribute + In fact, there's nothing wrong with the ordering or punctuation. The problem is actually that we've tried to define a new object with an -internal ID of ``door`` -- reasonably enough, you might think, since the +internal ID of :attr:`door` -- reasonably enough, you might think, since the object *is* a door -- but Inform already knows the word (it's the name of a library attribute). Unfortunately, the error message provides only the vaguest hint that you just need to choose another name: we used @@ -190,6 +190,10 @@ but some features should be in all environments. To obtain precise information about any particular version, run the compiler with the :option:`-h1` switch -- see :ref:`switches`. +.. Generated by autoindex +.. index:: + single: Strict mode + Often the compiler is run with the name of your source file as its only parameter. This tells the compiler to "read this file using Strict mode and from it generate a Version 5 story file of the same name". The source file @@ -319,6 +323,10 @@ and ``-X``. Some of the more useful switches are: .. option:: -v5 .. option:: -v8 + .. Generated by autoindex + .. index:: + single: Infocom + Compile to this version of story file. Versions 5 (on by default) and 8 are the only ones you should ever care about; they produce, respectively, story files with the extensions .z5 and .z8. Version 5