From owner-freebsd-doc  Tue Oct 12 13:55:17 1999
Delivered-To: freebsd-doc@freebsd.org
Received: from server.baldwin.cx (jobaldwi.campus.vt.edu [198.82.67.146])
	by hub.freebsd.org (Postfix) with ESMTP id BDE0314C32
	for <freebsd-doc@freebsd.org>; Tue, 12 Oct 1999 13:55:13 -0700 (PDT)
	(envelope-from jobaldwi@vt.edu)
Received: from john.baldwin.cx (john [10.0.0.2])
	by server.baldwin.cx (8.9.3/8.9.3) with ESMTP id QAA01456;
	Tue, 12 Oct 1999 16:55:00 -0400 (EDT)
	(envelope-from jobaldwi@vt.edu)
Message-Id: <199910122055.QAA01456@server.baldwin.cx>
X-Mailer: XFMail 1.3.1 [p0] on FreeBSD
X-Priority: 3 (Normal)
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 8bit
MIME-Version: 1.0
In-Reply-To: <199910121850.LAA11470@freefall.freebsd.org>
Date: Tue, 12 Oct 1999 16:55:00 -0400 (EDT)
From: John Baldwin <jobaldwi@vt.edu>
To: Neil Blakey-Milner <nbm@mithrandr.moria.org>
Subject: Re: docs/14248: codify proposed style
Cc: freebsd-doc@freebsd.org
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


On 12-Oct-99 Neil Blakey-Milner wrote:
>  Similarly:
>  
>  <para>Somehow the next list is in this para
>    <itemizedlist>
>      <listitem>
>        <para>Survival</para>
>      </listitem>
>      <listitem>
>        <para>Self-actualisation</para>
>      </listitem>
>    </itemizedlist></para>
>  
>  Where else would you like to put that closing tag?  I don't like
> this
>  way too much either.

I just never put <footnote>'s or <list>'s inside of <para>'s,
personally.  Instead I would have done:

<para>Here we go!</para>

<footnote>
  <para>Well, not quite.</para>
</footnote>

This avoids the ugliness you noticed.  If you must include a tag, then
yes, the </para> is appended to it:

<para>This is is a sentence with a link that is a run-on because it is
  missing a period: <url link="http://www.FreeBSD.org/">Cool
  Stuff</url></para>

>  Neil
>  -- 
>  Neil Blakey-Milner
>  nbm@rucus.ru.ac.za

---

John Baldwin <jobaldwi@vt.edu> -- http://www.cslab.vt.edu/~jobaldwi/
PGP Key: http://www.cslab.vt.edu/~jobaldwi/pgpkey.asc
"Power Users Use the Power to Serve!"  -  http://www.FreeBSD.org/


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message