Misc questions: add image to package, man page for cgi script, etc

[Frederic Schutz <schutz@mathgen.ch>]

[please cc: me if possible]

Hi everyone,

I'm currently packaging the w3c-markup-validator
(http://validator.w3.org:8001) and I have a few questions -- nothing that
stopped me while doing the package, but I'd just like to make sure I used
the "best" practice...

1) I'd like to add a binary file to the upstream source (an image, so that
all images are available locally and no Internet connection is needed).
Obviously, the diff file doesn't like binaries, so what is the best way to
do it ? [Currently, I added the image as a uuencoded file, with a
"Build-Depends: sharutils" (sharutils contains uudecode) and a line in
debian/rules that decodes it at build time]

2) Should I write a man page for a CGI script ? If yes, could someone
point me to an example of such a page ?

3) The package contains a Perl script that can be used either as a cgi-bin
and on the command line [it is not the same script than in 2) and I
already wrote a man page for the command line version]. I can install it
in either /usr/lib/cgi-bin or /usr/bin and put a symbolic link in the
other directory. What is the best way to do it ? I would think that I
should put it in the cgi-bin directory, since the web server (Apache) will
probably not follow a symlink, while this is not a problem for a command.
Any other thought on the question ?

That's it for the moment; I'm pretty sure I'll find other questions to ask
but any help/confirmation on these points would already be greatly
appreciated.

Thanks in advance !

Frédéric