[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

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

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.


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: