From d3c982b1bd9b57f9c14205d7eee92599cf630283 Mon Sep 17 00:00:00 2001 From: Micah Cowan Date: Thu, 27 Sep 2007 18:53:59 -0700 Subject: [PATCH 1/5] Bring texi2pod.pl up-to-date with gcc's. BUT: keep GPLv3 invocation, and "use warning" rather than -w. --- doc/texi2pod.pl | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) diff --git a/doc/texi2pod.pl b/doc/texi2pod.pl index 0b57d1b9..daad3f6d 100755 --- a/doc/texi2pod.pl +++ b/doc/texi2pod.pl @@ -204,9 +204,9 @@ while(<$inf>) { # Now the ones that have to be replaced by special escapes # (which will be turned back into text by unmunge()) s/&/&/g; - s/\@\@/&at;/g; s/\@\{/{/g; s/\@\}/}/g; + s/\@\@/&at;/g; # Inside a verbatim block, handle @var specially. if ($shift ne "") { @@ -227,11 +227,12 @@ while(<$inf>) { /^\@include\s+(.+)$/ and do { push @instack, $inf; $inf = gensym(); + $file = postprocess($1); # Try cwd and $ibase. - open($inf, "<" . $1) - or open($inf, "<" . $ibase . "/" . $1) - or die "cannot open $1 or $ibase/$1: $!\n"; + open($inf, "<" . $file) + or open($inf, "<" . $ibase . "/" . $file) + or die "cannot open $file or $ibase/$file: $!\n"; next; }; @@ -274,7 +275,6 @@ while(<$inf>) { $ic =~ s/\@(?:code|kbd)/C/; $ic =~ s/\@(?:dfn|var|emph|cite|i)/I/; $ic =~ s/\@(?:file)/F/; - $ic =~ s/\@(?:asis)/S/; # punt $_ = "\n=over 4\n"; }; @@ -308,7 +308,7 @@ die "No filename or title\n" unless defined $fn && defined $tl; $sects{NAME} = "$fn \- $tl\n"; $sects{FOOTNOTES} .= "=back\n" if exists $sects{FOOTNOTES}; -for $sect (qw(NAME SYNOPSIS DESCRIPTION OPTIONS ENVIRONMENT EXAMPLES FILES +for $sect (qw(NAME SYNOPSIS DESCRIPTION OPTIONS ENVIRONMENT FILES BUGS NOTES FOOTNOTES SEEALSO AUTHOR COPYRIGHT)) { if(exists $sects{$sect}) { $head = $sect; @@ -350,6 +350,13 @@ sub postprocess s/\@w\{([^\}]*)\}/S<$1>/g; s/\@(?:dmn|math)\{([^\}]*)\}/$1/g; + # keep references of the form @ref{...}, print them bold + s/\@(?:ref)\{([^\}]*)\}/B<$1>/g; + + # Change double single quotes to double quotes. + s/''/"/g; + s/``/"/g; + # Cross references are thrown away, as are @noindent and @refill. # (@noindent is impossible in .pod, and @refill is unnecessary.) # @* is also impossible in .pod; we discard it and any newline that From cd04dcfa2a0161ebbcbac1db30f22b00bfd17009 Mon Sep 17 00:00:00 2001 From: Micah Cowan Date: Thu, 27 Sep 2007 19:03:05 -0700 Subject: [PATCH 2/5] Reversed broken "fix" of @@ processing --- doc/texi2pod.pl | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/texi2pod.pl b/doc/texi2pod.pl index daad3f6d..bcb276c6 100755 --- a/doc/texi2pod.pl +++ b/doc/texi2pod.pl @@ -204,9 +204,9 @@ while(<$inf>) { # Now the ones that have to be replaced by special escapes # (which will be turned back into text by unmunge()) s/&/&/g; + s/\@\@/&at;/g; s/\@\{/{/g; s/\@\}/}/g; - s/\@\@/&at;/g; # Inside a verbatim block, handle @var specially. if ($shift ne "") { From 2f76b72f81b5cef6f18fe8f03c33a7938a331398 Mon Sep 17 00:00:00 2001 From: Micah Cowan Date: Thu, 27 Sep 2007 21:57:11 -0700 Subject: [PATCH 3/5] Remove @pxref appearances from manpage, by removing other content in the same parenthetical. Also made some minor grammatical adjustments. --- doc/wget.texi | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/doc/wget.texi b/doc/wget.texi index c7aca61e..bc404fd5 100644 --- a/doc/wget.texi +++ b/doc/wget.texi @@ -347,7 +347,7 @@ wget -r --tries=10 http://fly.srk.fer.hr/ -o log @end example The space between the option accepting an argument and the argument may -be omitted. Instead @samp{-o log} you can write @samp{-olog}. +be omitted. Instead of @samp{-o log} you can write @samp{-olog}. You may put several options that do not require arguments together, like: @@ -754,7 +754,7 @@ connect timeout, other than that implemented by system libraries. @cindex timeout, read @item --read-timeout=@var{seconds} Set the read (and write) timeout to @var{seconds} seconds. The -``time'' of this timeout refers @dfn{idle time}: if, at any point in +``time'' of this timeout refers to @dfn{idle time}: if, at any point in the download, no data is received for more than the specified number of seconds, reading fails and the download is restarted. This option does not directly affect the duration of the entire download. @@ -1087,8 +1087,8 @@ Retrieval Options}). @itemx --http-password=@var{password} Specify the username @var{user} and password @var{password} on an @sc{http} server. According to the type of the challenge, Wget will -encode them using either the @code{basic} (insecure) or the -@code{digest} authentication scheme. +encode them using either the @code{basic} (insecure), +the @code{digest}, or the Windows @code{NTLM} authentication scheme. Another way to specify username and password is in the @sc{url} itself (@pxref{URL Format}). Either method reveals your password to anyone who @@ -1807,7 +1807,7 @@ option to turn it on. @item -A @var{acclist} --accept @var{acclist} @itemx -R @var{rejlist} --reject @var{rejlist} Specify comma-separated lists of file name suffixes or patterns to -accept or reject (@pxref{Types of Files} for more details). Note that if +accept or reject (@pxref{Types of Files}). Note that if any of the wildcard characters, @samp{*}, @samp{?}, @samp{[} or @samp{]}, appear in an element of @var{acclist} or @var{rejlist}, it will be treated as a pattern, rather than a suffix. @@ -1876,13 +1876,13 @@ without any distractions, not even those from the same hosts @item -I @var{list} @itemx --include-directories=@var{list} Specify a comma-separated list of directories you wish to follow when -downloading (@pxref{Directory-Based Limits} for more details.) Elements +downloading (@pxref{Directory-Based Limits}). Elements of @var{list} may contain wildcards. @item -X @var{list} @itemx --exclude-directories=@var{list} Specify a comma-separated list of directories you wish to exclude from -download (@pxref{Directory-Based Limits} for more details.) Elements of +download (@pxref{Directory-Based Limits}). Elements of @var{list} may contain wildcards. @item -np From dafb9f576c7e9d3fcd4fea41a322b82d3c913e30 Mon Sep 17 00:00:00 2001 From: Micah Cowan Date: Thu, 27 Sep 2007 22:31:09 -0700 Subject: [PATCH 4/5] Stronger warning about manpage being incomplete. --- doc/wget.texi | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/doc/wget.texi b/doc/wget.texi index bc404fd5..5ed1c6a7 100644 --- a/doc/wget.texi +++ b/doc/wget.texi @@ -64,7 +64,11 @@ Originally written by Hrvoje Niksic . Currently maintained by Micah Cowan . @c man end @c man begin SEEALSO -GNU Info entry for @file{wget}. +This is @strong{not} the complete manual for GNU Wget. +For more complete information, including more detailed explanations of +some of the options, and a number of commands available +for use with @file{.wgetrc} files and the @samp{-e} option, see the GNU +Info entry for @file{wget}. @c man end @end ignore From 9c50f9356a56118c20ff6e3d970165ab4b12248f Mon Sep 17 00:00:00 2001 From: Micah Cowan Date: Thu, 27 Sep 2007 22:35:20 -0700 Subject: [PATCH 5/5] Added ChangeLog entries. --- doc/ChangeLog | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/doc/ChangeLog b/doc/ChangeLog index f40b7c87..99ea378b 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,13 @@ +2007-09-27 Micah Cowan + + * wget.texi: Removed "for more details" from parenthesese + enclosing @pxref{}s, so that texi2pod.pl knows to remove the + whole reference. Made some gramattical improvements, and + strengthened the recommendation to use the info manual instead. + * texi2pod.pl: Brought in some updates from the GCC version. Not + an entire update, since a couple "fixes" there breaks stuff + here. + 2007-09-12 Micah Cowan * wget.texi: Expanded the description of -O. Clarified the