[Debichem-devel] Bug#1014740: pdb-tools: mangled manual pages: errors, duplicate text

[Paul Wise]

Package: pdb-tools
Version: 2.5.0-1
Severity: normal
Usertags: doc

The manual pages appear to be a bit mangled.

 * They have errors about options the programs don't expect.
 * They have lots of duplicate paragraphs of text. 

These are probably caused by incorrect help2man invocation.

$ zgrep ERROR /usr/share/man/man1/pdb_*
/usr/share/man/man1/pdb_chainbows.1.gz:.TH pdb_chainbows "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_chainbows.1.gz:pdb_chainbows \- manual page for ERROR!! File not found or not readable: '--version'
/usr/share/man/man1/pdb_chainxseg.1.gz:.TH pdb_chainxseg "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_chainxseg.1.gz:pdb_chainxseg \- manual page for ERROR!! File not found or not readable: '--version'
/usr/share/man/man1/pdb_chkensemble.1.gz:.TH pdb_chkensemble "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_chkensemble.1.gz:pdb_chkensemble \- manual page for ERROR!! File not found or not readable: '--version'
/usr/share/man/man1/pdb_delhetatm.1.gz:.TH pdb_delhetatm "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_delhetatm.1.gz:pdb_delhetatm \- manual page for ERROR!! File not found or not readable: '--version'
/usr/share/man/man1/pdb_element.1.gz:.TH pdb_element "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_element.1.gz:pdb_element \- manual page for ERROR!! File not found or not readable: '--version'
/usr/share/man/man1/pdb_fetch.1.gz:.TH pdb_fetch "1" "July 2022" "ERROR!! Invalid PDB code: '--version'" "User Commands"
/usr/share/man/man1/pdb_fetch.1.gz:pdb_fetch \- manual page for ERROR!! Invalid PDB code: '--version'
/usr/share/man/man1/pdb_fromcif.1.gz:.TH pdb_fromcif "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_fromcif.1.gz:pdb_fromcif \- manual page for ERROR!! File not found or not readable: '--version'
/usr/share/man/man1/pdb_gap.1.gz:.TH pdb_gap "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_gap.1.gz:pdb_gap \- manual page for ERROR!! File not found or not readable: '--version'
/usr/share/man/man1/pdb_intersect.1.gz:.TH pdb_intersect "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_intersect.1.gz:pdb_intersect \- manual page for ERROR!! File not found or not readable: '--version'
/usr/share/man/man1/pdb_keepcoord.1.gz:.TH pdb_keepcoord "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_keepcoord.1.gz:pdb_keepcoord \- manual page for ERROR!! File not found or not readable: '--version'
/usr/share/man/man1/pdb_merge.1.gz:.TH pdb_merge "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_merge.1.gz:pdb_merge \- manual page for ERROR!! File not found or not readable: '--version'
/usr/share/man/man1/pdb_mkensemble.1.gz:.TH pdb_mkensemble "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_mkensemble.1.gz:pdb_mkensemble \- manual page for ERROR!! File not found or not readable: '--version'
/usr/share/man/man1/pdb_segxchain.1.gz:.TH pdb_segxchain "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_segxchain.1.gz:pdb_segxchain \- manual page for ERROR!! File not found or not readable: '--version'
/usr/share/man/man1/pdb_selhetatm.1.gz:.TH pdb_selhetatm "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_selhetatm.1.gz:pdb_selhetatm \- manual page for ERROR!! File not found or not readable: '--version'
/usr/share/man/man1/pdb_splitchain.1.gz:.TH pdb_splitchain "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_splitchain.1.gz:pdb_splitchain \- manual page for ERROR!! File not found or not readable: '--version'
/usr/share/man/man1/pdb_splitmodel.1.gz:.TH pdb_splitmodel "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_splitmodel.1.gz:pdb_splitmodel \- manual page for ERROR!! File not found or not readable: '--version'
/usr/share/man/man1/pdb_splitseg.1.gz:.TH pdb_splitseg "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_splitseg.1.gz:pdb_splitseg \- manual page for ERROR!! File not found or not readable: '--version'
/usr/share/man/man1/pdb_tidy.1.gz:.TH pdb_tidy "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_tidy.1.gz:pdb_tidy \- manual page for ERROR!! File not found or not readable: '--version'
/usr/share/man/man1/pdb_tocif.1.gz:.TH pdb_tocif "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_tocif.1.gz:pdb_tocif \- manual page for ERROR!! File not found or not readable: '--version'
/usr/share/man/man1/pdb_uniqname.1.gz:.TH pdb_uniqname "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_uniqname.1.gz:pdb_uniqname \- manual page for ERROR!! File not found or not readable: '--version'
/usr/share/man/man1/pdb_validate.1.gz:.TH pdb_validate "1" "July 2022" "ERROR!! File not found or not readable: '--version'" "User Commands"
/usr/share/man/man1/pdb_validate.1.gz:pdb_validate \- manual page for ERROR!! File not found or not readable: '--version'

