diff --git a/docs/user/app/Message.dox b/docs/user/app/Message.dox index 1899b70ce6..d6b724f7bb 100644 --- a/docs/user/app/Message.dox +++ b/docs/user/app/Message.dox @@ -95,17 +95,24 @@ This class is at the center of the web of messaging classes, in the sense that it defines the actual structure of the messages. Messages have two - important elements: the #what identifer, and the data members. The first - can be directly manipulated, the latter can be manipulated through + important elements: the #what identifer, and the data members. The + first can be directly manipulated, the latter can be manipulated through AddData(), FindData() and ReplaceData() and their deratives. Neither of these elements are mandatory. - The second important role of BMessage is that it stores meta data: who sent - the message and with what intention? The methods of BMessage will disclose - if the message was a reply (IsReply()), where it came from + The second important role of BMessage is that it stores meta data: + who sent the message and with what intention? The methods of BMessage will + disclose if the message was a reply (IsReply()), where it came from (IsSourceRemote()), whether a reply is expected (IsSourceWaiting()), and in case the message is a reply, what it's a reply to (Previous()). + Mostly, messages are used to pass information between the the objects in + your application, but because messages are such flexible data containers, + they are also often used for other data storage purposes. Many + applications store their settings as messages. Because messages can be + flattened to data streams (such as files), they provide an easy but + powerful tool for data storage. + All methods can be classified in these areas: - Adding, Finding, Replacing and Removing Data. - Statistics and Miscelanous information.