Skip to content

Commit

Permalink
installhtml: set default podpath to './lib'
Browse files Browse the repository at this point in the history
Previously (as reported nine years ago by Nick Clark in what is now
#11859), the default setting for
'podpath' was '.'.  This meant that, unless you explicitly set a
colon-delimited list of directories as the value for 'podpath', all
files containing POD under '.' were HTML-ified and installed.  The only
directories that always should have HTML-ized POD installed are 'lib'
and 'pod' itself.

Invoking 'installhtml' like the following should now DTRT:

        export HTMLDIR=$HOMEDIR/tmp/installhtml && \
        ./perl -Ilib ./installhtml    \
            --htmldir=$HTMLDIR     \
            --htmlroot=$HTMLDIR    \
            --splithead=pod/perlipc     \
            --recurse \
            --verbose 2>&1 | tee installhtml.log
  • Loading branch information
jkeenan committed Sep 11, 2021
1 parent 34aa357 commit f5e0f10
Showing 1 changed file with 3 additions and 3 deletions.
6 changes: 3 additions & 3 deletions installhtml
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ Default is current directory.
=item B<--podpath> POD search path
The list of directories to search for .pod and .pm files to be converted.
Default is 'podroot/.'.
Default is 'podroot/lib'.
=item B<--recurse> recurse on subdirectories
Expand Down Expand Up @@ -122,7 +122,7 @@ Usage: $0 --help --podpath=<name>:...:<name> --podroot=<name>
--help - this message
--podpath - colon-separated list of directories containing .pod and
.pm files to be converted (. by default).
.pm files to be converted ('lib/' by default).
--podroot - filesystem base directory from which all relative paths in
podpath stem (default is .).
--htmldir - directory to store resulting html files in relative
Expand All @@ -147,7 +147,7 @@ END_OF_USAGE
my (@podpath, $podroot, $htmldir, $htmlroot, $recurse, @splithead,
@splititem, $splitpod, $verbose, $pod2html, @ignore);

@podpath = ( "." ); # colon-separated list of directories containing .pod
@podpath = ( "lib" ); # colon-separated list of directories containing .pod
# and .pm files to be converted.
$podroot = "."; # assume the pods we want are here
$htmldir = ""; # nothing for now...
Expand Down

0 comments on commit f5e0f10

Please sign in to comment.