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

Re: Bug#545782: imagemagick-dbg: missing README.Debian to explain how programs are used

On Mon, Dec 28, 2009 at 11:09:34AM +0200, Jari Aalto wrote:
> "Nelson A. de Oliveira" <naoliv@debian.org> writes:
> >> README.Debian to explain how programs are used". Please provide
> >
> > The problem here is that we have a lot of -dbg packages on Debian
> > Do we need the same README file on all of them?
> >
> > ...the package maintainer is responsible in helping the user to get a
> > backtrace ... Or at least an explanation in the gdb package only.
> Neil Williams <codehelp@debian.org> writes:
> > Once the -dbg packages are installed:
> > $ gdb /usr/bin/convert
> >
> > The rest is down to the gdb manpage, no?
> >
> > gdb does all the work of locating /usr/lib/debug/usr/bin/convert, hence
> > all such files are mode 0644.
> >
> > That is down to the gdb manpage, not every single -dbg package in the
> > entire archive IMHO. There are other sources of info too, like the Wiki.
> >
> > http://wiki.debian.org/HowToGetABacktrace
> In latest lintian, a message was added that warned about missing
>     debian/REAADME.source
> in order to document the used patch system (dpatch, quilt etc.).

It is for documenting more than just the patch system.  Refer to
policy's description[0] for the full details.

> It
> could have been be argued that this information were already available
> in the manual pages.

It has, which is why the README.source is supposed to refer back to the
patch system's documentation instead of duplicating it.

[0] - http://www.debian.org/doc/debian-policy/ch-source.html#s-readmesource
GPG Key: 1024D/61326D40 2003-09-02 James Vega <jamessan@debian.org>

Attachment: signature.asc
Description: Digital signature

Reply to: