Date: Wed, 6 Jun 2001 22:10:44 +0200 From: Udo Erdelhoff <ue@nathan.ruhr.de> To: freebsd-doc@freebsd.org Cc: "G. Adam Stanislav" <adam@whizkidtech.net> Subject: Re: Assembly language tutorial Message-ID: <20010606221044.A7392@nathan.ruhr.de> In-Reply-To: <20010604223101.A435@whizkidtech.net>; from adam@whizkidtech.net on Mon, Jun 04, 2001 at 10:31:01PM -0500 References: <3.0.6.32.20010603215127.00a94100@mail85.pair.com> <20010604022322.B7096@meow.osd.bsdi.com> <20010604223101.A435@whizkidtech.net>
next in thread | previous in thread | raw e-mail | index | archive | help
--gBBFr7Ir9EOA20Yy Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Moin, On Mon, Jun 04, 2001 at 10:31:01PM -0500, G. Adam Stanislav wrote: > Ok, it's ready now. I have fixed all SGML errors and built a handbook > with it successfully. I have also added line breaks so the SGML code > is readable by humans. I couldn't resist to take a quick peek and have two comments: Why do you use the full-fledged variant of creating links to manual pages? &man.as.1; is way shorter than <citerefentry><refentrytitle>as\ </refentrytitle><manvolnum>1</manvolnum></citerefentry>. And there is a &man.foo.bar; for almost every single manpage on the system. And the formatting and indentation needed a couple pats with a hammer, please take a look at chapter 10.1 of the FDP primer. The URL is http://www.freeBSD.org/tutorials/docproj-primer/writing-style.html#AEN2973 > Again, the URL is http://www.int80h.org/bsdasm/x86.sgml and it is ready > to be committed. I've already fixed the formatting and indentation (suppe plus some manual fixes) as well as the citerefentry stuff. I've put a snapshot online at http://people.freebsd.org/~ue/x86-snapshot.sgml for fruther review. I thought about posting a diff, but the diff is longer than the document itself... /s/Udo --=20 One Unix to rule them all, One Resolver to find them, One IP to bring them all and in the zone to bind them. --gBBFr7Ir9EOA20Yy Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.4 (FreeBSD) Comment: For info see http://www.gnupg.org iQCVAwUBOx6OREPoh1XnT6hxAQFBxgP/dRieDDlgW/v3CmIJRKootteipPVVFlmu AXVVUhZ/whqqP1pan0ytf0b9gQS+EIv2r39QxHx2pjCMLlDUKNsOkjhl+S4GAFUj CLTQlWIR0H6Mt25oMyGVXOUNjW97DZMUNvsKoUcetql40XYhnjnBWfYgz/2L9OSb 34Glp8+h93E= =weBB -----END PGP SIGNATURE----- --gBBFr7Ir9EOA20Yy-- 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?20010606221044.A7392>