docs/reference/chimara-docs.sgml

   1 <?xml version="1.0"?>
   2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
   3                "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
   4 <!ENTITY version SYSTEM "version.xml">
   5 ]>
   6 <book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
   7   <bookinfo>
   8     <title>Chimara Reference Manual</title>
   9     <releaseinfo>
  10       for Chimara &version;. The latest version of this documentation can be
  11       found on-line at <ulink role="online-location"
  12       url="http://[SERVER]/chimara/index.html">http://[SERVER]/chimara/</ulink>.
  13     </releaseinfo>
  14   </bookinfo>
  15
  16   <reference>
  17     <title>Chimara API Reference</title>
  18     <xi:include href="xml/chimara-glk.xml"/>
  19   </reference>
  20
  21   <reference>
  22     <title>Glk API Specification, version 0.7.0</title>
  23     <xi:include href="glk-front-matter.sgml"/>
  24
  25     <!-- Chapter 0. Introduction -->
  26     <xi:include href="glk-introduction.sgml"/>
  27
  28     <!-- Chapter 1. Overall Structure -->
  29     <chapter>
  30       <title>Overall Structure</title>
  31       <!-- For Gtk-Doc post-processed SGML files, look in the xml directory-->
  32       <xi:include href="xml/glk-main-function.sgml"/>
  33       <xi:include href="xml/glk-exiting.xml"/>
  34       <xi:include href="xml/glk-interrupt.xml"/>
  35       <xi:include href="xml/glk-tick.xml"/>
  36       <xi:include href="xml/glk-types.xml"/>
  37       <xi:include href="xml/glk-opaque-objects.xml"/>
  38       <xi:include href="xml/glk-gestalt.xml"/>
  39       <xi:include href="xml/glk-api-conventions.sgml"/>
  40     </chapter>
  41
  42     <!-- Chapter 2. Character Encoding -->
  43     <chapter>
  44       <title>Character Encoding</title>
  45       <xi:include href="glk-character-encoding.sgml"/>
  46       <xi:include href="xml/glk-output.sgml"/>
  47       <xi:include href="xml/glk-line-input.sgml"/>
  48       <xi:include href="xml/glk-character-input.xml"/>
  49       <xi:include href="xml/glk-case.xml"/>
  50     </chapter>
  51
  52     <!-- Chapter 3. Windows -->
  53     <chapter>
  54       <title>Windows</title>
  55       <xi:include href="glk-windows.sgml"/>
  56       <xi:include href="xml/glk-window-arrangement.sgml"/>
  57       <xi:include href="xml/glk-window-opening.xml"/>
  58       <xi:include href="xml/glk-window-constraints.xml"/>
  59       <xi:include href="xml/glk-display-style.sgml"/>
  60       <xi:include href="xml/glk-window-types.xml"/>
  61       <xi:include href="xml/glk-echo-streams.xml"/>
  62       <xi:include href="xml/glk-window-other.xml"/>
  63     </chapter>
  64
  65     <!-- Chapter 4. Events -->
  66     <chapter>
  67       <title>Events</title>
  68       <xi:include href="xml/glk-events.xml"/>
  69       <xi:include href="xml/glk-character-input-events.xml"/>
  70       <xi:include href="xml/glk-line-input-events.xml"/>
  71       <!--<xi:include href="xml/glk-mouse-events.xml"/>-->
  72       <xi:include href="xml/glk-timer-events.xml"/>
  73       <xi:include href="xml/glk-other-events.sgml"/>
  74         </chapter>
  75
  76         <!-- Chapter 5. Streams -->
  77         <chapter>
  78           <title>Streams</title>
  79           <xi:include href="xml/glk-streams.xml"/>
  80           <xi:include href="xml/glk-print.xml"/>
  81           <xi:include href="xml/glk-read.xml"/>
  82           <xi:include href="xml/glk-closing-streams.xml"/>
  83           <xi:include href="xml/glk-stream-positions.xml"/>
  84           <xi:include href="xml/glk-styles.xml"/>
  85           <xi:include href="xml/glk-stylehints.xml"/>
  86           <!--<xi:include href="xml/glk-style-measure.xml"/>-->
  87           <xi:include href="xml/glk-stream-types.xml"/>
  88           <xi:include href="xml/glk-stream-other.xml"/>
  89         </chapter>
  90
  91         <!-- Chapter 6. File References -->
  92         <chapter>
  93           <title>File References</title>
  94           <xi:include href="xml/glk-fileref.xml"/>
  95           <xi:include href="xml/glk-fileref-types.xml"/>
  96       <xi:include href="xml/glk-fileref-other.xml"/>
  97     </chapter>
  98
  99     <!-- Chapter 7. Graphics -->
 100 <!--    <chapter>
 101       <title>Graphics</title>
 102       <xi:include href="xml/glk-image-resources.xml"/>
 103       <xi:include href="xml/glk-graphics-windows.xml"/>
 104       <xi:include href="xml/glk-graphics-text.xml"/>
 105       <xi:include href="xml/glk-graphics-testing.xml"/>
 106     </chapter>
 107 -->
 108     <!-- Chapter 8. Sound -->
 109 <!--    <chapter>
 110       <title>Sound</title>
 111       <xi:include href="xml/glk-sound-channels.xml"/>
 112       <xi:include href="xml/glk-playing-sounds.xml"/>
 113       <xi:include href="xml/glk-sound-other.xml"/>
 114       <xi:include href="xml/glk-sound-testing.xml"/>
 115     </chapter>
 116 -->
 117     <!-- Chapter 9. Hyperlinks -->
 118 <!--    <chapter>
 119       <title>Hyperlinks</title>
 120       <xi:include href="xml/glk-creating-hyperlinks.xml"/>
 121       <xi:include href="xml/glk-accepting-hyperlinks.xml"/>
 122       <xi:include href="xml/glk-hyperlinks-testing.xml"/>
 123     </chapter>
 124 -->
 125     <!-- Chapter 10. Porting, Adapting and Other Messy Bits -->
 126     <xi:include href="glk-porting.sgml"/>
 127
 128     <!-- Chapter 11. Appendices -->
 129     <appendix>
 130       <title>The Dispatch Layer</title>
 131       <xi:include href="dispatch.sgml"/>
 132       <xi:include href="xml/dispatch-interrogating.xml"/>
 133       <xi:include href="xml/dispatch-dispatching.xml"/>
 134       <xi:include href="xml/dispatch-prototypes.xml"/>
 135       <xi:include href="xml/dispatch-library-functions.xml"/>
 136       <xi:include href="dispatch-selectors.sgml"/>
 137     </appendix>
 138
 139     <appendix>
 140       <title>The Blorb Layer</title>
 141       <xi:include href="blorb.sgml"/>
 142       <xi:include href="xml/blorb-program.xml"/>
 143       <xi:include href="blorb-library.sgml"/>
 144       <xi:include href="xml/blorb-layer.xml"/>
 145       <xi:include href="xml/blorb-errors.xml"/>
 146     </appendix>
 147
 148     <appendix>
 149      <title>Glk Extensions</title>
 150      <xi:include href="xml/glkext-startup.xml"/>
 151      <xi:include href="xml/glkext-unix.xml"/>
 152     </appendix>
 153   </reference>
 154 </book>