Date: Fri, 21 Jul 2000 08:10:04 -0700 (PDT) From: Udo Erdelhoff <ue@nathan.ruhr.de> To: freebsd-doc@freebsd.org Subject: Re: docs/20056: Bad SGML in the "@ sign" entry of the FAQ Message-ID: <200007211510.IAA76766@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/20056; it has been noted by GNATS. From: Udo Erdelhoff <ue@nathan.ruhr.de> To: Ben Smithurst <ben@FreeBSD.org> Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/20056: Bad SGML in the "@ sign" entry of the FAQ Date: Fri, 21 Jul 2000 17:02:36 +0200 Hi Ben, my apologies for the late answer, but I wanted to have lots of sleep before I tried to unravel this mess. > > The html-tag pre indicates preformatted text and both Netscape 4 and the > > Preview 1 of Netscape 6 (I admit my sin: Yes, I'm using Windows 98, too) > > indent this text. > > Yes. That's what I see too. Duh. I assumed your statement "the whitespace is not neccessary" meant "the whitespace is ignored". Repeat after me: "assume makes an ass out of u and me" :-( > About what? <programlisting> without the leading white space produces an > indent, are you saying the other formats get this wrong? I compared the indent created by the old version (literallayout) with the new version (programlisting). The default indentation created by <programlisting> (or, to be precise, created by the corresponding HTML code) is much smaller than the indentation created by <literallayout>. I added the additional whitespace to have an almost identical amount of indentation in the new version. BTW: I've found another instance of the original problem: There's a <\@> a few entries later. The patch replaces <\@> with <\@> While I'm here :-) - replace <ulink ...man.cgi>/etc/remote</ulink> with <filename>... - replace <emphasis remap=tt>-Elements with <literal>-elements - replace <literallayout>-elments with <programlisting>-elements - remove the useless <para>-elements around the <programlisting>-elements; this change removes two tidy-warnings - replace the first instance of <ulink..man.cgi>tip</ulink> with &man.tip.1; - replace the second instace of this element with <command>tip</command> and add a command-element around the while of "in a while loop". --- book.sgml.orig Fri Jul 21 16:17:22 2000 +++ book.sgml Fri Jul 21 16:32:40 2000 @@ -8368,30 +8368,26 @@ <para>This is often a problem where a university has several modem lines and several thousand students trying to use them...</para> -<para>Make an entry for your university in <ulink URL="http://www.FreeBSD.org/cgi/man.cgi?remote">/etc/remote</ulink>; -and use <emphasis remap=tt><\@></emphasis> for the <emphasis remap=tt>pn</emphasis> capability:</para> +<para>Make an entry for your university in <filename>/etc/remote</filename> +and use <literal><\@></literal> for the <literal>pn</literal> capability:</para> -<para> -<literallayout> big-university:\ +<programlisting> big-university:\ :pn=\@:tc=dialout dialout:\ :dv=/dev/cuaa3:br#9600:at=courier:du:pa=none: - </literallayout> -</para> +</programlisting> <para>Then, list the phone numbers for the university in -<ulink URL="http://www.FreeBSD.org/cgi/man.cgi?phones">/etc/phones</ulink>:</para>; +<filename>/etc/phones</filename>:</para> -<para> -<literallayout> big-university 5551111 +<programlisting> big-university 5551111 big-university 5551112 big-university 5551113 big-university 5551114 - </literallayout> -</para> +</programlisting> -<para><ulink URL="http://www.FreeBSD.org/cgi/man.cgi?tip">tip</ulink>; will try each one in the listed order, then give up. If -you want to keep retrying, run <emphasis remap=tt>tip</emphasis> in a while loop.</para> +<para>&man.tip.1; will try each one in the listed order, then give up. If +you want to keep retrying, run <command>tip</command> in a <command>while</command> loop.</para> </answer></qandaentry> /s/Udo 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?200007211510.IAA76766>