Patch from shaleh to make the verbs and tense agree.

@@ -7,15 +7,15 @@ parsed.
 @end deftypefun
 @end deftypefun
 
 
 @deftypefun void header_destroy (header_t *@var{hdr}, void *@var{owner})
 @deftypefun void header_destroy (header_t *@var{hdr}, void *@var{owner})
-The ressources allocate for @var{hdr} are freed.
+The resources allocated for @var{hdr} are freed.
 @end deftypefun
 @end deftypefun
 
 
 @deftypefun int header_set_value (header_t @var{hdr}, const char *@var{fn}, const char *@var{fv}, size_t n, int @var{replace})
 @deftypefun int header_set_value (header_t @var{hdr}, const char *@var{fn}, const char *@var{fv}, size_t n, int @var{replace})
 Set the field-name @var{fn} to field-value @var{fv} of size @var{n} in
 Set the field-name @var{fn} to field-value @var{fv} of size @var{n} in
-@var{hdr}.  If @var{replace} is non-zero the initial value is replace, if zero
-it is append.
+@var{hdr}.  If @var{replace} is non-zero the initial value is replaced, if zero
+it is appended.
 
 
-Some basic macros is already provided for rfc822.
+Some basic macros are already provided for rfc822.
 
 
 @table @code
 @table @code
 @item MU_HDR_RETURN_PATH
 @item MU_HDR_RETURN_PATH
@@ -73,7 +73,7 @@ MIME-Version
 @end deftypefun
 @end deftypefun
 
 
 @deftypefun int header_get_value (header_t @var{hdr}, const char *fn, char *fv, size_t len, size_t *n)
 @deftypefun int header_get_value (header_t @var{hdr}, const char *fn, char *fv, size_t len, size_t *n)
