[News] New AmigaOS 4.0 ROM Kernal Reference Manuals in the works! | ANN.lu |
Posted on 24-Apr-2002 16:18 GMT by P Ericson | 86 comments View flat View list |
In a recent interview with Hyperion Software, we're told that Olaf "Olsen" Barthel is working on new ROM Kernal Reference Manuals for AmigaOS 4.0! [The "RKRM" books are the official and prime development documentation/tutorial for AmigaOS developers] As some readers of Amiga Network News may already know, Mr Barthel has previously compiled the Amiga Developer's CD.
|
|
List of all comments to this article |
New AmigaOS 4.0 ROM Kernal Reference Manuals in the works! : Comment 61 of 86 | ANN.lu |
Posted by .jon on 25-Apr-2002 21:22 GMT | In reply to Comment 32 ([JC]): >> But please ignore the suggestion to change the autodoc format into whatever
>> icrofilth uses, the current Amiga autodoc format is fine."
> You're a typical short-sighted Amiga wanker who needs to die.
>
> I have developed for quite a few years on AmigaOS (in 68k assembler), and yes,
> AmigaGuide was good in it's day, but something better for modern systems is needed.
> Have you ever even used MSDN ? 0r CHTML based SDK references ? No ? Then shut up.
>
> AmigaGuide does not have embedded pictures. It does not have a good search function.
> It does not have support for web/file links. There are many things it does not have
> that modern formats like CHTML and PDF do.
>
> As for PDF, well PDF is cumbersome for development docs, since as this is pretty
> much what Apple provide thier SDK docs as. I prefer CHTML or plain old HTML -
> CHTML just has the advantage of being a compound file with an index that is easily
> searchable.
No, the idiot is *YOU* !
It is clear, that you have no real insight about good developer documentation formats.
To recommend HTML as a reference to any API is plain silly. I will tell you why:
a) HTML is NOT searchable
In order to do a search on HTML you need either
a) complicated scripts
or
b) full-text-search engine (add a web-server)
or
c) a special browser (which makes no sense, since a browser is only
a frontend, you still need a machinery to index the HTML docs.
b) HTML adds much too much overhead
c) HTML is cluttered up on many many files, making indexing even more difficult,
even if newer HTML revisions offer indexing support up to some point.
d) HTML will lead to ECMAScript and Java and whatever in the API reference, somthing
desirable, if used with a clue, but most likely it will be used clueless.
PDF is NO CHOICE AT ALL ! The only thing PDF is good for is for printing. Period.
I have a strong feeling you have never used anything like LaTeX (or Texinfo) nor do you
know anything about the benefits of easily to index documents (such as the Autodocs), when
indexed with binary (fast) indizies through a shared library (which is so nice, since I can
lookup any Autodoc (and Include, UNIX MAN and any AmigaGuide) in my editor as well
as have auto-completion from these indizies.
All you did in your comment was to insult a "purist" (who usually do quite good programming
in my experience...) and showed you have absolutely no clue.
If you _would_ have a clue you would have proposed some low-level document-format (as is the
Autodoc or Texinfo) since you then would know, that these can be converted into
a) HTML
b) Postscript
c) PDF
e) DVI
f) GNU Info
g) Amigaguide
h) several other Linux/UNIX formats
and are (one of the most important things for _any_ reference) easily indexable/searchable.
But you just have no clue. |
|
List of all comments to this article (continued) |
|
- User Menu
-
- About ANN archives
- The ANN archives is powered by #AmigaZeux. It was updated daily (news last: 22-Oct-2004; comments last: 18-May-2005).
ANN.lu was created, previously owned and maintained by Christian Kemp, www.ckemp.com.
- Contribute
- Not possible at this time!
- Search ANN archives
- Advanced search
- Hosting
- ANN.lu was hosted by Dreamhost. Sign up through this link, mention "ckemp" as referrer and he will get a 10% commission on any account you purchase.
Please show your appreciation for any past, present and future work on ANN.lu by making a contribution via PayPal.
|