Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 25 Jun 1996 08:19:29 -0500 (EST)
From:      John Fieber <jfieber@indiana.edu>
To:        Francisco Reyes <reyes01@ibm.net>
Cc:        doc@freebsd.org
Subject:   hardware disarray in handbook
Message-ID:  <Pine.BSF.3.94.960625075623.10130E-100000@Fieber-John.campusview.indiana.edu>
In-Reply-To: <199606251151.LAA54389@pop01.ny.us.ibm.net>

next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, 25 Jun 1996, Francisco Reyes wrote:

> John I sent, twice, an email to you and to the freebsddoc.
> I never got an answer from the freebsdoc. Let me know
> if you get this message or if you got the previous ones.

Yes I got them, just busy. :)

Basically, we have two hardware sections in the handbook.  The
first is a terse listing of supported hardware, the second is a
collection of essays, notes, observations and tips about various
bits of hardware.  I'm not entirely satisfied with the current
arrangement and have been pondering ways to merge the two.  My
general idea is to have each section laid out something like:

1.1  CDROM

1.1.1  Supported

  In 2.0
   SCSI
   ...

  Added in 2.1
   SoundBlaster
   ...

  Added in -current
   IDE
   ...

1.1.2  Notes/quirks

  (Commentary, hints and tips. Some entries in 1.1.1 may link
   directly to sections in here.)

1.2  Sound Cards

1.2.1  Supported

...

In a way, the current slit is nice because the supported hardware
list is quite compact, but I think the above would be nearly as
effective.  It also deals with "what version supports what?"
question and makes this section of the handbook itself version
neutral.

What doesn't fit in are the excellent but long essays such as
SCSI which covers a broad range of topics including controllers,
disks, tapes, cdroms and the like.  Maybe we can push them into
the "Advanced Topics" section and place cross references in the
general hardware section.

The other section that gets tangled up with hardware is the
kernel config.  In particular, what the driver names are and
typical kernel config entries for them.  In the hardware section
or the kernel config section?

-john

== jfieber@indiana.edu ===========================================
== http://fallout.campusview.indiana.edu/~jfieber ================




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.BSF.3.94.960625075623.10130E-100000>