From owner-freebsd-doc Wed Jun 6 21:37:54 2001 Delivered-To: freebsd-doc@freebsd.org Received: from mail.bfm.org (mail.bfm.org [216.127.218.26]) by hub.freebsd.org (Postfix) with ESMTP id 3AEC537B403 for ; Wed, 6 Jun 2001 21:37:51 -0700 (PDT) (envelope-from adam@whizkidtech.net) Received: from WhizKid (rh22.bfm.org [216.127.220.215]) by mail.bfm.org (Post.Office MTA v3.5.3 release 223 ID# 0-52399U2500L250S0V35) with SMTP id org; Wed, 6 Jun 2001 23:41:46 -0500 Message-Id: <3.0.6.32.20010606233723.00e3fe00@mail85.pair.com> X-Sender: whizkid@mail85.pair.com X-Mailer: QUALCOMM Windows Eudora Light Version 3.0.6 (32) Date: Wed, 06 Jun 2001 23:37:23 -0500 To: Udo Erdelhoff , freebsd-doc@freebsd.org From: "G. Adam Stanislav" Subject: Re: Assembly language tutorial In-Reply-To: <20010606221044.A7392@nathan.ruhr.de> References: <20010604223101.A435@whizkidtech.net> <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: text/plain; charset="us-ascii" 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 At 22:10 06-06-2001 +0200, Udo Erdelhoff wrote: >Why do you use the full-fledged variant of creating links to manual pages? Because it's easier for me, while DocBook does not care. >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 As I said before, I originally wrote it as a tutorial for my web site. I used hed, a tool of my design that prevents me from making stupid HTML errors. It also cuts out all white space that HTML does not need, which makes it smaller and, thus, faster to transmit. That means I cannot add indentation to the output (I do have indentation in my source code). I only can force it to add extra line feeds. >I've already fixed the formatting and indentation (suppe plus some manual >fixes) as well as the citerefentry stuff. What's wrong with the citerefentry? Any changes you make to my sgml (which is produced by software, not by hand) will mean that whenever I make a small change, such as correcting a spelling error, the diff will be bigger than the file itself. Why does it *have to* be indented a certain way? No one reads the sgml, do they? Only the HTML, etc, produced by it. I have just spent two days writing a brief article using direct sgml and the style you like. I made a ton of errors such as blah (not the misspelling of the closing tag). I cannot make these errors in my own language, where I use brief variables. E.g., $emp(blah) will be automatically converted into blah when producing the sgml output, and to blah when producing the HTML output. If there is a filter that can reformat the sgml output on the fly (like tidy does for HTML), I am willing to use it, but other than that I am not about to reformat it by hand every time I change something. > I've put a snapshot online at >http://people.freebsd.org/~ue/x86-snapshot.sgml for fruther review. Well, this is what it looks like: Forbidden You don't have permission to access /~ue/x86-snapshot.sgml on this server. Adam --- http://phonecowboy.com/registrar/twist/ finds a good domain for you and checks for its existence. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message