$ zgrep 'This program is part of the' /usr/share/man/man1/pdb_*
/usr/share/man/man1/pdb_b.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_b.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_chain.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_chain.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_chainbows.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_chainbows.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_chainxseg.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_chainxseg.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_chkensemble.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_chkensemble.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_delchain.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_delchain.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_delelem.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_delelem.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_delhetatm.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_delhetatm.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_delinsertion.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_delinsertion.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_delres.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_delres.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_delresname.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_delresname.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_element.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_element.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_fetch.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_fetch.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_fixinsert.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_fixinsert.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_fromcif.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_fromcif.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_gap.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_gap.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_head.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_head.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_intersect.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_intersect.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_keepcoord.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_keepcoord.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_merge.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_merge.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_mkensemble.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_mkensemble.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_occ.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_occ.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_reatom.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_reatom.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_reres.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_reres.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_rplchain.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_rplchain.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_rplresname.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_rplresname.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_seg.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_seg.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_segxchain.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_segxchain.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_selaltloc.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_selaltloc.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_selatom.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_selatom.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_selchain.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_selchain.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_selelem.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_selelem.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_selhetatm.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_selhetatm.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_selmodel.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_selmodel.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_selres.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_selres.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_selresname.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_selresname.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_selseg.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_selseg.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_shiftres.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_shiftres.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_sort.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_sort.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_splitchain.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_splitchain.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_splitmodel.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_splitmodel.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_splitseg.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_splitseg.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_tidy.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_tidy.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_tocif.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_tocif.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_tofasta.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_tofasta.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_uniqname.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_uniqname.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_validate.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_validate.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_wc.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be
/usr/share/man/man1/pdb_wc.1.gz:This program is part of the `pdb\-tools` suite of utilities and should not be

-- System Information:
Debian Release: bookworm/sid
 APT prefers testing-debug
 APT policy: (900, 'testing-debug'), (900, 'testing'), (860, 'testing-proposed-updates-debug'), (860, 'testing-proposed-updates'), (850, 'buildd-testing-proposed-updates'), (800, 'unstable-debug'), (800, 'unstable'), (790, 'buildd-unstable'), (700, 'experimental-debug'), (700, 'experimental'), (690, 'buildd-experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 5.18.0-2-amd64 (SMP w/8 CPU threads; PREEMPT)
Kernel taint flags: TAINT_OOT_MODULE, TAINT_UNSIGNED_MODULE
Locale: LANG=en_AU.utf8, LC_CTYPE=en_AU.utf8 (charmap=UTF-8), LANGUAGE=en_AU:en
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages pdb-tools depends on:
ii python3 3.10.4-1+b1
pn python3-pdbtools <none>

pdb-tools recommends no packages.

pdb-tools suggests no packages.

-- 
bye,
pabs

https://wiki.debian.org/PaulWise
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: This is a digitally signed message part
URL: <http://alioth-lists.debian.net/pipermail/debichem-devel/attachments/20220711/bbc08cd9/attachment.sig>