Bug#106073: status of this bug?
On Sat, Sep 27, 2003 at 06:01:51PM +0200, Josip Rodin wrote:
> Some proposed mandating that -doc package contents is placed into
> /usr/share/doc/<package>/, and that the administrivia such as copyright and
> changelog stays in /usr/share/doc/<package>-doc/. This sounds good to me
> because it has a sort of an internal logic, the -doc suffix only exists
> because of packaging, it's actually the docs for <package>. Plus, it's
> shorter, less to type.
This is also my position.
> >From strolling the archives, I get the impression that the majority shares
> this sentiment, with one downside: someone might wander into the -doc/ dir
> and wonder where are the docs. This can be easily alleviated by placing a
This is true just because a lot of packages used, erroneously in my
opinion, that convention. It's just a matter or (re)training users,
maybe simply adding a README.Debian with a FAQ "Where the hell is the
documentation?".
Anyway I see that this position is already in the bucket and I will
avoid partecipating in the discussion just for an AOL.
> I would recommend that we have policy suggest ("may") the latter solution,
> and see how it goes from there. Any objections?
You mean "may" add the symlink, right? If so it will be a good solution
also in my opinion. But I think that the placement of documentation in
/usr/share/doc/<package> should be _mandated_ by the policy so that bugs
can be reported against packages having documentation in -doc.
Thanks for your clarification.
Cheers.
--
Stefano Zacchiroli -- Master in Computer Science @ Uni. Bologna, Italy
zack@{cs.unibo.it,debian.org,bononia.it} - http://www.bononia.it/zack/
" I know you believe you understood what you think I said, but I am not
sure you realize that what you heard is not what I meant! " -- G.Romney
Reply to: