<varlistentry>

      <term>Two spaces at the end of sentences</term>

      <listitem>

	<para>Always use two spaces at the end of sentences, as this

	  improves readability, and eases use of tools such as

	  <application>emacs</application>.</para>

	<para>While it may be argued that a capital letter following

	  the end of sentence period, this is not the case, especially

	  in name usage.  <quote>Jordan K. Hubbard</quote> is a good

	  example; it has a capital <literal>H</literal> following a

	  period and a space, and there certainly isn't a new sentence

	  there.</para>

      </listitem>

    </varlistentry>

    </sect2>

    <sect2>

      <title>Tag style</title>

      <sect3>

	<title>Tag spacing</title>

	<para>Tags that start at the same indent as a previous tag

	  should be separated by a blank line, and those that are not

	  at the same indent as a previous tag should not:</para>

<informalexample>

<programlisting>

<![ CDATA [

<article>

  <artheader>

    <title>NIS</title>

    <pubdate>October 1999</pubdata>

    <abstract>

      <para>...

	...

	...</para>

    </abstract>

  </artheader>

  <sect1>

    <title>...</title>

    <para>...</para>

  </sect1>

  <sect1>

    <title>...</title>

    <para>...</para>

  </sect1>

</article>

]]>

</programlisting>

</informalexample>

      </sect3>

      <sect3>

	<title>Special tags</title>

	<para>Some tags just don't follow the indenting rules of the

	  previous section; <sgmltag>screen</sgmltag> and

	  <sgmltag>programlisting</sgmltag> should always be

	  left-aligned.</para>

<informalexample>

<programlisting>

<![ CDATA [

<informalexample>

<programlisting>

…

</programlisting>

</informalexample>

]]>

</programlisting>

</informalexample>

	<para><sgmltag>informalexample</sgmltag> also should be

	  left-aligned when it wraps a <sgmltag>screen</sgmltag> or

	  <sgmltag>programlisting</sgmltag>.</para>

	<para>These examples should be separated from the rest of the

	  content by a blank line before and after.</para>

      </sect3>

      <sect3>

	<title>Separating tags</title>

	<para>Tags like <sgmltag>itemizedlist</sgmltag> which will

	  always have further tags inside them, and in fact don't take

	  character data themselves, are always on a line by

	  themselves.</para>

	<para>Tags like <sgmltag>para</sgmltag> and

	  <sgmltag>term</sgmltag> don't need other tags to contain

	  normal character data, and their contents begin immediately

	  after the tag, <emphasis>on the same line</emphasis>.</para>

	<para>The same applies to when these two types of tags

	  close.</para>

	<para>This leads to an obvious problem when mixing these

	  tags.</para>

	<para>When a starting tag which cannot contain character data

	  directly follows a tag of the type that requires other tags

	  within it to use character data, they are on separate lines.

	  The second tag should be properly indented.</para>

	<para>When a tag which can contain character data closes

	  directly after a tag which cannot contain character data

	  closes, they co-exist on the same line.</para>

      </sect3>