From owner-freebsd-doc  Sat Apr 29 09:34:58 1995
Return-Path: doc-owner
Received: (from majordom@localhost)
          by freefall.cdrom.com (8.6.10/8.6.6) id JAA28784
          for doc-outgoing; Sat, 29 Apr 1995 09:34:58 -0700
Received: from grendel.csc.smith.edu (grendel.csc.smith.edu [131.229.222.23])
          by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id JAA28776
          for <doc@freebsd.org>; Sat, 29 Apr 1995 09:34:53 -0700
Received: from localhost (jfieber@localhost) by grendel.csc.smith.edu (8.6.5/8.6.5) id MAA12218; Sat, 29 Apr 1995 12:35:54 -0400
From: jfieber@cs.smith.edu (John Fieber)
Message-Id: <199504291635.MAA12218@grendel.csc.smith.edu>
Subject: Re: having some troubles...
To: pvinci@ix.netcom.com (Paul Vinciguerra)
Date: Sat, 29 Apr 1995 12:35:53 -0400 (EDT)
Cc: doc@freebsd.org
In-Reply-To: <199504290437.VAA29892@ix4.ix.netcom.com> from "Paul Vinciguerra" at Apr 28, 95 09:37:24 pm
Content-Type: text
Content-Length: 2462      
Sender: doc-owner@freebsd.org
Precedence: bulk

Paul Vinciguerra writes:
> &rsgq ,&lsqb don't work and [] work *sometimes* 8^)  

That should be &rsqb; and &lsqb; and I just checked and the do
work for me...

> sgmlformat doesn't work right ...
> 
> compile config.sgml (attached) as -html and as -ascii then look at the 
> CPU section...  Where did the lines on the .txt version go?

See below.

> <sect><heading>What goes in the config file?</heading><p></p>
>       <sect1><heading>Global parameters</heading><p>
> A system configuration file must contains the following:
> <itemize>
> <item> <ref id="machine" name="Machine Type"></item> 
> <item> <ref id="cpu" name="CPU Type"></item>
> <item> <ref id="sysid" name="System Identification"></item>
> <item> <ref id="maxusers" name="Maximum number of users"></item>
> </itemize></p>

The creation of "mini-menus" should be left to the processing
program.  As you will see in the latest sgmlformat incartation,
this menu becomes redundant in the HTML output.

> .. or a single kernel can be built to run on any of multiple CPU's

Lines starting with a period trip up the ascii output because it
goes through groff.  This is a bug but until it is fixed, just be
careful to avoid this.

> <quote>
> config <em>kernel</em> <newline>
>      root [on] <em>root-device</em><newline>
>      swap [on] <em>swap-device</em> and  <em>swap-device</em> 
> ..<newline>
>      dumps [on] <em>dump-device</em><newline>
>      args [on] <em>arg-devide</em><newline>
> </quote>

Ditto.

> <sect1><heading> Options</heading><p>
> The options directive instructs the compiler to include optional code 
> in the kernel.  For example:<newline><verb>
> options		"CHILD_MAX=128"
> options		"OPEN_MAX=128"
> options		MATH_EMULATE		#Support for x87 emulation
> #options        GPL_MATH_EMULATE        #Support for x87 emualtion via
> options		"COMPAT_43"

[etc...]

This need to be laced with text describing what the options are
for and why one might want them in their kernel.

> <sect1><heading>Device Specification</heading><p>

And same here.

> If you're going to run PPP you need to add the following lines:
> <verb>
> pseudo-device	ppp	2		#Point-to-point protocol
> </verb>or if it's synchronous PPP, use:<verb>

This last line causes a problem (although it shouldn't). Just
insert a carriage return after the </verb>.

-john

=== jfieber@cs.smith.edu ================================================
=================================== Come up and be a kite!  --K. Bush ===