DOCBOOK: <*list> In or After <para>?

[Holger Rauch <Holger.Rauch@heitec.de>]

Hi!

There seem to be two choices when it comes to <*list> elements
(<itemizedlist>, <orderedlist>, etc.).

My questions:

1. Which of the following two ways is the "right" way to do this?
2. Is it desirable to use <para>s inside <listitem>s or should one try to
use just <listitem>s (without the <para>s inside)?

1. Put it INSIDE a <para>, like this

	<para>
	  This paragraph contains some text
          <itemizedlist>
            <listitem>
              <para>
                First item
              </para>
            </listitem>
            <listitem>
              <para>
                Second item
              </para>
            </listitem>
          <itemizedlist>
        </para>

2. Put it AFTER a <para>, like this

        <para>
          This paragraph contains some text
        </para>
        <itemizedlist>
          <listitem>
            <para>
              First item
            </para>
          </listitem>
          <listitem>
            <para>
              Second item
            </para>
          </listitem>
        <itemizedlist>

Thanks for your help!

Greetings,

	Holger