Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 18 Oct 2002 08:35:11 +0200
From:      Udo Erdelhoff <ue@nathan.ruhr.de>
To:        freebsd-doc@FreeBSD.ORG
Subject:   Re: Please review: new handbook chapter on serial install
Message-ID:  <20021018063510.GB74874@nathan.internal>
In-Reply-To: <20021018003454.A20983@sumuk.de>
References:  <20021015195849.GA76747@nathan.internal> <20021017210306.GA74874@nathan.internal> <20021018003454.A20983@sumuk.de>

next in thread | previous in thread | raw e-mail | index | archive | help
Hi,
On Fri, Oct 18, 2002 at 12:34:54AM +0200, Martin Heinen wrote:
> > +	only change is the addition of a
> > +	<filename>boot.config</filename> file on the boot floppy.  The
> 
> It's common handbook style, but why tell the reader that boot.config
> is file if we already markup <filename>boot.config</filename>?

<filename>boot.config</filename> (that should be /boot.config) does
not look that much different from <varname>boot.config</varname> in
the output with the current docbook.css.
 
> UFS file system doubles 'file system'.  UFS partition might be a
> better choice.

Partition is for DOS :) I agree about the duplication part, I'll just
replace UFS by standard here.

> > +	<step>
> > +	  <para>Connect your serial console to the new FreeBSD system,
> > +	    just as explained above.</para>
> 
> Above might be far away, it should be link to the appropriate section
> or completely left out (the link already appeared above).

About 600-700 lines of SGML source.  One of the references I missed
 
> > +      <para>After a while, you should see activity on your serial
> > +	console, probably the <quote>spiner</quote>, followed by the
> 
> s!spiner!spinner! as noted by Giorgos :-)

Grr, still spelled that word wrong on the second try (but at least
it's a different mistake this time).

> > +4 ...................... FreeBSD system console (monochrome).
> > +
> ^^^^^^^^
> Is there really a blank line?

Yup - and I have no clue why.
 
> > +	  <para>In order to allow log-ins over the serial console, a
> > +	    &man.getty.8; must be running on the
> > +	    <devicename>ttyd0</devicename>.  To do this, select
> > +	    <literal>Configuration</literal>, then
> > +	    <literal>TTYs</literal>, and change the settings for
> 
> We could markup Configuration and TTYs with <menuentry>
> or <guimenuitem>.

Well, sysinstall is anything but graphical user interface, so 
menuentry is the better choice.
 
/s/Udo
-- 
"When faced with a choice between evils, I always pick the one I haven't
tried before." -- Mae West

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?20021018063510.GB74874>