Hi,
I've just used the man page to help me set up an (almost) working apt-ftparchive config file.

The manual was... outdated... in places, which I've tried to fix. I've done a whitespace cleanup of the docbook and picked up a few typos on the way through. I hope you'll be able to apply the patch(s) without problem, but I haven't tested them.

The attached file is a complete replacement for doc/apt-ftparchive.1.xml . I'll email the same file split into smaller, easier to review patches when I get a bug number.

Thanks,
kk

If you choose to apply these smaller patches, save the whitespace for
last, since its most likely to break the other patches.

A note i forgot to include in my original email:
I inserted a number of FIXMEs into the docbook. The source was
non-obvious to me (not a cpp coder), but i didn't want to leave them as
is. feel free to skip those hunks.
kk