One of the main changes is now you should be able to move the order of the items in config.cfg, remove and add new objects (docsets/chapters/links) and everything should be updated and linked properly without forcing a compelete rebuild.
Here are the recent (this week mainly) DocSet changes:
- force rebuild of the docset if the cache file is missing, even if the target files aren't older than the source files. (this is the case where for some reason the cache file was deleted)
- set the 'stitle' attr to 'title' for 'links' type, if missing.
- handle the case where docsets, links or chapters get removed from docset. The cache uses only active items (listed in config.cfg) changed the way the ordered list of items is constructed
- fix the bug where a change in the main config.cfg won't indicate a modified docset and therefore a rebuild.
- I cannot reproduce the trailing punctuation character bug (http://foo.com/bar.html.) in automatic POD URLifier, removed from the TODO list.
- copy_glob => [foo/*] doesn't pick .dot_files in the first level of subdir, because in unix glob() '*' doesn't match .files. 'copy_glob => [foo]' works correctly. Now this behavior is documented. also fixed wrong documentation about copy_glob regarding creating empty dirs.
- improve the logic for searching resources. If I have a setting of search_paths as:
search_paths => [qw(
docs/1.0
.
)],and the resource request is for L<foo|win32::binaries> everything is cool if there is docs/1.0/win32/binaries.pod. However if somebody is doing a better job and doing a fully qualified request like L<foo|docs::1.0::win32::binaries> the page used to be reported as not found, because it's cached in the prescan as 'docs/1.0' => 'win32/binaries.pod'. Now this problem is solved.
- add a special handling for L<...|foo::bar::index> so only foo::bar is checked that it's a dir in the search path and index.html is autogenerated. This allows us to do L<the guide|guide::index>
- improve the exception handling of incorrect paths in config.cfg, when a chapter item cannot be found.
- now the 'src' link links to a file.orig so it won't be overwritten by the generated html if the source was .html in first place.
- fix a bug where a few sizes fell through in format_bytes
- add a cool feature where the titles are linked their own entries in the TOC, so one can easily move back and forward between big sections of the document.
- change the timestamp to use local(gmtime) instead of ambiguous mm/dd/yy
- move to use pre-bar css class for the virtual bar in <pre></pre> sects (the user has to define this class).
- replaced call to `which` with a portable which function in DocSet::Util (taken from Apache::Build in modperl-2.0 and made to use the PATHEXT env variable on WinNT: I can re-submit this one into the modperl-2.0 tree if you think that'll be useful, it finds the specified file terminated by .exe, .bat, etc.. [Per Einar Ellefsen <[EMAIL PROTECTED]>]
- use perl %ENV instead of `env` to set PERL5LIB whenh calling docset_build. [Per Einar Ellefsen <[EMAIL PROTECTED]>]
- had to replace all regexes that used a directory/file path, and use quotemeta() there, because the backslahes created illegal escape sequences. [Per Einar Ellefsen <[EMAIL PROTECTED]>]
- changed some things before calling URI in DocSet::Doc; it not, the directory name would be considered part of the host name and thus not tried to be opened. So I replaced \ with /, as that'll open the file correctly. [Per Einar Ellefsen <[EMAIL PROTECTED]>]
__________________________________________________________________ Stas Bekman JAm_pH ------> Just Another mod_perl Hacker http://stason.org/ mod_perl Guide ---> http://perl.apache.org mailto:[EMAIL PROTECTED] http://use.perl.org http://apacheweek.com http://modperlbook.org http://apache.org http://ticketmaster.com
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