-Value of field-name @var{fn} is return in buffer @var{fv} of size @var{len}.
+Value of field-name @var{fn} is returned in buffer @var{fv} of size @var{len}.
 The number of bytes written is put in @var{n}.
 The number of bytes written is put in @var{n}.
 @end deftypefun
 @end deftypefun
 
 

 @code{#include <mailutils/mailbox.h>}
 @code{#include <mailutils/mailbox.h>}
 @deftp {Data Type} mailbox_t
 @deftp {Data Type} mailbox_t
-The @code{mailbox_t} object is use to hold information and it is an opaque
+The @code{mailbox_t} object is used to hold information and it is an opaque
 data structure to the user. Functions are provided to retrieve the information.
 data structure to the user. Functions are provided to retrieve the information.
 @end deftp
 @end deftp
 @example
 @example
@@ -25,13 +25,13 @@ data structure to the user. Functions are provided to retrieve the information.
 @end example
 @end example
 
 
 @deftypefun int mailbox_create (mailbox_t *@var{pmbox}, const char *@var{name}, int @var{id})
 @deftypefun int mailbox_create (mailbox_t *@var{pmbox}, const char *@var{name}, int @var{id})
-The funcion @code{mailbox_create} allocates and initializes @var{pmbox}.
-The validation is base on the scheme of the url @var{name} or @var{id}.
+The function @code{mailbox_create} allocates and initializes @var{pmbox}.
+The validation is based on the scheme of the url @var{name} or @var{id}.
 
 
 The return value is @code{0} on success and a code number on error conditions:
 The return value is @code{0} on success and a code number on error conditions:
 @table @code
 @table @code
 @item EINVAL
 @item EINVAL
-The url @var{name} supply is invalid or not supported.
+The url @var{name} supplied is invalid or not supported.
 @var{pmbox} is NULL.
 @var{pmbox} is NULL.
 @item ENOMEM
 @item ENOMEM
 Not enough memory to allocate resources.
 Not enough memory to allocate resources.
@@ -39,7 +39,7 @@ Not enough memory to allocate resources.
 @end deftypefun
 @end deftypefun
 
 
 @deftypefun int mailbox_create_default (mailbox_t *@var{pmbox}, const char *@var{user})
 @deftypefun int mailbox_create_default (mailbox_t *@var{pmbox}, const char *@var{user})
-The environment variable @emph{$MAIL} or the string form by
+The environment variable @emph{$MAIL} or the string formed by
 @emph{$MAILDIR}/@var{user}" or @emph{$LOGNAME} if @var{user} is null,
 @emph{$MAILDIR}/@var{user}" or @emph{$LOGNAME} if @var{user} is null,
 for a default mailbox and calls @code{mailbox_create}.
 for a default mailbox and calls @code{mailbox_create}.
 @end deftypefun
 @end deftypefun
@@ -60,14 +60,14 @@ Set the @var{stream} connection to use for the mailbox.
 The return value is @code{0} on success and a code number on error conditions:
 The return value is @code{0} on success and a code number on error conditions:
 @table @code
 @table @code
 @item EINVAL
 @item EINVAL
-@var{mbox} or @var{stream} are NULL.
+@var{mbox} or @var{stream} is NULL.
 @end table
 @end table
 @end deftypefun
 @end deftypefun
 
 
 @deftypefun int mailbox_open (mailbox_t @var{mbox}, int @var{flag})
 @deftypefun int mailbox_open (mailbox_t @var{mbox}, int @var{flag})
 A connection is open, if no stream was provided, a stream
 A connection is open, if no stream was provided, a stream
-is create base on the @var{mbox} type.  The @var{flag} can be OR'ed.
-See @code{stream_create} for @var{flag} description.
+is created based on the @var{mbox} type.  The @var{flag} can be OR'ed.
+See @code{stream_create} for @var{flag}'s description.
 
 
 The return value is @code{0} on success and a code number on error conditions:
 The return value is @code{0} on success and a code number on error conditions:
 @table @code
 @table @code
@@ -84,7 +84,7 @@ Not enough memory.
 @end deftypefun
 @end deftypefun
 
 
 @deftypefun  int mailbox_close (mailbox_t @var{mbox})
 @deftypefun  int mailbox_close (mailbox_t @var{mbox})
-The stream attach to @var{mbox} is close.
+The stream attach to @var{mbox} is closed.
 
 
 The return value is @code{0} on success and a code number on error conditions:
 The return value is @code{0} on success and a code number on error conditions:
 @table @code
 @table @code
@@ -94,12 +94,12 @@ The return value is @code{0} on success and a code number on error conditions:
 @end deftypefun
 @end deftypefun
 
 
 @deftypefun  void mailbox_destroy (mailbox_t *@var{pmbox})
 @deftypefun  void mailbox_destroy (mailbox_t *@var{pmbox})
-Destroy and releases resources hold by @var{pmbox}.
+Destroys and releases resources held by @var{pmbox}.
 @end deftypefun
 @end deftypefun
 
 
 @deftypefun  int mailbox_get_message (mailbox_t @var{mbox}, size_t @var{msgno}, message_t *@var{pmessage})
 @deftypefun  int mailbox_get_message (mailbox_t @var{mbox}, size_t @var{msgno}, message_t *@var{pmessage})
-Retreive message number @var{msgno}, @var{pmessage} is allocate and
-initialize.
+Retreive message number @var{msgno}, @var{pmessage} is allocated and
+initialized.
 
 
 The return value is @code{0} on success and a code number on error conditions:
 The return value is @code{0} on success and a code number on error conditions:
 @table @code
 @table @code
@@ -111,7 +111,7 @@ Not enough memory.
 @end deftypefun
 @end deftypefun
 
 
 @deftypefun  int mailbox_append_message (mailbox_t @var{mbox}, message_t @var{message})
 @deftypefun  int mailbox_append_message (mailbox_t @var{mbox}, message_t @var{message})
-The @var{message} is append to the mailbox @var{mbox}.
+The @var{message} is appended to the mailbox @var{mbox}.
 
 
 The return value is @code{0} on success and a code number on error conditions:
 The return value is @code{0} on success and a code number on error conditions:
 @table @code
 @table @code
@@ -121,7 +121,7 @@ The return value is @code{0} on success and a code number on error conditions:
 @end deftypefun
 @end deftypefun
 
 
 @deftypefun  int mailbox_messages_count (mailbox_t @var{mbox}, size_t *@var{pnumber});
 @deftypefun  int mailbox_messages_count (mailbox_t @var{mbox}, size_t *@var{pnumber});
-Give the number of message is @var{mbox}.
+Give the number of messaged in @var{mbox}.
 
 
 The return value is @code{0} on success and a code number on error conditions:
 The return value is @code{0} on success and a code number on error conditions:
 @table @code
 @table @code
@@ -131,7 +131,7 @@ The return value is @code{0} on success and a code number on error conditions:
 @end deftypefun
 @end deftypefun
 
 
 @deftypefun  int mailbox_expunge (mailbox_t @var{mbox})
 @deftypefun  int mailbox_expunge (mailbox_t @var{mbox})
-All the messages set deleted are removed.
+All messages marked for deletion are removed.
 
 
 The return value is @code{0} on success and a code number on error conditions:
 The return value is @code{0} on success and a code number on error conditions:
 @table @code
 @table @code
@@ -161,7 +161,7 @@ The return value is @code{0} on success and a code number on error conditions:
 @end deftypefun
 @end deftypefun
 
 
 @deftypefun  int mailbox_get_auth (mailbox_t @var{mbox}, auth_t *@var{pauth})
 @deftypefun  int mailbox_get_auth (mailbox_t @var{mbox}, auth_t *@var{pauth})
-Retriever the @var{*pauth} of the @var{mbox}.
+Retrieve the @var{*pauth} of the @var{mbox}.
 
 
 The return value is @code{0} on success and a code number on error conditions:
 The return value is @code{0} on success and a code number on error conditions:
 @table @code
 @table @code
@@ -171,7 +171,7 @@ The return value is @code{0} on success and a code number on error conditions:
 @end deftypefun
 @end deftypefun
 
 
 @deftypefun  int mailbox_set_auth (mailbox_t @var{mbox}, auth_t @var{auth})
 @deftypefun  int mailbox_set_auth (mailbox_t @var{mbox}, auth_t @var{auth})
-Set the type of authaurity for the mailbox.
+Set the type of authentication for the mailbox.
 
 
 The return value is @code{0} on success and a code number on error conditions:
 The return value is @code{0} on success and a code number on error conditions:
 @table @code
 @table @code
@@ -181,7 +181,7 @@ The return value is @code{0} on success and a code number on error conditions:
 @end deftypefun
 @end deftypefun
 
 
 @deftypefun  int mailbox_is_updated (mailbox_t @var{mbox})
 @deftypefun  int mailbox_is_updated (mailbox_t @var{mbox})
-Check if the mailbox is uptodate.
+Check if the mailbox is up-to-date.
 
 
 The return value is @code{0} on success and a code number on error conditions:
 The return value is @code{0} on success and a code number on error conditions:
 @table @code
 @table @code

 
 
-The API is still shaky and undefine.
+The API is still shaky and undefined.
 
 

@@ -103,7 +103,7 @@ This document was produced for version @value{VERSION} of @sc{gnu}
 @menu
 @menu
 * Introduction::                GNU @sc{mailutils}
 * Introduction::                GNU @sc{mailutils}
 * Mailbox::                     Mailbox API.
 * Mailbox::                     Mailbox API.
-* Mailer::                      Protocol Use to Send Mail.
+* Mailer::                      Protocol Used to Send Mail.
 * Message::                     Message API.
 * Message::                     Message API.
 * Headers::                     Headers API.
 * Headers::                     Headers API.
 * Body::                        Body API.
 * Body::                        Body API.
@@ -125,8 +125,9 @@ This document was produced for version @value{VERSION} of @sc{gnu}
 @chapter Introduction
 @chapter Introduction
 @cindex Introduction
 @cindex Introduction
 
 
-@sc{gnu} @sc{Mailutils} offers a general purpose library aim to provide
-a rich set of functions for accessing different mailbox formats and mailers.
+@sc{gnu} @sc{Mailutils} offers a general purpose library whose aim is to
+provide a rich set of functions for accessing different mailbox formats and
+mailers.
 
 
 @example
 @example
 @group
 @group
@@ -139,7 +140,7 @@ a rich set of functions for accessing different mailbox formats and mailers.
   -----------               +-----------------+    |   |  ...      |
   -----------               +-----------------+    |   |  ...      |
  (  jeff    )           +---|-* message_t[0]  |    |   +-----------+
  (  jeff    )           +---|-* message_t[0]  |    |   +-----------+
   -----------           |   |   message_t[1]  |    |
   -----------           |   |   message_t[1]  |    |
- (  sean    )           |   |   ...           |    |    auth_t
+ (  shaleh  )           |   |   ...           |    |    auth_t
   ----------            |   +-----------------+    +-->+----------+
   ----------            |   +-----------------+    +-->+----------+
                         |                              |  user    |
                         |                              |  user    |
    message_t            |                              |  passwd  |
    message_t            |                              |  passwd  |
@@ -155,8 +156,8 @@ a rich set of functions for accessing different mailbox formats and mailers.
 @end group
 @end group
 @end example
 @end example
 
 
-For example writing a simple @command{from} command that will list @emph{From}
-and @emph{Subject} of a folder.
+For example writing a simple @command{from} command that will list the 
+@emph{From} and @emph{Subject} headers of every mail in a folder.
 
 
 @example
 @example
 @include sfrom.c.texi
 @include sfrom.c.texi
@@ -256,7 +257,7 @@ Be sure to include the word ``mailutils'' somewhere in the ``Subject:'' field.
 In no particular order,
 In no particular order,
 Jakob Kaivo @email{jkaivo@@ndn.net},
 Jakob Kaivo @email{jkaivo@@ndn.net},
 Jeff Bailey @email{jbailey@@gnu.org},
 Jeff Bailey @email{jbailey@@gnu.org},
-Sean Perry @email{shaleh@@debian.org},
+Sean 'Shaleh' Perry @email{shaleh@@debian.org},
 Thomas Fletcher @email{thomasf@@qnx.com}.
 Thomas Fletcher @email{thomasf@@qnx.com}.
 Dave Inglis @email{dinglis@@qnx.com}.
 Dave Inglis @email{dinglis@@qnx.com}.
 Brian Edmond @email{briane@@qnx.com}.
 Brian Edmond @email{briane@@qnx.com}.

@@ -13,16 +13,16 @@ The stream is open write only.
 The stream is open read and write.
 The stream is open read and write.
 @item MU_STREAM_APPEND
 @item MU_STREAM_APPEND
 @findex MU_STREAM_APPEND
 @findex MU_STREAM_APPEND
-The stream is open in append mode for write.
+The stream is open in append mode for writing.
 @item MU_STREAM_CREAT
 @item MU_STREAM_CREAT
 @findex MU_STREAM_CREAT
 @findex MU_STREAM_CREAT
-The stream is create.
+The stream is created.
 @item MU_STREAM_NONBLOCK
 @item MU_STREAM_NONBLOCK
 @findex MU_STREAM_NONBLOCK
 @findex MU_STREAM_NONBLOCK
 The stream is set non blocking.
 The stream is set non blocking.
 @item MU_STREAM_NO_CHECK
 @item MU_STREAM_NO_CHECK
 @findex MU_STREAM_NO_CHECK
 @findex MU_STREAM_NO_CHECK
-Stream is destroy without checking for the owner.
+Stream is destroyed without checking for the owner.
 @end table
 @end table
 @end deftypefun
 @end deftypefun
 
 

 
 
 @comment See rfc2368, rfc2369, rfc2384
 @comment See rfc2368, rfc2369, rfc2384
-A mailbox and mailer can be describe in a URL, the string will contain the
+A mailbox and mailer can be described in a URL, the string will contain the
 necessary information to initialize @code{mailbox_t}, or @code{mailer_t}
 necessary information to initialize @code{mailbox_t}, or @code{mailer_t}
 properly.
 properly.
 
 
@@ -13,7 +13,7 @@ and the authentication mechanism.  The general form is
 @url{pop://obelix;AUTH=+APOP@@village.gaulois.org:2000}
 @url{pop://obelix;AUTH=+APOP@@village.gaulois.org:2000}
 @end example
 @end example
 
 
-If @emph{:port} is omitted the default value is 110. Different form of
+If @emph{:port} is omitted the default value is 110. Different forms of
 authentication can be specified with @emph{;AUTH=type}.
 authentication can be specified with @emph{;AUTH=type}.
 The special string @emph{;AUTH=*} indicates that the client will use
 The special string @emph{;AUTH=*} indicates that the client will use
 a default scheme base on the capability of the server.
 a default scheme base on the capability of the server.
@@ -52,13 +52,13 @@ use @url{file://path} and let the library figure out which one.
 
 
 @section Mailto
 @section Mailto
 
 
-After setting a mailer, @url{mailto:} is use to tell the mailer where
+After setting a mailer, @url{mailto:} is used to tell the mailer where
 and to whom the message is for.
 and to whom the message is for.
 @example
 @example
 @url{mailto://hostname}
 @url{mailto://hostname}
 @end example
 @end example
 
 
-Mailto can be use to generate short messages for example to subscribe
+Mailto can be used to generate short messages, for example to subscribe
 to mailing lists.
 to mailing lists.
 @example
 @example
 @url{mailto://bug-mailutils@@gnu.org?body=subscribe}
 @url{mailto://bug-mailutils@@gnu.org?body=subscribe}