App-DocKnot
view release on metacpan or search on metacpan
- 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.
- Support version numbers prefixed with v in release tarball names, since
this appears to be the convention for Perl modules that use semantic
versions.
- 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.
- 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.
- Add missing </address> closing tag in pages rendered from Markdown.
- Fix typo in README.md template for ExtUtils::MakeMaker packages.
- When generating text output, put the footnotes containing URLs for
links immediately following the containing paragraph rather than the
end of the text block. This is both more readable and avoids odd
placement of the footnotes when a template adds further paragraphs to
the end of a text block containing footnotes.
- Do not wrap paragraphs in output that seem to be a bunch of short
lines, and add support for broken quotes (multiple short lines, such as
poetry) in quotes in the thread template.
- Adjust the README and README.md template to say that make warnings
requires either GCC or Clang, instead of only mentioning GCC.
- Adjust the README.md wording for the list information URL when package
releases are announced on a mailing list.
- Add support for additional developer documentation links in the thread
output template.
- Add support for contributed program documentation links in the thread
output template.
t/data/spin/input/journal/2011-08/006.th view on Meta::CPAN
\==[ro] [2] [\number(packed)[\strong[\under[\1]]: \2]]
\==[r] [2] [\number(packed)[\strong[\1]: \2]]
\==[po] [2] [\number(packed)[\emph[\under[\1]]: \2]]
\==[p] [2] [\number(packed)[\emph[\1]: \2]]
\==[o] [2] [\number(packed)[\under[\1]: \2]]
\==[n] [2] [\number(packed)[\1: \2]]
\ro[The Lord Of The Rings Trilogy, by J.R.R. Tolkien][
It's a boring winner because it always wins, but it's an amazing book
and I can't argue with it. I'll probably never review this one since
I'm not sure I have anything original to say about it.
]
\ro[The Hitchhiker's Guide To The Galaxy, by Douglas Adams][
Probably the best humorous SF. I've read the entire series except for
\cite[The Salmon of Doubt], the unfinished book left when Adams died.
Will re-read them all at some point.
]
\ro[Ender's Game, by Orson Scott Card][
I intensely dislike Card's politics, but this book is still very good.
It's on my re-read list so that I can write a proper review of it.
]
t/data/spin/input/journal/2011-08/006.th view on Meta::CPAN
\ro[\link[../../reviews/books/0-380-78862-4.html][Cryptonomicon], by Neal
Stephenson][
Fantastic stuff. Not SF in any traditional sense. It's a combination
of secret history and contemporary thriller. But it's written in the
Stephenson massive entertaining infodumping style, so it feels like SF
and makes it onto lists like this. It's very long, but I've read it
twice and don't regret it.
]
\n[World War Z, by Max Brooks][
Have a hard time believing this really belongs here, but I haven't
read it so I couldn't say for sure.
]
\ro[\link[../../reviews/books/0-345-27505-5.html][The Last Unicorn], by
Peter S. Beagle][
Eh, it's not a bad book, but I'm not sure it really belongs on this
list. But it does have an aesthetic that's hard to find in any other
book.
]
\ro[\link[../../reviews/books/0-380-70821-3.html][The Forever War], by Joe
Haldeman][
t/data/spin/input/journal/2011-08/006.th view on Meta::CPAN
]
\ro[\link[../../reviews/books/0-345-45940-7.html][Perdido Street Station],
by China Mieville][
Revolutionary fantasy. The founding book of New Weird. I think
\link[../../reviews/books/0-345-44438-8.html][The Scar] is a better
book, but I can't argue with this being here.
]
\n[The Xanth Series, by Piers Anthony][I've been warned off these.]
\ro[The Space Trilogy, by C.S. Lewis][
I need to re-read this and write long reviews of them, since I have a
lot to say about them. But they need to be read in the context of the
Christian faith to make any sense.
]
\date[Posted: 2011-08-13 00:09]
\signature
t/data/spin/output/journal/2011-08/006.html view on Meta::CPAN
The rules are to bold the works one has read in their entirety and
italicize the ones you've read part of but not finished. I'll add
underlining the works that I own, which provides some indication of the
things that I've not read but that are on my to-read list.
</p>
<ol>
<li class="packed"><strong><u>The Lord Of The Rings Trilogy, by J.R.R. Tolkien</u></strong>:
It's a boring winner because it always wins, but it's an amazing book
and I can't argue with it. I'll probably never review this one since
I'm not sure I have anything original to say about it.</li>
<li class="packed"><strong><u>The Hitchhiker's Guide To The Galaxy, by Douglas Adams</u></strong>:
Probably the best humorous SF. I've read the entire series except for
<cite>The Salmon of Doubt</cite>, the unfinished book left when Adams died.
Will re-read them all at some point.</li>
<li class="packed"><strong><u>Ender's Game, by Orson Scott Card</u></strong>:
I intensely dislike Card's politics, but this book is still very good.
It's on my re-read list so that I can write a proper review of it.</li>
<li class="packed"><strong>The Dune Chronicles, by Frank Herbert</strong>:
I've read the whole series, but only own the first, which is by far
the best. I'm tempted to re-read the whole series at some point,
t/data/spin/output/journal/2011-08/006.html view on Meta::CPAN
Really far too much Gaiman on this list. But also a good book.</li>
<li class="packed"><strong><u><a href="../../reviews/books/0-380-78862-4.html">Cryptonomicon</a>, by Neal
Stephenson</u></strong>:
Fantastic stuff. Not SF in any traditional sense. It's a combination
of secret history and contemporary thriller. But it's written in the
Stephenson massive entertaining infodumping style, so it feels like SF
and makes it onto lists like this. It's very long, but I've read it
twice and don't regret it.</li>
<li class="packed">World War Z, by Max Brooks:
Have a hard time believing this really belongs here, but I haven't
read it so I couldn't say for sure.</li>
<li class="packed"><strong><u><a href="../../reviews/books/0-345-27505-5.html">The Last Unicorn</a>, by
Peter S. Beagle</u></strong>:
Eh, it's not a bad book, but I'm not sure it really belongs on this
list. But it does have an aesthetic that's hard to find in any other
book.</li>
<li class="packed"><strong><u><a href="../../reviews/books/0-380-70821-3.html">The Forever War</a>, by Joe
Haldeman</u></strong>:
A very important response to the whole sub-genre of military SF, and
very influential.</li>
<li class="packed"><u>Small Gods, by Terry Pratchett</u>: Getting to it.</li>
t/data/spin/output/journal/2011-08/006.html view on Meta::CPAN
failures and frantic faffing about than the other ones. Borderline
for this list, but probably deserves to be here.</li>
<li class="packed"><strong><u><a href="../../reviews/books/0-345-45940-7.html">Perdido Street Station</a>,
by China Mieville</u></strong>:
Revolutionary fantasy. The founding book of New Weird. I think
<a href="../../reviews/books/0-345-44438-8.html">The Scar</a> is a better
book, but I can't argue with this being here.</li>
<li class="packed">The Xanth Series, by Piers Anthony: I've been warned off these.</li>
<li class="packed"><strong><u>The Space Trilogy, by C.S. Lewis</u></strong>:
I need to re-read this and write long reviews of them, since I have a
lot to say about them. But they need to be read in the context of the
Christian faith to make any sense.</li>
<div class="date"><p>
Posted: %DATE% 00:09 — <span class="no-comment"><a href="/~eagle/faqs/comments.html">Why no comments?</a></span>
</p></div>
</ol>
<address>
Last <a href="https://www.eyrie.org/~eagle/software/docknot/">spun</a>
%DATE% from thread modified %DATE%
</address>
t/data/spin/output/journal/debian.rss view on Meta::CPAN
The rules are to bold the works one has read in their entirety and
italicize the ones you've read part of but not finished. I'll add
underlining the works that I own, which provides some indication of the
things that I've not read but that are on my to-read list.
</p>
<ol>
<li class="packed"><strong><u>The Lord Of The Rings Trilogy, by J.R.R. Tolkien</u></strong>:
It's a boring winner because it always wins, but it's an amazing book
and I can't argue with it. I'll probably never review this one since
I'm not sure I have anything original to say about it.</li>
<li class="packed"><strong><u>The Hitchhiker's Guide To The Galaxy, by Douglas Adams</u></strong>:
Probably the best humorous SF. I've read the entire series except for
<cite>The Salmon of Doubt</cite>, the unfinished book left when Adams died.
Will re-read them all at some point.</li>
<li class="packed"><strong><u>Ender's Game, by Orson Scott Card</u></strong>:
I intensely dislike Card's politics, but this book is still very good.
It's on my re-read list so that I can write a proper review of it.</li>
<li class="packed"><strong>The Dune Chronicles, by Frank Herbert</strong>:
I've read the whole series, but only own the first, which is by far
the best. I'm tempted to re-read the whole series at some point,
t/data/spin/output/journal/debian.rss view on Meta::CPAN
Really far too much Gaiman on this list. But also a good book.</li>
<li class="packed"><strong><u><a href="https://www.eyrie.org/~eagle/reviews/books/0-380-78862-4.html">Cryptonomicon</a>, by Neal
Stephenson</u></strong>:
Fantastic stuff. Not SF in any traditional sense. It's a combination
of secret history and contemporary thriller. But it's written in the
Stephenson massive entertaining infodumping style, so it feels like SF
and makes it onto lists like this. It's very long, but I've read it
twice and don't regret it.</li>
<li class="packed">World War Z, by Max Brooks:
Have a hard time believing this really belongs here, but I haven't
read it so I couldn't say for sure.</li>
<li class="packed"><strong><u><a href="https://www.eyrie.org/~eagle/reviews/books/0-345-27505-5.html">The Last Unicorn</a>, by
Peter S. Beagle</u></strong>:
Eh, it's not a bad book, but I'm not sure it really belongs on this
list. But it does have an aesthetic that's hard to find in any other
book.</li>
<li class="packed"><strong><u><a href="https://www.eyrie.org/~eagle/reviews/books/0-380-70821-3.html">The Forever War</a>, by Joe
Haldeman</u></strong>:
A very important response to the whole sub-genre of military SF, and
very influential.</li>
<li class="packed"><u>Small Gods, by Terry Pratchett</u>: Getting to it.</li>
t/data/spin/output/journal/debian.rss view on Meta::CPAN
failures and frantic faffing about than the other ones. Borderline
for this list, but probably deserves to be here.</li>
<li class="packed"><strong><u><a href="https://www.eyrie.org/~eagle/reviews/books/0-345-45940-7.html">Perdido Street Station</a>,
by China Mieville</u></strong>:
Revolutionary fantasy. The founding book of New Weird. I think
<a href="https://www.eyrie.org/~eagle/reviews/books/0-345-44438-8.html">The Scar</a> is a better
book, but I can't argue with this being here.</li>
<li class="packed">The Xanth Series, by Piers Anthony: I've been warned off these.</li>
<li class="packed"><strong><u>The Space Trilogy, by C.S. Lewis</u></strong>:
I need to re-read this and write long reviews of them, since I have a
lot to say about them. But they need to be read in the context of the
Christian faith to make any sense.</li>
]]></description>
<pubDate>%DATE%</pubDate>
<guid>https://www.eyrie.org/~eagle/journal/2011-08/006.html</guid>
</item>
</channel>
</rss>
t/data/spin/output/journal/index.html view on Meta::CPAN
<ol>
<li class="packed"><strong><u>The Lord Of The Rings Trilogy, by J.R.R. Tolkien</u></strong>:
It's a boring winner because it always wins, but it's an amazing book
and I can't argue with it. I'll probably never review this one since
I'm not sure I have anything original to say about it.</li>
<li class="packed"><strong><u>The Hitchhiker's Guide To The Galaxy, by Douglas Adams</u></strong>:
Probably the best humorous SF. I've read the entire series except for
<cite>The Salmon of Doubt</cite>, the unfinished book left when Adams died.
Will re-read them all at some point.</li>
<li class="packed"><strong><u>Ender's Game, by Orson Scott Card</u></strong>:
I intensely dislike Card's politics, but this book is still very good.
It's on my re-read list so that I can write a proper review of it.</li>
<li class="packed"><strong>The Dune Chronicles, by Frank Herbert</strong>:
I've read the whole series, but only own the first, which is by far
the best. I'm tempted to re-read the whole series at some point,
t/data/spin/output/journal/index.html view on Meta::CPAN
Really far too much Gaiman on this list. But also a good book.</li>
<li class="packed"><strong><u><a href="https://www.eyrie.org/~eagle/reviews/books/0-380-78862-4.html">Cryptonomicon</a>, by Neal
Stephenson</u></strong>:
Fantastic stuff. Not SF in any traditional sense. It's a combination
of secret history and contemporary thriller. But it's written in the
Stephenson massive entertaining infodumping style, so it feels like SF
and makes it onto lists like this. It's very long, but I've read it
twice and don't regret it.</li>
<li class="packed">World War Z, by Max Brooks:
Have a hard time believing this really belongs here, but I haven't
read it so I couldn't say for sure.</li>
<li class="packed"><strong><u><a href="https://www.eyrie.org/~eagle/reviews/books/0-345-27505-5.html">The Last Unicorn</a>, by
Peter S. Beagle</u></strong>:
Eh, it's not a bad book, but I'm not sure it really belongs on this
list. But it does have an aesthetic that's hard to find in any other
book.</li>
<li class="packed"><strong><u><a href="https://www.eyrie.org/~eagle/reviews/books/0-380-70821-3.html">The Forever War</a>, by Joe
Haldeman</u></strong>:
A very important response to the whole sub-genre of military SF, and
very influential.</li>
<li class="packed"><u>Small Gods, by Terry Pratchett</u>: Getting to it.</li>
t/data/spin/output/journal/index.html view on Meta::CPAN
failures and frantic faffing about than the other ones. Borderline
for this list, but probably deserves to be here.</li>
<li class="packed"><strong><u><a href="https://www.eyrie.org/~eagle/reviews/books/0-345-45940-7.html">Perdido Street Station</a>,
by China Mieville</u></strong>:
Revolutionary fantasy. The founding book of New Weird. I think
<a href="https://www.eyrie.org/~eagle/reviews/books/0-345-44438-8.html">The Scar</a> is a better
book, but I can't argue with this being here.</li>
<li class="packed">The Xanth Series, by Piers Anthony: I've been warned off these.</li>
<li class="packed"><strong><u>The Space Trilogy, by C.S. Lewis</u></strong>:
I need to re-read this and write long reviews of them, since I have a
lot to say about them. But they need to be read in the context of the
Christian faith to make any sense.</li>
</ol>
<p class="footer">2011-08-13 00:09 —
<a href="https://www.eyrie.org/~eagle/journal/2011-08/006.html">Permanent link</a></p>
<h2>2007-01-14: Review: Fermat's Enigma</h2>
<p>
Review: <cite>Fermat's Enigma</cite>, by Simon Singh
t/data/spin/output/journal/index.rss view on Meta::CPAN
The rules are to bold the works one has read in their entirety and
italicize the ones you've read part of but not finished. I'll add
underlining the works that I own, which provides some indication of the
things that I've not read but that are on my to-read list.
</p>
<ol>
<li class="packed"><strong><u>The Lord Of The Rings Trilogy, by J.R.R. Tolkien</u></strong>:
It's a boring winner because it always wins, but it's an amazing book
and I can't argue with it. I'll probably never review this one since
I'm not sure I have anything original to say about it.</li>
<li class="packed"><strong><u>The Hitchhiker's Guide To The Galaxy, by Douglas Adams</u></strong>:
Probably the best humorous SF. I've read the entire series except for
<cite>The Salmon of Doubt</cite>, the unfinished book left when Adams died.
Will re-read them all at some point.</li>
<li class="packed"><strong><u>Ender's Game, by Orson Scott Card</u></strong>:
I intensely dislike Card's politics, but this book is still very good.
It's on my re-read list so that I can write a proper review of it.</li>
<li class="packed"><strong>The Dune Chronicles, by Frank Herbert</strong>:
I've read the whole series, but only own the first, which is by far
the best. I'm tempted to re-read the whole series at some point,
t/data/spin/output/journal/index.rss view on Meta::CPAN
Really far too much Gaiman on this list. But also a good book.</li>
<li class="packed"><strong><u><a href="https://www.eyrie.org/~eagle/reviews/books/0-380-78862-4.html">Cryptonomicon</a>, by Neal
Stephenson</u></strong>:
Fantastic stuff. Not SF in any traditional sense. It's a combination
of secret history and contemporary thriller. But it's written in the
Stephenson massive entertaining infodumping style, so it feels like SF
and makes it onto lists like this. It's very long, but I've read it
twice and don't regret it.</li>
<li class="packed">World War Z, by Max Brooks:
Have a hard time believing this really belongs here, but I haven't
read it so I couldn't say for sure.</li>
<li class="packed"><strong><u><a href="https://www.eyrie.org/~eagle/reviews/books/0-345-27505-5.html">The Last Unicorn</a>, by
Peter S. Beagle</u></strong>:
Eh, it's not a bad book, but I'm not sure it really belongs on this
list. But it does have an aesthetic that's hard to find in any other
book.</li>
<li class="packed"><strong><u><a href="https://www.eyrie.org/~eagle/reviews/books/0-380-70821-3.html">The Forever War</a>, by Joe
Haldeman</u></strong>:
A very important response to the whole sub-genre of military SF, and
very influential.</li>
<li class="packed"><u>Small Gods, by Terry Pratchett</u>: Getting to it.</li>
t/data/spin/output/journal/index.rss view on Meta::CPAN
failures and frantic faffing about than the other ones. Borderline
for this list, but probably deserves to be here.</li>
<li class="packed"><strong><u><a href="https://www.eyrie.org/~eagle/reviews/books/0-345-45940-7.html">Perdido Street Station</a>,
by China Mieville</u></strong>:
Revolutionary fantasy. The founding book of New Weird. I think
<a href="https://www.eyrie.org/~eagle/reviews/books/0-345-44438-8.html">The Scar</a> is a better
book, but I can't argue with this being here.</li>
<li class="packed">The Xanth Series, by Piers Anthony: I've been warned off these.</li>
<li class="packed"><strong><u>The Space Trilogy, by C.S. Lewis</u></strong>:
I need to re-read this and write long reviews of them, since I have a
lot to say about them. But they need to be read in the context of the
Christian faith to make any sense.</li>
]]></description>
<pubDate>%DATE%</pubDate>
<guid>https://www.eyrie.org/~eagle/journal/2011-08/006.html</guid>
</item>
<item>
<title>Review: Fermat's Enigma</title>
<link>https://www.eyrie.org/~eagle/reviews/books/1-250-30112-2.html</link>
<description><![CDATA[
t/data/spin/output/software/docknot/changes.html view on Meta::CPAN
<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>
t/data/spin/text/input/docknot-changes view on Meta::CPAN
- 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.
- Support version numbers prefixed with v in release tarball names, since
this appears to be the convention for Perl modules that use semantic
versions.
- 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.
- 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.
- Add missing </address> closing tag in pages rendered from Markdown.
- Fix typo in README.md template for ExtUtils::MakeMaker packages.
t/data/spin/text/output/docknot-changes.html view on Meta::CPAN
<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>
( run in 0.729 second using v1.01-cache-2.11-cpan-d7a12ab2c7f )