Re: Fwd: Bug#688299: libpolyorb3: using diversions in M-A: same packages is a bad idea

[Ludovic Brenta <ludovic@ludovic-brenta.org>]

>>From its content, the polyorb the manpage has nothing to do in
>  libpolyorb[soversion]: /usr/share/man
>
>>From its content, I would advice
>  libpolyorb-doc: /usr/share/man
> or, easyer to find:
>  libpolyorb-doc: /usr/share/doc/libpolyorb-doc

Since

- there is a single man page in libpolyorb3, namely polyorb.7.gz
- this man page is very short and almost useless, as it contains a very
  small part of the whole doc
- this man page is for developers (who use the -dev package) not users
  (who use the shared library package),

my advice is to remove this man page from the shared library package
altogether.  This small change can have a freeze exception and migrate
to wheezy.

After that, decide where this man page should go; I feel that it is not
useful as is, so perhaps a better thing would be to rewrite it so it
becomes an introduction to PolyORB, and package it together with the
executables in libpolyorb3-dev.  That however should wait for after
wheezy is released (or uploaded to experimental in the mean time).

PS: man pages that document an executable must not be in a -doc package,
they must be in the same package as the executable.

-- 
Ludovic Brenta.