From owner-freebsd-hackers Wed Nov 29 10:33:14 2000 Delivered-To: freebsd-hackers@freebsd.org Received: from whizkidtech.net (r23.bfm.org [216.127.220.119]) by hub.freebsd.org (Postfix) with ESMTP id EA91037B400; Wed, 29 Nov 2000 10:33:08 -0800 (PST) Received: (from adam@localhost) by whizkidtech.net (8.9.2/8.9.2) id MAA01610; Wed, 29 Nov 2000 12:31:50 -0600 (CST) (envelope-from adam) Date: Wed, 29 Nov 2000 12:31:19 -0600 From: "G. Adam Stanislav" To: Nik Clayton Cc: hackers@FreeBSD.ORG Subject: Re: int80h.org Message-ID: <20001129123119.A1594@whizkidtech.net> References: <20001126231649.A278@whizkidtech.net> <20001127151802.A7983@canyon.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <20001127151802.A7983@canyon.nothing-going-on.org>; from nik@FreeBSD.ORG on Mon, Nov 27, 2000 at 03:18:02PM +0000 Organization: Whiz Kid Technomagic X-URL: http://www.whizkidtech.net/ X-Castle: http://www.redprince.net/ X-Special-Effects: http://www.FilmSFX.com/ X-Operating-System: FreeBSD whizkidtech.net 3.1-RELEASE FreeBSD 3.1-RELEASE Sender: owner-freebsd-hackers@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG On Mon, Nov 27, 2000 at 03:18:02PM +0000, Nik Clayton wrote: >> If curious, you can read it even now. If your browser cannot locate >> int80h.org yet (it should tomorrow), you can find the same page as >> http://www.whizkidtech.net/int80h.hed for now. > >It certainly looks interesting. > >One thing though -- have you considered DocBook as the documentation >format? I'm considering it now. :) I'm taking a look at the tutorial, and will attempt to use the format. Not for everything on the site, mind you, but a formal tutorial in FreeBSD assembly language is something we need (IMHO), so I'll give it a shot. BTW, the site is up, so use http://www.int80h.org/ from now on please. It still only contains the intro page, mostly because I am studying your tutorial first. I don't want to write the same pages twice. :) Oh, another thing: I use UTF-8 for everything. Is that OK as far as docproj is concerned? I still intend to create the originals using HED (not released yet) and write them in my new Ister Mark-up Language. HED can convert it to the SGML format the docproj requires. Until I have finished the documentation for Ister Mark-up Language (geez, so many projects running at the same time), I have made the source code for my home page availble for viewing as http://www.whizkidtech.net/source.hed Feel free to take a look at it, and send me any comments. Now that I'm studying your tutorial, I want to make sure Ister/HED supports everything docproject might need, to make the creation of documentation as easy as possible. Ister simplifies things because it prevents typos like text. Instead, you just type ^b^i(text), and HED converts it to text. In other words, you only type each tag once and place the text in parentheses, and the software produces the proper HTML/SGML/XML out of it. Plus, you can use environmental variables, declare them, too, so you can do something like: % = [C] [^code] # Declare $C to mean "^code" $C (This is some code.) Then you get: This is some code. Cheers, Adam -- When two do the same, it's not the same -- Slovak proverb To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message