Description: fix spelling errors Author: Joao Eriberto Mota Filho Last-Update: 2022-07-29 Index: pwget/bin/pwget.1 =================================================================== --- pwget.orig/bin/pwget.1 +++ pwget/bin/pwget.1 @@ -162,10 +162,10 @@ At this point you may wonder, where woul when \fIwget\fR\|(1) C\-program has been the standard for ages. Well, 1) Perl is cross platform and more easily extendable 2) You can record file download criteria to a configuration file and use perl regular -epxressions to select downloads 3) the program can anlyze web-pages +expressions to select downloads 3) the program can analyze web-pages and \*(L"search\*(R" for the download only links as instructed 4) last but not least, it can track newest packages whose name has changed since last -downlaod. There are heuristics to determine the newest file or package +download. There are heuristics to determine the newest file or package according to file name skeleton defined in configuration. .PP This program does not replace \fIpwget\fR\|(1) because it does not offer as @@ -186,10 +186,10 @@ files, program has been designed to use \&\fB\-\-config\fR option. In the configuration file you can control the downloading with separate directives like \f(CW\*(C`save:\*(C'\fR which tells to save the file under different name. The simplest way to retrieve the latest version -of apackage from a \s-1FTP\s0 site is: +of a package from a \s-1FTP\s0 site is: .PP .Vb 2 -\& pwget \-\-new \-\-overwite \-\-verbose \e +\& pwget \-\-new \-\-overwrite \-\-verbose \e \& http://www.example.com/package\-1.00.tar.gz .Ve .PP @@ -237,7 +237,7 @@ This option can be given multiple times. Read URLs from configuration file. If no configuration file is given, file pointed by environment variable is read. See \s-1ENVIRONMENT.\s0 .Sp -The configuration file layout is envlained in section \s-1CONFIGURATION FILE\s0 +The configuration file layout is available in section \s-1CONFIGURATION FILE\s0 .IP "\fB\-\-chdir \s-1DIRECTORY\s0\fR" 4 .IX Item "--chdir DIRECTORY" Do a \fIchdir()\fR to \s-1DIRECTORY\s0 before any \s-1URL\s0 download starts. This is @@ -283,7 +283,7 @@ c in order to read it. Print help page. .IP "\fB\-m, \-\-mirror \s-1SITE\s0\fR" 4 .IX Item "-m, --mirror SITE" -If \s-1URL\s0 points to Sourcefoge download area, use mirror \s-1SITE\s0 for downloading. +If \s-1URL\s0 points to Sourceforge download area, use mirror \s-1SITE\s0 for downloading. Alternatively the full full \s-1URL\s0 can include the mirror information. And example: .Sp @@ -379,7 +379,7 @@ Run some internal tests. For maintainer .IP "\fB\-\-sleep \s-1SECONDS\s0\fR" 4 .IX Item "--sleep SECONDS" Sleep \s-1SECONDS\s0 before next \s-1URL\s0 request. When using regexp based -downlaods that may return many hits, some sites disallow successive +downloads that may return many hits, some sites disallow successive requests in within short period of time. This options makes program sleep for number of \s-1SECONDS\s0 between retrievals to overcome 'Service unavailable'. @@ -412,7 +412,7 @@ Run in test mode. Search tag \s-1NAME\s0 from the config file and download only entries defined under that tag. Refer to \fB\-\-config \s-1FILE\s0\fR option description. You can give Multiple \fB\-\-tag\fR switches. Combining this option with \fB\-\-regexp\fR -does not make sense and the concequencies are undefined. +does not make sense and the consequences are undefined. .IP "\fB\-v, \-\-verbose [\s-1NUMBER\s0]\fR" 4 .IX Item "-v, --verbose [NUMBER]" Print verbose messages. @@ -472,7 +472,7 @@ To add date and \s-1WWW\s0 site prefix t \& \-\-> YYYY\-MM\-DD::www.example.com::file.pl .Ve .PP -Get all updated files under cnfiguration file's tag updates: +Get all updated files under configuration file's tag updates: .PP .Vb 2 \& pwget \-\-verbose \-\-overwrite \-\-skip\-version \-\-new \-\-tag updates @@ -512,7 +512,7 @@ to use them anywhere else, like in URLs. .PP Path variables for \fBlcd:\fR are defined using following notation, spaces are not allowed in \s-1VALUE\s0 part (no directory names with spaces). Variable names -are case sensitive. Variables substitute environment variabales with the +are case sensitive. Variables substitute environment variables with the same name. Environment variables are immediately available. .PP .Vb 3 @@ -526,7 +526,7 @@ environment variables. Repeat, this is n look like one, but just an allowed syntax in the configuration file. Notice that there is dollar to the right hand> when variable is referred, but no dollar to the left hand side when variable is defined. Here is example -of a possible configuration file contant. The tags are hierarchically +of a possible configuration file content. The tags are hierarchically ordered without a limit. .PP Warning: remember to use different variables names in separate @@ -542,7 +542,7 @@ It is possible to include more configura Variable expansions are possible in the file name. There is no limit how many or how deep include structure is used. Every file is included only once, so it is safe to to have multiple includes to the same file. -Every include is read, so put the most importat override includes last: +Every include is read, so put the most important override includes last: .PP .Vb 2 \& INCLUDE # Global @@ -564,9 +564,9 @@ directory where a initial include file r \& \& # end .Ve -.SS "Configuraton file example" -.IX Subsection "Configuraton file example" -The configuration file can contain many , where +.SS "Configuration file example" +.IX Subsection "Configuration file example" +The configuration file can contain many , where each directive end to a colon. The usage of each directory is best explained by examining the configuration file below and reading the commentary near each directive. @@ -679,7 +679,7 @@ An example: Get newest file. This variable is reset to the value of \fB\-\-new\fR after the line has been processed. Newest means, that an \f(CW\*(C`ls\*(C'\fR command is run in the ftp, and something equivalent in \s-1HTTP \s0\*(L"ftp directories\*(R", and any files that -resemble the filename is examined, sorted and heurestically determined +resemble the filename is examined, sorted and heuristically determined according to version number of file which one is the latest. For example files that have version information in \s-1YYYYMMDD\s0 format will most likely to be retrieved right. @@ -706,7 +706,7 @@ him about the de facto standard so that more intelligently. .Sp \&\fI\s-1NOTE:\s0\fR In order the \fBnew:\fR directive to know what kind of files to -look for, it needs a file tamplate. You can use a direct link to some +look for, it needs a file template. You can use a direct link to some filename. Here the location \*(L"http://www.example.com/downloads\*(R" is examined and the filename template used is took as \*(L"file\-1.1.tar.gz\*(R" to search for files that might be newer, like \*(L"file\-9.1.10.tar.gz\*(R": @@ -715,7 +715,7 @@ to search for files that might be newer, \& http://www.example.com/downloads/file\-1.1.tar.gz new: .Ve .Sp -If the filename appeard in a named page, use directive \fBfile:\fR for +If the filename appeared in a named page, use directive \fBfile:\fR for template. In this case the \*(L"download.html\*(R" page is examined for files looking like \*(L"file.*tar.gz\*(R" and the latest is searched: .Sp @@ -772,15 +772,15 @@ Search for newer files from the content .Sp \&\s-1AN EXAMPLE\s0 .Sp -Use directive \fBrename:\fR to change the filename before soring it on -disk. Here, the version number is attached to the actila filename: +Use directive \fBrename:\fR to change the filename before storing it on +disk. Here, the version number is attached to the actual filename: .Sp .Vb 2 \& file.txt\-1.1 \& file.txt\-1.2 .Ve .Sp -The directived needed would be as follows; entries have been broken to +The directive needed would be as follows; entries have been broken to separate lines for legibility: .Sp .Vb 6 @@ -800,7 +800,7 @@ extra version number at the end of origi .Sp Contact absolute \fBpage:\fR at http://www.example.com/package.html and search A \s-1HREF\s0 urls in the page that match \fBpregexp:\fR. In addition, do -another scan and search the version number in the page from thw +another scan and search the version number in the page from the position that match \fBvregexp:\fR (submatch 2). .Sp After all the pieces have been found, use template \fBfile:\fR to make @@ -808,7 +808,7 @@ the retrievable file using the version n The actual download location is combination of \fBpage:\fR and A \s-1HREF \&\s0\fBpregexp:\fR location. .Sp -The directived needed would be as follows; entries have been broken to +The directive needed would be as follows; entries have been broken to separate lines for legibility: .Sp .Vb 7 @@ -848,9 +848,9 @@ disk from the previous download. With ve names, the comparison is possible. .IP "\fBpage:find\fR" 4 .IX Item "page:find" -\&\s-1FIXME:\s0 This opton is obsolete. do not use. +\&\s-1FIXME:\s0 This option is obsolete. do not use. .Sp -\&\s-1THIS IS FOR HTTP\s0 only. Use Use directive \fBregexp:\fR for \s-1FTP\s0 protocls. +\&\s-1THIS IS FOR HTTP\s0 only. Use Use directive \fBregexp:\fR for \s-1FTP\s0 protocols. .Sp This is a more general instruction than the \fBpage:\fR and \fBvregexp:\fR explained above. @@ -943,7 +943,7 @@ Here is a more complicated example: .Ve .Sp Let's break that one apart. You may spend some time with this example -since the possiblilities are limitless. +since the possibilities are limitless. .Sp .Vb 2 \& 1. Connect to page @@ -955,7 +955,7 @@ since the possiblilities are limitless. \& \& 3. The found link is put to $ARG (same as $_), which can be used \& to extract suitable mailbox name with a perl code that is -\& evaluated. The resulting name must apear in $ARG. Thus the code +\& evaluated. The resulting name must appear in $ARG. Thus the code \& effectively extract two items from the link to form a mailbox \& name: \& @@ -988,8 +988,8 @@ Save file under this name to local disk. Downloads can be grouped under \f(CW\*(C`tagN\*(C'\fR so that e.g. option \fB\-\-tag1\fR would start downloading files from that point on until next \f(CW\*(C`tag1\*(C'\fR is found. There are currently unlimited number of tag levels: tag1, tag2 and tag3, so -that you can arrange your downlods hierarchially in the configuration file. -For example to download all Linux files rhat you monitor, you would give +that you can arrange your downloads hierarchically in the configuration file. +For example to download all Linux files that you monitor, you would give option \fB\-\-tag linux\fR. To download only the \s-1NT\s0 Emacs latest binary, you would give option \fB\-\-tag emacs-nt\fR. Notice that you do not give the \&\f(CW\*(C`level\*(C'\fR in the option, program will find it out from the configuration @@ -1000,7 +1000,7 @@ only at next tag2, or when upper level t file. .Sp .Vb 1 -\& tag1: linux # All Linux downlods under this category +\& tag1: linux # All Linux downloads under this category \& \& tag2: sunsite tag2: another\-name\-for\-this\-spot \& @@ -1045,7 +1045,7 @@ subdirectory with version information: .Sp \&\f(CW\*(C`IMPORTANT:\*(C'\fR If the archive does not have a subdirectory for all files, a subdirectory is created and all items are unpacked under it. The default -subdirectory name in constructed from the archive name with currect date +subdirectory name in constructed from the archive name with correct date stamp in format: .Sp .Vb 1 @@ -1109,7 +1109,7 @@ go ahead and look at \fIUrlHttGet()\fR. The program was initially designed to read options from one line. It is unfortunately not possible to change the program to read configuration file directives from multiple lines, e.g. by using -backslashes (\e) to indicate contuatinued line. +backslashes (\e) to indicate continued line. .SH "ENVIRONMENT" .IX Header "ENVIRONMENT" Variable \f(CW\*(C`PWGET_CFG\*(C'\fR can point to the root configuration file. The Index: pwget/bin/pwget.pl =================================================================== --- pwget.orig/bin/pwget.pl +++ pwget/bin/pwget.pl @@ -190,10 +190,10 @@ At this point you may wonder, where woul when wget(1) C-program has been the standard for ages. Well, 1) Perl is cross platform and more easily extendable 2) You can record file download criteria to a configuration file and use perl regular -epxressions to select downloads 3) the program can anlyze web-pages +expressions to select downloads 3) the program can analyze web-pages and "search" for the download only links as instructed 4) last but not least, it can track newest packages whose name has changed since last -downlaod. There are heuristics to determine the newest file or package +download. There are heuristics to determine the newest file or package according to file name skeleton defined in configuration. This program does not replace pwget(1) because it does not offer as @@ -215,9 +215,9 @@ files, program has been designed to use B<--config> option. In the configuration file you can control the downloading with separate directives like C which tells to save the file under different name. The simplest way to retrieve the latest version -of apackage from a FTP site is: +of a package from a FTP site is: - pwget --new --overwite --verbose \ + pwget --new --overwrite --verbose \ http://www.example.com/package-1.00.tar.gz Do not worry about the filename C. The latest @@ -265,7 +265,7 @@ This option can be given multiple times. Read URLs from configuration file. If no configuration file is given, file pointed by environment variable is read. See ENVIRONMENT. -The configuration file layout is envlained in section CONFIGURATION FILE +The configuration file layout is available in section CONFIGURATION FILE =item B<--chdir DIRECTORY> @@ -315,7 +315,7 @@ Print help page. =item B<-m, --mirror SITE> -If URL points to Sourcefoge download area, use mirror SITE for downloading. +If URL points to Sourceforge download area, use mirror SITE for downloading. Alternatively the full full URL can include the mirror information. And example: @@ -416,7 +416,7 @@ Run some internal tests. For maintainer =item B<--sleep SECONDS> Sleep SECONDS before next URL request. When using regexp based -downlaods that may return many hits, some sites disallow successive +downloads that may return many hits, some sites disallow successive requests in within short period of time. This options makes program sleep for number of SECONDS between retrievals to overcome 'Service unavailable'. @@ -451,7 +451,7 @@ Run in test mode. Search tag NAME from the config file and download only entries defined under that tag. Refer to B<--config FILE> option description. You can give Multiple B<--tag> switches. Combining this option with B<--regexp> -does not make sense and the concequencies are undefined. +does not make sense and the consequences are undefined. =item B<-v, --verbose [NUMBER]> @@ -502,7 +502,7 @@ To add date and WWW site prefix to the f --> YYYY-MM-DD::www.example.com::file.pl -Get all updated files under cnfiguration file's tag updates: +Get all updated files under configuration file's tag updates: pwget --verbose --overwrite --skip-version --new --tag updates pwget -v -o -s -n -T updates @@ -539,7 +539,7 @@ to use them anywhere else, like in URLs. Path variables for B are defined using following notation, spaces are not allowed in VALUE part (no directory names with spaces). Variable names -are case sensitive. Variables substitute environment variabales with the +are case sensitive. Variables substitute environment variables with the same name. Environment variables are immediately available. @@ -552,7 +552,7 @@ environment variables. Repeat, this is n look like one, but just an allowed syntax in the configuration file. Notice that there is dollar to the right hand> when variable is referred, but no dollar to the left hand side when variable is defined. Here is example -of a possible configuration file contant. The tags are hierarchically +of a possible configuration file content. The tags are hierarchically ordered without a limit. Warning: remember to use different variables names in separate @@ -567,7 +567,7 @@ It is possible to include more configura Variable expansions are possible in the file name. There is no limit how many or how deep include structure is used. Every file is included only once, so it is safe to to have multiple includes to the same file. -Every include is read, so put the most importat override includes last: +Every include is read, so put the most important override includes last: INCLUDE # Global INCLUDE <$HOME/config/pwget.conf> # HOME overrides it @@ -586,9 +586,9 @@ directory where a initial include file r # end -=head2 Configuraton file example +=head2 Configuration file example -The configuration file can contain many , where +The configuration file can contain many , where each directive end to a colon. The usage of each directory is best explained by examining the configuration file below and reading the commentary near each directive. @@ -702,7 +702,7 @@ An example: Get newest file. This variable is reset to the value of B<--new> after the line has been processed. Newest means, that an C command is run in the ftp, and something equivalent in HTTP "ftp directories", and any files that -resemble the filename is examined, sorted and heurestically determined +resemble the filename is examined, sorted and heuristically determined according to version number of file which one is the latest. For example files that have version information in YYYYMMDD format will most likely to be retrieved right. @@ -727,14 +727,14 @@ him about the de facto standard so that more intelligently. I In order the B directive to know what kind of files to -look for, it needs a file tamplate. You can use a direct link to some +look for, it needs a file template. You can use a direct link to some filename. Here the location "http://www.example.com/downloads" is examined and the filename template used is took as "file-1.1.tar.gz" to search for files that might be newer, like "file-9.1.10.tar.gz": http://www.example.com/downloads/file-1.1.tar.gz new: -If the filename appeard in a named page, use directive B for +If the filename appeared in a named page, use directive B for template. In this case the "download.html" page is examined for files looking like "file.*tar.gz" and the latest is searched: @@ -785,13 +785,13 @@ B acts as a model for filenames t AN EXAMPLE -Use directive B to change the filename before soring it on -disk. Here, the version number is attached to the actila filename: +Use directive B to change the filename before storing it on +disk. Here, the version number is attached to the actual filename: file.txt-1.1 file.txt-1.2 -The directived needed would be as follows; entries have been broken to +The directive needed would be as follows; entries have been broken to separate lines for legibility: http://example.com/files/ @@ -809,7 +809,7 @@ AN EXAMPLE Contact absolute B at http://www.example.com/package.html and search A HREF urls in the page that match B. In addition, do -another scan and search the version number in the page from thw +another scan and search the version number in the page from the position that match B (submatch 2). After all the pieces have been found, use template B to make @@ -817,7 +817,7 @@ the retrievable file using the version n The actual download location is combination of B and A HREF B location. -The directived needed would be as follows; entries have been broken to +The directive needed would be as follows; entries have been broken to separate lines for legibility: http://www.example.com/~foo/package.html @@ -854,9 +854,9 @@ names, the comparison is possible. =item B -FIXME: This opton is obsolete. do not use. +FIXME: This option is obsolete. do not use. -THIS IS FOR HTTP only. Use Use directive B for FTP protocls. +THIS IS FOR HTTP only. Use Use directive B for FTP protocols. This is a more general instruction than the B and B explained above. @@ -933,7 +933,7 @@ Here is a more complicated example: http://www.contactor.se/~dast/svnusers/mbox.cgi pregexp:mbox.*\d$ rename:my($y,$m)=($url=~/year=(\d+).*month=(\d+)/);$ARG="$y-$m.mbox" Let's break that one apart. You may spend some time with this example -since the possiblilities are limitless. +since the possibilities are limitless. 1. Connect to page http://www.contactor.se/~dast/svnusers/mbox.cgi @@ -944,7 +944,7 @@ since the possiblilities are limitless. 3. The found link is put to $ARG (same as $_), which can be used to extract suitable mailbox name with a perl code that is - evaluated. The resulting name must apear in $ARG. Thus the code + evaluated. The resulting name must appear in $ARG. Thus the code effectively extract two items from the link to form a mailbox name: @@ -981,8 +981,8 @@ Save file under this name to local disk. Downloads can be grouped under C so that e.g. option B<--tag1> would start downloading files from that point on until next C is found. There are currently unlimited number of tag levels: tag1, tag2 and tag3, so -that you can arrange your downlods hierarchially in the configuration file. -For example to download all Linux files rhat you monitor, you would give +that you can arrange your downloads hierarchically in the configuration file. +For example to download all Linux files that you monitor, you would give option B<--tag linux>. To download only the NT Emacs latest binary, you would give option B<--tag emacs-nt>. Notice that you do not give the C in the option, program will find it out from the configuration @@ -992,7 +992,7 @@ The downloading stops at next tag of the only at next tag2, or when upper level tag is found (tag1) or or until end of file. - tag1: linux # All Linux downlods under this category + tag1: linux # All Linux downloads under this category tag2: sunsite tag2: another-name-for-this-spot @@ -1033,7 +1033,7 @@ subdirectory with version information: C If the archive does not have a subdirectory for all files, a subdirectory is created and all items are unpacked under it. The default -subdirectory name in constructed from the archive name with currect date +subdirectory name in constructed from the archive name with correct date stamp in format: package-YYYY.MMDD @@ -1102,7 +1102,7 @@ go ahead and look at UrlHttGet(). UrlHtt The program was initially designed to read options from one line. It is unfortunately not possible to change the program to read configuration file directives from multiple lines, e.g. by using -backslashes (\) to indicate contuatinued line. +backslashes (\) to indicate continued line. =head1 ENVIRONMENT @@ -2092,7 +2092,7 @@ sub EvalCode ($ $ ; $) # # DESCRIPTION # -# Check sourceforge special. The sourceofrge site does not publish +# Check sourceforge special. The sourceoforge site does not publish # direct download links. Check if this is one of those. And example: # # INPUT PARAMETERS @@ -2528,7 +2528,7 @@ sub SplitUrl ($) # DESCRIPTION # # Return basename from URL. This drops the possible -# filename from the end. The extra file is dtected +# filename from the end. The extra file is detected # from the file extension, perriod(.) # # http://some.com/~foo ok @@ -2890,7 +2890,7 @@ sub FileDeCompressedListing ( $ ) # DESCRIPTION # # Return the subdirectory where the files are in compressed archive. -# There may not be any directory or there may be several direcotries +# There may not be any directory or there may be several directories # that do not share one ROOT directory. # # INPUT PARAMETERS @@ -3128,7 +3128,7 @@ sub FileRootDirCreate ( $ $; $ ) # # **************************************************************************** -sub Unpack($ $; $ $); # must be introdced due to recursion +sub Unpack($ $; $ $); # must be introduced due to recursion sub Unpack ($ $; $ $) { @@ -3560,7 +3560,7 @@ sub LatestVersion ( $ $ ) # 1. 20 # 1. 2 # - # And giving false prioroty to "020". The leading + # And giving false priority to "020". The leading # zeroes must be treated as it the number was: # # 1. 0 20 @@ -4238,7 +4238,7 @@ sub FileListFilter ( % ) # # INPUT PARAMETERS # -# $site Dite to connect +# $site Site to connect # $path dir in SITE # # $getFile File to get @@ -5320,7 +5320,7 @@ sub UrlHttpFileCheck ( % ) if ( $onDisk ) { # If the filename contains version number - # AND skipping is on, then ignore downoad + # AND skipping is on, then ignore download if ( $SKIP_VERSION and /-\d[\d.]*\D+/ ) { @@ -5803,8 +5803,8 @@ EOF # $regexp # $regexpNo # $proxy -# \%errUrlHashRef Hahs where to store the URL-ERROR_CODE -# \%errExplanationHashRef Hash where to store ERROR_CODE-EXPLANATION +# \%errUrlHashRef Hash where to store the URL-ERROR_CODE +# \%errExplanationHashRef Hash where to store ERROR_CODE-EXPLANATION # $new Get never file # $stdout Write to stdout # $versionRegexp How to find the version number from page @@ -6008,7 +6008,7 @@ sub UrlHttp ( % ) # $path From where to read. If this is directory, read files # in directory. If this is file, copy file. # -# $file Where to put resuts. +# $file Where to put results. # $prefix [optional] Filename prefix # $postfif [optional] postfix # @@ -6926,7 +6926,7 @@ sub ConfigRead ( $ ) my $dir = dirname $file; - $staticPwd = cwd() unless $staticPwd; # set inital value + $staticPwd = cwd() unless $staticPwd; # set initial value $debug > 2 and print "$id: PWD $staticPwd\n"; Index: pwget/doc/index.html =================================================================== --- pwget.orig/doc/index.html +++ pwget/doc/index.html @@ -251,7 +251,7 @@ Description
  • Extract. After download, program can unpack the downloaded package in a civilized manner. If archive includes a root directory, then everything is ok, if not, root directory is - created upon unpack. This is desireable, because some archives may + created upon unpack. This is desirable, because some archives may not include proper package-version/ root directory. @@ -289,7 +289,7 @@ Test run - creating Emacs site-lisp example). The example configuration contains presets - for /usr/share/*/site-lisp/net hierachy + for /usr/share/*/site-lisp/net hierarchy (the install location is configurable). It contains instructions how to download many custom Emacs packages.