Add a bunch of autogenerated index entries.

[ibg.git] / chapters / 02.rst

diff --git a/chapters/02.rst b/chapters/02.rst
index a5fa8e9b72c426d71e36fa9a57e4c63c1ad11e32..1d400174ff3edc46ae654edc6230536e11362534 100644 (file)
--- a/chapters/02.rst
+++ b/chapters/02.rst
@@ -4,19 +4,15 @@
 
 .. epigraph::
 
-   | *C was a captain, all covered with lace;*
-   | *D was a drunkard, and had a red face.*
+   | |CENTER| *C was a captain, all covered with lace;*
+   | |CENTER| *D was a drunkard, and had a red face.*
 
 .. only:: html
 
   .. image:: /images/picC.png
      :align: left
 
-.. raw:: latex
-
-   \dropcap{c}
-
-onventional -- static -- fiction can be written using nothing more than
+|C|\onventional -- static -- fiction can be written using nothing more than
 pencil and paper, or typewriter, or word-processor; however, the
 requirements for producing IF are a little more extensive, and the creative
 process slightly more complex.
@@ -87,6 +83,11 @@ is a "text" (or "ASCII") file containing words and phrases which can be
 read -- admittedly after a little tuition, which is what this guide is all
 about -- by humans.
 
+.. Generated by autoindex
+.. index::
+   single: IBM PC
+   pair: NotePad; text editor
+
 How do you create that source file?  Using a third software program: an
 :term:`editor`.  However, unlike the compiler and interpreter, this program
 isn't dedicated to the Inform system -- or even to IF.  An editor is an
@@ -99,17 +100,17 @@ no fancy formatting features, no bold or italics or font control, no
 embedded graphics; it simply enables you to type lines of text, which is
 exactly what's needed to create an IF game.
 
-If you look at the game source on the previous page, or in
-:doc:`/appendices/c`, you'll notice ``Include "Parser";`` and ``Include
-"VerbLib";`` a few lines down from the top of the file.  These are
-instructions to the Inform compiler to "include" -- that is, to merge in
-the contents -- of files called ``Parser.h`` and ``VerbLib.h``.  These are
-not files which you have to create; they're standard :term:`library files`,
-part of the Inform system.  All that you have to do is remember to Include
-them in every game that you write.  Until you've a fair understanding of
-how Inform works, you've no need to worry about what they contain (though
-you can look if you want to: they're readable text files, just like the
-ones this guide will teach you to write).
+If you look at the game source above, or in :doc:`/appendices/c`, you'll
+notice ``Include "Parser";`` and ``Include "VerbLib";`` a few lines down
+from the top of the file.  These are instructions to the Inform compiler to
+"include" -- that is, to merge in the contents -- of files called
+``Parser.h`` and ``VerbLib.h``.  These are not files which you have to
+create; they're standard :term:`library files`, part of the Inform system.
+All that you have to do is remember to Include them in every game that you
+write.  Until you've a fair understanding of how Inform works, you've no
+need to worry about what they contain (though you can look if you want to:
+they're readable text files, just like the ones this guide will teach you
+to write).
 
 So, we've now introduced all of the bits and pieces which you need in order to
 write an Inform adventure game:
@@ -134,6 +135,10 @@ write an Inform adventure game:
   because it's a binary file not meaningful to human eyes, neatly
   discourages players from cheating).
 
+.. Generated by autoindex
+.. index::
+   single: IF Archive
+
 All of those, apart from the editor, can be downloaded for free from the IF
 Archive.  One approach is to fetch them individually, following the
 guidance on Graham's page: visit http://www.inform-fiction.org/ and look
@@ -338,6 +343,10 @@ can stay the same in each ``.bat`` file that you create.
 
 .. rubric:: Getting a better editor
 
+.. Generated by autoindex
+.. index::
+   pair: NotePad; text editor
+
 Although NotePad is adequate when you're getting started, you'll find life
 much easier if you obtain a more powerful editor program.  We recommend
 TextPad, available as shareware from http://www.textpad.com/; in addition,
@@ -352,6 +361,9 @@ the file -- and it compiles there and then.  You can also run the
 interpreter with similar ease.  The convenience of doing this far outweighs
 the small amount of time needed to obtain and configure TextPad.
 
+.. index::
+   single: Apple Macintosh
+
 .. _inform-apple:
 
 Inform on an Apple Macintosh (running OS X)
@@ -525,6 +537,10 @@ Follow these steps:
 
 .. rubric:: Setting file associations
 
+.. Generated by autoindex
+.. index::
+   single: Infocom
+
 The business of first starting the interpreter, and then locating the story
 file that you want to play, is clumsy and inconvenient.  Fortunately, when
 the system first "sees" the Zoom interpreter (which is a nice Aqua
@@ -732,6 +748,10 @@ with these mistakes, and about controlling how the compiler behaves, in
 
 .. rubric:: More about the interpreter
 
+.. Generated by autoindex
+.. index::
+   single: Infocom
+
 One of the big advantages of the way Inform works is that a compiled game
 -- the Z-code story file -- is portable between different computers.
 That's not just from one PC to another: exactly the same story file will