From owner-freebsd-doc Wed Jun 6 13:16:45 2001 Delivered-To: freebsd-doc@freebsd.org Received: from mail.ruhr.de (in-ruhr4.ruhr.de [212.23.134.2]) by hub.freebsd.org (Postfix) with SMTP id 3F4BF37B408 for ; Wed, 6 Jun 2001 13:16:40 -0700 (PDT) (envelope-from ue@nathan.ruhr.de) Received: (qmail 13586 invoked by uid 10); 6 Jun 2001 20:16:38 -0000 Received: (from ue@localhost) by nathan.ruhr.de (8.11.3/8.11.2) id f56KAid07838; Wed, 6 Jun 2001 22:10:44 +0200 (CEST) (envelope-from ue) Date: Wed, 6 Jun 2001 22:10:44 +0200 From: Udo Erdelhoff To: freebsd-doc@freebsd.org Cc: "G. Adam Stanislav" Subject: Re: Assembly language tutorial Message-ID: <20010606221044.A7392@nathan.ruhr.de> Mail-Followup-To: freebsd-doc@freebsd.org, "G. Adam Stanislav" References: <3.0.6.32.20010603215127.00a94100@mail85.pair.com> <20010604022322.B7096@meow.osd.bsdi.com> <20010604223101.A435@whizkidtech.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="gBBFr7Ir9EOA20Yy" Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20010604223101.A435@whizkidtech.net>; from adam@whizkidtech.net on Mon, Jun 04, 2001 at 10:31:01PM -0500 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org --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 as\ 1. 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