Filippo Giunchedi wrote:
...how about hinting about a debian-specific behavior and pointing the user to README.Debian from the manpage ?
I've seen that done, where a paragraph is tacked on near the end of man pages that notes there is Debian-specific behavior and references README.Debian. That's a step in the right direction, but a separate paragraph near the end can still be overlooked, and assumes the user is going to read the full man page before starting to use the tool. Worse still, you'll be left with text in one part that contradicts text elsewhere.
Ideally the documentation of altered behavior should be integrated into the man page, and maintained as a patch, just as you would for a code modification.
In this case the changes should amount to just a couple of sentences. -Tom -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
