Dear Maintainer,

  the attachment contains a shell script to fix man pages created from
a docbook file.

  Main improvements are:

# Remove trailing spaces.
# Remove .PP after .SH and .SH.
# Remove '\&' before a period inside or after a word.
#  '\&' suppresses kerning between characters on both sides of it.
# Break lines after a punctuation mark and before a parentheses.
#  To make lines shorter and easier to read, edit, and make a diff.

sed -e '/\\"/n' \
  -e '/^\.TS,^\.TE/n' \
  -e 's/  *$//' \
  -e '/^\.S[SH]/{n; /\.PP/d}' \
  -e 's/\([^ ]\)\\&\./\1./g' \
  -e 's/\([^ ][.,;!?]\)  */\1\n/g' \
  -e 's/ (/\n(/g' ${1:--}

  An example is "apt-extracttemplates.1".

Control: reassign -1 docbook-xml
Control: forcemerge -1 979737 979736

Is this a joke?

We're not going to pass our manual page output through a sed blackbox to
make it match your personal preferences. If you are unhappy with the
output of docbook, raise this with docbook, and don't report bug in
downstream users with obscure sed blackboxes they can't maintain.

Anyway, reassigning to docbook, and merging the duplicate apt bugs,
and the aptitude bug. If docbook manual pages need post-processing, it
is up to docbook to provide the tools to do so.