Date: Wed, 29 Nov 2000 12:31:19 -0600 From: "G. Adam Stanislav" <adam@whizkidtech.net> To: Nik Clayton <nik@FreeBSD.ORG> Cc: hackers@FreeBSD.ORG Subject: Re: int80h.org Message-ID: <20001129123119.A1594@whizkidtech.net> In-Reply-To: <20001127151802.A7983@canyon.nothing-going-on.org>; from nik@FreeBSD.ORG on Mon, Nov 27, 2000 at 03:18:02PM %2B0000 References: <20001126231649.A278@whizkidtech.net> <20001127151802.A7983@canyon.nothing-going-on.org>
next in thread | previous in thread | raw e-mail | index | archive | help
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 <b><i>text</b></i>. Instead, you just type ^b^i(text), and HED converts it to <b><i>text</i></b>. 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: <code>This is some code.</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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20001129123119.A1594>