Amiga.org

Operating System Specific Discussions => Amiga OS => Amiga OS -- Development => Topic started by: pjhutch on June 28, 2003, 03:55:16 PM

Title: New AOS Reference docs?!
Post by: pjhutch on June 28, 2003, 03:55:16 PM

How many people would be interested in developing new reference documentation on AmigaOS?

RKRM is ok as a reference but its a little dry and lacks any decent example code. Example code helps a lot when understanding APIs.

If you like I might start with Intuition, Graphics, Gadtools and Reaction.

Comments to pjhutch@pcguru.plus.com

http://www.pcguru.plus.com/

Title: Re: New AOS Reference docs?!
Post by: jahc on July 12, 2003, 06:46:38 AM

Someone has made a book with tutorials and examples for just about everything I believe, but hes waiting until OS 4.0 comes out before releasing it..

amigabooks.org ?

Title: Re: New AOS Reference docs?!
Post by: DaveP on July 12, 2003, 07:35:13 AM

Far from everything, but its a start. And yep.

Plus we are also going to serialise prerequisite knowledge in Total Amiga Magazine, if my writing skills are up to it.

Title: Re: New AOS Reference docs?!
Post by: pjhutch on July 12, 2003, 02:08:01 PM

If someone is already on it then there isn`t much point me doing it? There are no books or PDFs available anymore on Amiga stuff.

What subject areas are people interested it?
Workbench/AmigaOS, Programming, Harware, Software?

Having it in PDF format may make more economic sense as its a widely used format and people can print it if they wanted.

Title: Re: New AOS Reference docs?!
Post by: DaveP on July 12, 2003, 02:09:52 PM

It cant hurt to have more than one perspective.

Title: Re: New AOS Reference docs?!
Post by: on July 12, 2003, 02:13:19 PM

Quote

DaveP wrote:
It cant hurt to have more than one perspective.

Competition being good afterall eh Dave? ;-)

Title: Re: New AOS Reference docs?!
Post by: DaveP on July 12, 2003, 02:16:37 PM

Competition is great. Never ever said otherwise.

Sometimes readers click with one author and not another, the important point is information gets across to those that need it.

Title: Re: New AOS Reference docs?!
Post by: on July 12, 2003, 02:20:21 PM

Quote

DaveP wrote:
Competition is great. Never ever said otherwise.

Sometimes readers click with one author and not another, the important point is information gets across to those that need it.

Couldn't agree more.  It's a shame that it's near impossible to buy a full set of RKRM's now.  They are bloody good books.  Best technical reference manuals I've ever read.

Title: Re: New AOS Reference docs?!
Post by: iamaboringperson on July 12, 2003, 10:31:06 PM

id like to help :-)

AmigaOS does need a good up to date reference that is compareable to RKRM's

Quote

If you like I might start with Intuition, Graphics, Gadtools and Reaction.

probably Intuition, and IDCMP msg handling - user interface stuff

start from the more essential things and work your way out
...you might find that the last thing you focus on is layers.library perhaps :-P

Title: Re: New AOS Reference docs?!
Post by: pjhutch on July 14, 2003, 05:45:06 PM

Thanks for comments guys.

BTW, What format would you prefer?
Amigaguide, HTML or PDF. The last 2 are my preferences.

Title: Re: New AOS Reference docs?!
Post by: Crumb on July 14, 2003, 07:42:08 PM

I think there are programas to convert HTML code to AmigaGuide... I think that it should be made in HTML and later converted to PDF and AmigaGuide...

Title: Re: New AOS Reference docs?!
Post by: Santa on July 14, 2003, 09:33:23 PM

I have an original set oF RKMs (except the hardware guide). They are still very interesting. Though they're of not much use to me nowadays.
Anyway, Amiga has to grow considerably, until we get something like this.
Santa

Title: Re: New AOS Reference docs?!
Post by: iamaboringperson on July 15, 2003, 02:29:10 AM

Quote

pjhutch wrote:
Thanks for comments guys.

BTW, What format would you prefer?
Amigaguide, HTML or PDF. The last 2 are my preferences.

.PDF is a must
and a series of text files would also be good, since they will work with any (electronic)computer