Package: release.debian.org
User: release.debian....@packages.debian.org
Usertags: pu
Tags: bullseye
X-Debbugs-Cc: samuel...@debian.org
Severity: normal

[ Reason ]
The manpage of shellcheck has been broken on Debian for a while now,
at least since oldstable/buster. The issue is that the long form of
the options are having its double dashes corrupted by pandoc due to
the way the manpage is generated.
Eg.: option "--list-optional" becomes "–list-optional"

[ Impact ]
All the long options in the manpage are wrong and lead the user to
have errors like:
$ shellcheck –list-optional
–list-optional: –list-optional: openBinaryFile: does not exist (No
such file or directory)

[ Tests ]
Confirmed the fix by checking:
https://manpages.debian.org/unstable/shellcheck/shellcheck.1.en.html
Broken version here:
https://manpages.debian.org/bullseye/shellcheck/shellcheck.1.en.html

[ Risks ]
No risks as I checked the whole manpage and there were no side effects.

[ Checklist ]
  [x] *all* changes are documented in the d/changelog
  [x] I reviewed all changes and I approve them
  [x] attach debdiff against the package in (old)stable
  [x] the issue is verified as fixed in unstable

[ Changes ]
Manpage is now generated with an extra option "-f markdown-smart" to
explicitly set the format of the input file.

[ Other info ]
https://bugs.debian.org/985003
https://bugs.debian.org/918555

The package is currently blocked from migrating to testing due to an
autopkgtest issue not exactly related to shellcheck, more details at
the initramfs-tools bug report:
https://bugs.debian.org/992798

Thank you,

-- 
Samuel Henrique <samueloph>

Attachment: shellcheck_0.7.1-1+deb11u1.debdiff
Description: Binary data

Reply via email to