2024-07-07: DocKnot v8.0.0
DocKnot is my static web site generator, with additional features for
managing software releases and package documentation.
This release switches to semantic versioning for the Perl modules, hence
the v prefix to the version number. This appears to be the
standard in the Perl world for indicating that the version follows the
semantic versioning standard. That also
required adding support to DocKnot for release tarballs whose version
string starts with v. I plan to convert all of my Perl modules to
semantic versioning in their next releases.
The main change in this release is that it incorporates my old faq2html
script that was previously used to convert text documents to HTML for
publication. This code was imported into DocKnot and integrated with the
rest of the package, so text documents can now be referenced by
*.spin pointers rather than the (now-deprecated) *.faq
files.
The long delay in the release is because I was hoping to refactor the
faq2html code to work as a proper module with no global state and to
follow my current Perl coding guidelines before releasing a version of
DocKnot containing it, but the refactoring is taking forever and support
for v-prefixed versions was blocking other releases, so I'm
releasing it in a less-than-ideal state and hoping to fix it later.
There are also a few other bug fixes and improvements, the most notable of
which is probably that the footer on generated web pages now points
properly to the DocKnot distribution page rather than my old spin page.
You can get the latest version from CPAN or from the
DocKnot distribution page.
2024-07-07: rra-c-util 11.0.0
rra-c-util is my collection of utility and test functions that I keep
synchronized between my packages. The big change in this release is that
I've switched to semantic versions, which I plan to do for all of my
packages, and I've started using
scriv to manage
a Markdown change log. We've been using scriv for a while at work, so I
have finally gotten on board the change log fragment train rather
than assuming linear commits.
This release also raises the minimum Perl version for all of the Perl
support code to 5.12 so that I can use semantic versions for all modules,
and updates the perltidy configuration with lots of improvements from
Julien ÉLIE. There are also the normal variaty of bug fixes and more
minor improvements.
You can get the latest version from the rra-c-util distribution page.
2024-07-10: podlators v6.0.0
podlators is the collection of Perl modules and front-end scripts that
convert POD documentation to *roff manual pages or text, possibly with
formatting intended for pagers.
This release continues the simplifications that I've been doing in the
last few releases and now uniformly escapes - characters and single
quotes, disabling all special interpretation by *roff formatters and
dropping the heuristics that were used in previous versions to try to
choose between possible interpretations of those characters. I've come
around to the position that POD simply is not semantically rich enough to
provide sufficient information to successfully make a more nuanced
conversion, and these days Unicode characters are available for authors
who want to be more precise.
This version also drops support for Perl versions prior to 5.12 and
switches to semantic versioning for all modules. I've added a v
prefix to the version number, since that is the convention for Perl module
versions that use semantic versioning.
This release also works around some changes to the man macros in groff
1.23.0 to force persistent ragged-right justification when formatted with
nroff and fixes a variety of other bugs.
You can get the latest release from CPAN or from the
podlators distribution page.
2024-07-12: podlators v6.0.1
This is a small bug-fix release to remove use of autodie from the build
system for the module. podlators is included in Perl core, and at the
point when it is built during the core build, the prerequisites of the
autodie module are not yet met, so the module is not available. This
release reverts to explicit error checking in all the files used by the
build system.
Thanks to James E Keenan for the report and the analysis.
You can get the latest version from CPAN or the
podlators distribution page.
2024-07-14: DocKnot 8.0.1
DocKnot is my static web site generator, with some additional features for
managing software releases.
This release fixes some bugs in the newly-added conversion of text to HTML
that were due to my still-incomplete refactoring of that code. It still
uses some global variables, and they were leaking between different
documents and breaking the formatting. It also fixes consistency problems
with how the style parameter in *.spin files was interpreted, and
fixes some incorrect docknot update-spin behavior.
You can get the latest version from CPAN or from the
DocKnot distribution page.
2024-07-14: podlators v6.0.2
podlators contains the Perl modules and scripts used to convert Perl's
documentation language, POD, to text and manual pages.
This is another small bug fix release that is part of iterating on getting
the new podlators incorproated into Perl core. The bug fixed in this
release was another build system bug I introduced in recent refactorings,
this time breaking the realclean target so that some generated scripts
were not removed. Thanks to James E Keenan for the report.
You can get the latest version from CPAN or from the
podlators distribution page.