Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 30 Dec 2006 11:23:58 -0800
From:      "Bruce A. Mah" <bmah@freebsd.org>
To:        freebsd-doc@freebsd.org
Subject:   RFC:  Hardware notes rearrangement
Message-ID:  <4596BCCE.3030302@freebsd.org>

next in thread | raw e-mail | index | archive | help
This is an OpenPGP/MIME signed message (RFC 2440 and 3156)
--------------enig602CD9065AE9C9F25F4C7B55
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

About a month ago, I rearranged the hardware notes on CURRENT, in effect
coalescing the multiple machine-dependent (MD) documents that got
generated into a single machine-independent (MI) document.  Basically
it's easier to read and maintain this way.

I'd like some review on a similar reorg of the hardware notes (also on
CURRENT).

The goal is pretty much the same, although it turns out this was a lot
more work:

o Each architecture has some MD sections, which I put into second-layer
sections.

o There are a *lot* more arch=3D attributes in the hardware notes (around=

80) than in the release notes.  The conversion of these attributes is
very mechanical but as far as I can tell is not easily automated.  :-(

o The auto-generated device listings (where device lists are pulled out
of manpages) also handle the arch=3D attributes.  I have a patch to modif=
y
 this behavior in a halfway reasonable manner, although further hacking
is needed (right now, we drop the second column of dev.archlist.txt into
the hardware notes verbatim, but I'd really like to convert these to use
the SGML entities I've defined for this).

Also, as I'm reading through the hardware notes, there's a bunch of
information (particular in the "supported processor and motherboards")
section that could stand revising.  That's probably best taken care of
after this.

Preliminary work is here:

http://people.freebsd.org/~bmah/hardware2.tar.gz
http://people.freebsd.org/~bmah/hardware2.pdf

Comments greatly appreciated, particularly from those folks who have
worked on the auto-generated device listings.

Thanks and Happy New Year!

Bruce.


--------------enig602CD9065AE9C9F25F4C7B55
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: OpenPGP digital signature
Content-Disposition: attachment; filename="signature.asc"

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (FreeBSD)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFFlrzT2MoxcVugUsMRAkrYAJ9UlWhtoIS8tdmjAXU6lXIe27nqJgCgi4Z0
/mURKpo/MSyWWRX7B+PuuzY=
=amy1
-----END PGP SIGNATURE-----

--------------enig602CD9065AE9C9F25F4C7B55--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4596BCCE.3030302>