tools.sgml

<!-- -*- sgml -*- -->
 <chapter id="tools">
  <title>
   Tools
  </title>

  <para>
   The &sdb; is held together by magic <command>sed</command> glue,
   which is activated by some rules in the
   <link linkend="Makefile">Makefile</link> in <xref
   linkend="source">.  So, in order to build the &sdb; you will need
   <command>make</command> and <command>sed</command> (and also
   <command>fold</command>).  Note that <command>sed</command> and
   <command>fold</command> won't be necessary for all SGML projects,
   but using a <filename>Makefile</filename> is usually a good idea.
  </para>

  <para>
   To have a functioning SGML environment, you will need to have
   various programs installed.  On a Red Hat Linux 7.1 system, the
   <literal>sgml-common</literal>, <literal>openjade</literal>,
   <literal>jadetex</literal>, <literal>docbook-style-dsssl</literal>,
   <literal>perl-SGMLSpm</literal>, and <literal>docbook-utils</literal>
   packages should be installed, as well as the packages whose names
   begin with <literal>docbook-dtd</literal>.
  </para>

  <para>
   I use an <command>emacs</command> package called
   <literal>psgml</literal> for editing SGML documents.  The
   keybindings I find most useful are:
  </para>

  <itemizedlist>
   <listitem>
    <para>
     <keycap>Tab</keycap> indents the current element to a level
     appropriate to its nesting depth.
    </para>
   </listitem>

   <listitem>
    <para>
     <keycombo action=seq>
      <keycombo action=simul>
       <keycap>
        Control
       </keycap>
       <keycap>
        C
       </keycap>
      </keycombo>
      <keycombo action=simul>
       <keycap>
        Control
       </keycap>
       <keycap>
        T
       </keycap>
      </keycombo>
     </keycombo> lists the valid tags for the current element.
    </para>
   </listitem>

   <listitem>
    <para>
     <keycombo action=seq>
      <keycombo action=simul>
       <keycap>
        Control
       </keycap>
       <keycap>
        C
       </keycap>
      </keycombo>
      <keycap>
       /
      </keycap>
     </keycombo> closes the current element.
    </para>
   </listitem>
  </itemizedlist>
 </chapter>

<!-- Local Variables: -->
<!-- sgml-indent-step: 1 -->
<!-- sgml-indent-data: 1 -->
<!-- sgml-parent-document: "selfdocbook.sgml" -->
<!-- End: -->