I have taken liberty to apply this patch, fixing typos and some wording in comments and inline documentation, in the hope that that was ok.
Cheers, Ralf * lib/Automake/Channels.pm, lib/Automake/Condition.pm, lib/Automake/DisjConditions.pm, lib/Automake/Options.pm, lib/Automake/VarDef.pm, lib/Automake/Wrap.pm: Fix some typos. Index: lib/Automake/Channels.pm =================================================================== RCS file: /cvs/automake/automake/lib/Automake/Channels.pm,v retrieving revision 1.11 diff -u -r1.11 Channels.pm --- lib/Automake/Channels.pm 14 May 2005 20:28:51 -0000 1.11 +++ lib/Automake/Channels.pm 13 May 2006 09:27:24 -0000 @@ -1,4 +1,4 @@ -# Copyright (C) 2002, 2004 Free Software Foundation, Inc. +# Copyright (C) 2002, 2004, 2006 Free Software Foundation, Inc. # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by @@ -43,7 +43,7 @@ # Treat all warnings as errors. $warnings_are_errors = 1; - # Exit with the greater exist code encountered so far. + # Exit with the greatest exit code encountered so far. exit $exit_code; =head1 DESCRIPTION @@ -108,7 +108,7 @@ =item C<UP_NONE>, C<UP_TEXT>, C<UP_LOC_TEXT> -Possible values for the C<uniq_part> options. This select the part +Possible values for the C<uniq_part> options. This selects the part of the message that should be considered when filtering out duplicates. If C<UP_LOC_TEXT> is used, the location and the explanation message are used for filtering. If C<UP_TEXT> is used, only the explanation @@ -126,10 +126,10 @@ Possible values for the C<uniq_scope> options. Use C<US_GLOBAL> for error messages that should be printed only -once in the run of the program, C<US_LOCAL> for message that +once during the execution of the program, C<US_LOCAL> for message that should be printed only once per file. (Actually, C<Channels> does not -now when files are changed, it relies on you calling C<reset_local_duplicates> -when this happens.) +do this now when files are changed, it relies on you calling +C<reset_local_duplicates> when this happens.) =cut @@ -143,7 +143,7 @@ Channels accept the options described below. These options can be passed as a hash to the C<register_channel>, C<setup_channel>, and C<msg> -functions. The possible keys, with there default value are: +functions. The possible keys, with their default value are: =over @@ -352,7 +352,7 @@ =item C<channel_type ($name)> Returns the type of channel C<$name> if it has been registered. -Returns The empty string otherwise. +Returns the empty string otherwise. =cut @@ -478,7 +478,7 @@ =item C<msg ($channel, $location, $message, [%options])> -Emit a message on C<$channel>, overriding some options of the channel with +Emit a message on C<$channel>, overriding some options of the channel with those specified in C<%options>. Obviously C<$channel> must have been registered with C<register_channel>. @@ -496,10 +496,10 @@ foo.c:10: unused variable `mumble' C<$location> can also be an instance of C<Automake::Location>. In this -case the stack of contexts will be displayed in addition. +case, the stack of contexts will be displayed in addition. If C<$message> contains newline characters, C<$location> is prepended -to each line. For instance +to each line. For instance, msg 'error', 'somewhere', "1st line\n2nd line"; @@ -646,8 +646,8 @@ This backlog of messages is processed when C<flush_messages> is called, with the current channel options (not the options in effect, -at the time of C<msg>). So for instance if some channel was silenced -in the meantime, messages to this channels will not be print. +at the time of C<msg>). So for instance, if some channel was silenced +in the meantime, messages to this channel will not be printed. C<flush_messages> cancels the effect of C<buffer_messages>. Following calls to C<msg> are processed immediately as usual. Index: lib/Automake/Condition.pm =================================================================== RCS file: /cvs/automake/automake/lib/Automake/Condition.pm,v retrieving revision 1.5 diff -u -r1.5 Condition.pm --- lib/Automake/Condition.pm 14 May 2005 20:28:51 -0000 1.5 +++ lib/Automake/Condition.pm 13 May 2006 09:27:25 -0000 @@ -1,4 +1,4 @@ -# Copyright (C) 1997, 2001, 2002, 2003 Free Software Foundation, Inc. +# Copyright (C) 1997, 2001, 2002, 2003, 2006 Free Software Foundation, Inc. # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by @@ -123,8 +123,8 @@ Another point worth to mention is that each C<Condition> object is unique with respect to its conditionals. Two C<Condition> objects -created for the same set of conditionals will have the same adress. -This makes it easy to compare C<Condition>s, just compare the +created for the same set of conditionals will have the same address. +This makes it easy to compare C<Condition>s: just compare the references. my $c1 = new Automake::Condition "COND1_TRUE", "COND2_TRUE"; Index: lib/Automake/DisjConditions.pm =================================================================== RCS file: /cvs/automake/automake/lib/Automake/DisjConditions.pm,v retrieving revision 1.13 diff -u -r1.13 DisjConditions.pm --- lib/Automake/DisjConditions.pm 14 May 2005 20:28:51 -0000 1.13 +++ lib/Automake/DisjConditions.pm 13 May 2006 09:27:25 -0000 @@ -1,4 +1,4 @@ -# Copyright (C) 1997, 2001, 2002, 2003, 2004 Free Software Foundation, Inc. +# Copyright (C) 1997, 2001, 2002, 2003, 2004, 2006 Free Software Foundation, Inc. # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by @@ -116,7 +116,7 @@ Like C<Condition> objects, a C<DisjConditions> object is unique with respect to its conditions. Two C<DisjConditions> objects created -for the same set of conditions will have the same adress. This makes +for the same set of conditions will have the same address. This makes it easy to compare C<DisjConditions>s: just compare the references. =head2 Methods Index: lib/Automake/Options.pm =================================================================== RCS file: /cvs/automake/automake/lib/Automake/Options.pm,v retrieving revision 1.5 diff -u -r1.5 Options.pm --- lib/Automake/Options.pm 14 May 2005 20:28:51 -0000 1.5 +++ lib/Automake/Options.pm 13 May 2006 09:27:25 -0000 @@ -1,4 +1,4 @@ -# Copyright (C) 2003, 2004 Free Software Foundation, Inc. +# Copyright (C) 2003, 2004, 2006 Free Software Foundation, Inc. # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by @@ -159,7 +159,7 @@ returns the empty list. Otherwise it returns the option's value, as set by C<set_option> or C<set_global_option>. -Not that C<global_option> should be used only when it is +Note that C<global_option> should be used only when it is important to make sure an option hasn't been set locally. Otherwise C<option> should be the standard function to check for options (be they global or local). Index: lib/Automake/VarDef.pm =================================================================== RCS file: /cvs/automake/automake/lib/Automake/VarDef.pm,v retrieving revision 1.7 diff -u -r1.7 VarDef.pm --- lib/Automake/VarDef.pm 14 May 2005 20:28:51 -0000 1.7 +++ lib/Automake/VarDef.pm 13 May 2006 09:27:25 -0000 @@ -1,4 +1,4 @@ -# Copyright (C) 2003, 2004 Free Software Foundation, Inc. +# Copyright (C) 2003, 2004, 2006 Free Software Foundation, Inc. # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by @@ -71,7 +71,7 @@ =head1 DESCRIPTION -This class gather data related to one Makefile-variable definition. +This class gathers data related to one Makefile-variable definition. =head2 Constants Index: lib/Automake/Wrap.pm =================================================================== RCS file: /cvs/automake/automake/lib/Automake/Wrap.pm,v retrieving revision 1.2 diff -u -r1.2 Wrap.pm --- lib/Automake/Wrap.pm 14 May 2005 20:28:51 -0000 1.2 +++ lib/Automake/Wrap.pm 13 May 2006 09:27:25 -0000 @@ -1,4 +1,4 @@ -# Copyright (C) 2003 Free Software Foundation, Inc. +# Copyright (C) 2003, 2006 Free Software Foundation, Inc. # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by @@ -26,7 +26,7 @@ =head1 NAME -Automake::Wrap - a paragraph formater +Automake::Wrap - a paragraph formatter =head1 SYNOPSIS @@ -41,7 +41,7 @@ This modules provide facility to format list of strings. It is comparable to Perl's L<Text::Wrap>, however we can't use L<Text::Wrap> -because some versions will abort when some word to print exceed the +because some versions will abort when some word to print exceeds the maximum length allowed. (Ticket #17141, fixed in Perl 5.8.0.) =head2 Functions @@ -65,7 +65,7 @@ Format C<@values> as a block of text that starts with C<$head>, followed by the strings in C<@values> separated by spaces or by -C<"$eol\n$fill"> so that the lenght of each line never exceed +C<"$eol\n$fill"> so that the length of each line never exceeds C<$max_len>. The C<$max_len> contraint is ignored for C<@values> items which