Date: Thu, 12 Jul 2001 02:45:03 -0700 From: Dima Dorfman <dima@unixfreak.org> To: Rahul Siddharthan <rsidd@physics.iisc.ernet.in> Cc: doc@freebsd.org Subject: Re: Spacing (again) in handbook with netscape Message-ID: <20010712094503.D40C33E2F@bazooka.unixfreak.org> In-Reply-To: <20010712110323.G42931@lpt.ens.fr>; from rsidd@physics.iisc.ernet.in on "Thu, 12 Jul 2001 11:03:23 %2B0200"
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010712094503.D40C33E2F>