--- trunk/Nos.pm	2005/08/22 20:24:04	72
+++ trunk/Nos.pm	2005/08/24 17:19:16	74
@@ -62,9 +62,9 @@
 It will just queue your e-mail message to particular list (sending it to
 possibly remote Notice Sender SOAP server just once), send it out at
 reasonable rate (so that it doesn't flood your e-mail infrastructure) and
-track replies.
+keep track replies.
 
-It is best used to send smaller number of messages to more-or-less fixed
+It is best used to send small number of messages to more-or-less fixed
 list of recipients while allowing individual responses to be examined.
 Tipical use include replacing php e-mail sending code with SOAP call to
 Notice Sender. It does support additional C<ext_id> field for each member
@@ -72,7 +72,7 @@
 particular user.
 
 It comes with command-line utility C<sender.pl> which can be used to perform
-all available operation from scripts (see C<perldoc sender.pl>).
+all available operation from scripts (see C<sender.pl --man>).
 This command is also useful for debugging while writing client SOAP
 application.
 
@@ -267,7 +267,7 @@
  	list => 'My list',
  );
 
-Returns array of hashes with user informations like this:
+Returns array of hashes with user information like this:
 
  $member = {
  	name => 'Dobrica Pavlinusic',
@@ -1020,10 +1020,6 @@
 
 Returns array of hashes with user informations, see C<list_members>.
 
-Returning arrays from SOAP calls is somewhat fuzzy (at least to me). It
-seems that SOAP::Lite client thinks that it has array with one element which
-is array of hashes with data.
-
 =cut
 
 sub ListMembers {
@@ -1084,9 +1080,53 @@
 	}
 }
 
+=head1 UNIMPLEMENTED FUNCTIONS
+
+This is a stub for documentation of unimplemented functions.
+
+=head2 MessagesReceived
+
+ my @result = MessagesReceived(
+ 	list => 'My list',
+	email => 'jdoe@example.com',
+ );
+
+You can specify just C<list> or C<email> or any combination of those.
+
+It will return array of hashes with following structure:
+
+ {
+	id => 42,			# unique ID of received message
+	list => 'My list',		# useful only of filtering by email
+	ext_id => 9999,			# ext_id from message user
+	email => 'jdoe@example.com',	# e-mail of user
+	bounced => 0,			# true value if message is bounce
+	date => '2005-08-24 18:57:24',	# date of recival in ISO format
+ }
+
+=head2 MessagesReceivedByDate
+
+=head2 MessagesReceivedByDateWithContent
+
+=head2 ReceivedMessasgeContent
+
+Return content of received message.
+
+ my $mail_body = ReceivedMessageContent( id => 42 );
+
+=cut
+
+
+
 
 ###
 
+=head1 NOTE ON ARRAYS IN SOAP
+
+Returning arrays from SOAP calls is somewhat fuzzy (at least to me). It
+seems that SOAP::Lite client thinks that it has array with one element which
+is array of hashes with data.
+
 =head1 EXPORT
 
 Nothing.