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 [EMAIL PROTECTED]
with "unsubscribe freebsd-hackers" in the body of the message
