Excerpts from Stefano Zacchiroli's message of man mar 16 11:33:04 +0100 2009: > On Sun, Mar 15, 2009 at 02:23:31AM +0100, Jonas Smedegaard wrote: > > It sounds like you didn't actually look at my proposed snippet, > > containing the following comment: > > > > # This very makefile snippet ideally is provided by the topgit > > # package - see bug#513952. > > # Also, Debian Policy 4.14 implicitly recommends build-depending on > > # packages containing build documentation referenced from > > # Debian.source. > > I looked at the snippet, but overlooked the comment (and I was not > aware of the policy recommendation). > > Given that it is so, let it be. Even if it still sounds me a bit dumb > to have people fiddle with, or just be aware of, topgit _just_ to > fulfill a documentation requirement automatically. It is not a big > deal either.
I felt it a bit dumb too - until I thought about it a bit more: Debian has a noble rule of not relying on network access. Imagine sitting offline and wanting to read that packaging documentation, just to realize that it contains only pointers to inaccessible files. As a packager you are still left with the choice of providing more self-contained pakcages by *not* referring to package-external documentation but write something up yourself. Kind regards, - Jonas -- * Jonas Smedegaard - idealist og Internet-arkitekt * Tlf.: +45 40843136 Website: http://dr.jones.dk/ [x] quote me freely [ ] ask before reusing [ ] keep private
signature.asc
Description: PGP signature
