<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<title>DocKnot Changes</title>
<link rel="stylesheet" href="/~eagle/styles/faq-short.css" type="text/css" />
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rel="up" href="./" title="DocKnot" />
<link rel="top" href="../../" />
</head>
<!-- Converted by DocKnot %VERSION% on %DATE% -->
<body>
<table class="navbar"><tr>
<td class="navleft"></td>
<td>
<a href="../../">Russ Allbery</a>
> <a href="../">Software</a>
> <a href="./">DocKnot</a>
</td>
<td class="navright"></td>
</tr></table>
<h1>Revision history for DocKnot</h1>
<p class="subheading">
Last modified %DATE%
</p>
<h2>v8.0.0 - %DATE%</h2>
<ul>
<li>
<p>
DocKnot now uses semantic versioning for the package and modules, with
a v prefix to work with Perl's packaging system.
</p>
</li>
<li>
<p>
Merge faq2html into this package as App::DocKnot::Spin::Text, and add a
new command, docknot spin-text, which takes roughly the same options as
faq2html. This adds the ability to convert text files in my personal
format into HTML.
</p>
</li>
<li>
<p>
Support *.spin pointers in addition to *.faq pointers for external text
files. *.faq files are deprecated and support will be removed in a
future version of DocKnot.
</p>
</li>
<li>
<p>
Support version numbers prefixed with v in release tarball names, since
this appears to be the convention for Perl modules that use semantic
versions.
</p>
</li>
<li>
<p>
Change the docknot.yaml field orphaned to unmaintained, and change the
templates to say the package is not maintained instead of orphaned.
This terminology is more precise and less metaphorical.
</p>
</li>
<li>
<p>
Remove support information from the README.md and README templates for
packages that are no longer maintained, and adjust some of the wording
there and in the thread template.
</p>
</li>
<li>
<p>
Add missing </address> closing tag in pages rendered from Markdown.
</p>
</li>
<li>
<p>
Fix typo in README.md template for ExtUtils::MakeMaker packages.
</p>
</li>
<li>
<p>
Fix the URL in the footer added by docknot spin to point to DocKnot
instead of my old web tools page.
</p>
</li>
</ul>
<h2>7.01 - %DATE%</h2>
<ul>
<li>
<p>
Correctly handle Unicode output from commands run by pointers and from
POD processing by Pod::Thread. Previous versions since 6.01 were
double-encoding. Thanks to Julien ÉLIE for the report.
</p>
</li>
<li>
<p>
Follow symlinks to ordinary files in docknot spin, just not
directories. The Path::Iterator::Rule conversion in 6.01 broke copying
of files referenced by symlink.
</p>
</li>
<li>
<p>
The \size spin always used 1024-based units. It now correctly uses the
KiB, MiB, etc. abbreviations to match.
</p>
</li>
</ul>
<h2>7.00 - %DATE%</h2>
<ul>
<li>
<p>
Various module APIs now take Path::Tiny objects instead of string
paths. Roughly, any module API that is not called directly by
App::DocKnot::Command now expects paths in the form of Path::Tiny
objects and does not always do an explicit conversion.
</p>
</li>
<li>
<p>
Fix Unicode handling in App::DocKnot::Spin::Thread methods. Output to
files was handled correctly in most cases, but output to a scalar or to
standard output was not, nor was output to a file when the input was
generated by another program.
</p>
</li>
<li>
<p>
Fix processing of old-style pointers in docknot spin.
</p>
</li>
<li>
<p>
Fix import error when running docknot release.
</p>
</li>
<li>
<p>
Fix .versions updating via docknot release when the package that needs
to be udpated is not the first line of the file.
</p>
</li>
<li>
<p>
When spinning an input tree, process all .rss files first in a separate
pass. This ensurse the output files are seen when spinning the tree
into the output directory.
</p>
</li>
<li>
<p>
Ensure docknot dist always regenerates the *.tar.xz file if necessary,
rather than reusing one left over from a previous build of the same
version.
</p>
</li>
<li>
<p>
Always recreate GnuPG signatures when generating distribution tarballs
in docknot dist.
</p>
</li>
<li>
<p>
When copying distribution files with docknot release, also copy the
modification timestamps of those files.
</p>
</li>
</ul>
<table class="navbar"><tr>
<td class="navleft"></td>
<td>
<a href="../../">Russ Allbery</a>
> <a href="../">Software</a>
> <a href="./">DocKnot</a>
</td>
<td class="navright"></td>
</tr></table>
</body>
</html>