From 04222ffc96f123dc4bd344265df02400aca1581c Mon Sep 17 00:00:00 2001 From: Amitai Schleier Date: Thu, 8 Mar 2018 12:36:21 -0500 Subject: [PATCH] Report bug. --- ...ount_stopped_rendering_markdown_links.mdwn | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 doc/bugs/discount_stopped_rendering_markdown_links.mdwn diff --git a/doc/bugs/discount_stopped_rendering_markdown_links.mdwn b/doc/bugs/discount_stopped_rendering_markdown_links.mdwn new file mode 100644 index 000000000..a5dd0bac0 --- /dev/null +++ b/doc/bugs/discount_stopped_rendering_markdown_links.mdwn @@ -0,0 +1,24 @@ +# What I did + +Upgraded from 3.20180105 to 3.20180228 (from pkgsrc). +No change to installed Text::Markdown::Discount (0.11nb4 from pkgsrc, using upstream's bundled Discount library). + +# What I expected to happen + +Markdown-style links to continue being rendered as before. + +# What actually happened + +Markdown-style links stopped being links. +Instead, they render the part in square brackets as ordinary text. + +# Proximate cause + +In [f46e429](http://source.ikiwiki.branchable.com/?p=source.git;a=commitdiff;h=f46e429d96ead32943cb2670d7686df8c77de361), if I comment out the `MKD_GITHUBTAGS` if block, the problem goes away. + +# Further causes and possible solutions + +Some guesses: + +- Sufficiently old versions of the Discount library may break when passed unrecognized flags, in which case ikiwiki might want to version-check before passing flags +- The version of the Discount library bundled with upstream Text::Markdown::Discount may be extremely old, in which case pkgsrc might want to make it depend instead on an external Discount package -- 2.39.2