FreeLists / haiku-doc / [haiku-doc] Re: Messaging Introduction

["Axel Dörfler" <axeld@xxxxxxxxxxxxxxxx>]

Hi Niels,

"Niels Reedijk" <niels.reedijk@xxxxxxxxx> wrote:
> I just finished the first version of the messaging introduction of 
> the
> application kit
> (http://factory.haiku-os.org/documentation/Haiku_Book_doxygen/html/app_messaging.html).
> > It's not completely finished, but I think that finishing it only 
> makes
> sense after the individual classes have been documented. If there is
> anyone willing to pick up a messaging class from the application kit,
> please claim it. You can use my schematic display as a starting point
> (http://haiku-os.org/files/screenshots/Messaging_0.png).

I'm currently reading through the introduction. It looks nice overall, 
but I have the following comments:
* the last sentence of the first paragraph could be reworded, maybe 
like this: "The framework allows inter-application messaging as well as 
intra-application messaging, and it will always use the most effective 
mechanism for the communication automatically."
* The classes titles in the classes overview should probably be links 
to the respective class
* Typo in the BMessage overview FindBook() -> FindBool()
* With scripting, maybe also hint to the drag&drop protocol?
* In the BLooper introduction in the first paragraph, maybe it should 
be mentioned that a BLooper can have any number of BHandlers (and is a 
BHandler itself) before writing that it would choose a BHandler to 
handle the message.
* Also all methods mentioned in the text (like AddBool(), AddHandler(), 
...) should be links to make the documentation more usable.
* The warning in BHandler "baseclassMessageReceived()" looks messed up.

Nice work, anyway!

Bye,
   Axel.