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>