From owner-freebsd-doc  Thu Jul 12  2:45: 7 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from bazooka.unixfreak.org (bazooka.unixfreak.org [63.198.170.138])
	by hub.freebsd.org (Postfix) with ESMTP id 4051F37B401
	for <doc@freebsd.org>; Thu, 12 Jul 2001 02:45:04 -0700 (PDT)
	(envelope-from dima@unixfreak.org)
Received: from hornet.unixfreak.org (hornet [63.198.170.140])
	by bazooka.unixfreak.org (Postfix) with ESMTP
	id D40C33E2F; Thu, 12 Jul 2001 02:45:03 -0700 (PDT)
To: Rahul Siddharthan <rsidd@physics.iisc.ernet.in>
Cc: doc@freebsd.org
Subject: Re: Spacing (again) in handbook with netscape 
In-Reply-To: <20010712110323.G42931@lpt.ens.fr>; from rsidd@physics.iisc.ernet.in on "Thu, 12 Jul 2001 11:03:23 +0200"
Date: Thu, 12 Jul 2001 02:45:03 -0700
From: Dima Dorfman <dima@unixfreak.org>
Message-Id: <20010712094503.D40C33E2F@bazooka.unixfreak.org>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org

Rahul Siddharthan <rsidd@physics.iisc.ernet.in> writes:
> Dima Dorfman said on Jul 12, 2001 at 01:54:02:
> > Rahul Siddharthan <rsidd@physics.iisc.ernet.in> writes:
> > > that is, if I include <screen></screen> within a <para> before closing
> > > the <para>.  In that case everything after the <screen> gets
> > > close-spaced when viewed in netscape.
> > > 
> > > Am I not supposed to do this?  Or is this just a bug with netscape?
> > 
> > <screen> should go outside of <para>, as it does it most (all?)
> > documents.  E.g.:
> > 
> > 	<para>Some text here</para>
> > 
> > 	<screen>Some screen stuff
> > is here</screen>
> > 
> > 	<para>More text</para>
> 
> I definitely disagree with that as a general statement (there is
> nothing wrong with "displayed text" in the middle of a paragraph, and
> mathematical equations are frequently displayed in the middle of a
> paragraph; a paragraph is a grammatical entity not a formatting
> one.)

If we were going to redo all of the documents to follow this paradigm,
I'd agree.  Since we're not, I think it's more important to remain
consistent.  And it's not that bad.  Although it's somewhat incorrect,
you'll often see things like this in our documents:

	<para>This is the begnning of our paragraph.  To get a listing
		   of a directory, we could use,</para>

	<screen>&prompt.user; <userinput>ls</userinput></screen>

	<para>although</para>

	<screen>&prompt.user; <userinput>emacs .</userinput></screen>

	<para>works too.  This is the conclusion of our paragraph.</para>

Those <screen>'s really belong inside the paragraph, but it doesn't
look too bad this way, even if it isn't entirely correct.

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