Bug#106073: recommend to install documentation into /usr/share/doc//

2015-05-08 Thread Bill Allombert
On Wed, Apr 29, 2015 at 11:56:41AM +0200, Bill Allombert wrote: > Seconded. I suggest we move forward with this and that I apply it to master > next week, if Russ is still OK with this. Done. This is the summary: * Policy: [12.3] recommend to ship additional documentation for package 'pkg'

Bug#106073: recommend to install documentation into /usr/share/doc//

2015-04-29 Thread Bill Allombert
On Sat, Jan 07, 2012 at 08:51:58AM -0800, Russ Allbery wrote: > Russ Allbery writes: > > > As always, once I start seriously poking at an area of Policy, I see > > other little things that need to be fixed as well. Here is a general > > overhaul of the additional documentation section, which sho

Bug#106073: recommend to install documentation into /usr/share/doc//

2012-01-08 Thread Charles Plessy
Le Sat, Jan 07, 2012 at 08:51:58AM -0800, Russ Allbery a écrit : > Russ Allbery writes: > > > As always, once I start seriously poking at an area of Policy, I see > > other little things that need to be fixed as well. Here is a general > > overhaul of the additional documentation section, which

Bug#106073: recommend to install documentation into /usr/share/doc//

2012-01-07 Thread Russ Allbery
Russ Allbery writes: > As always, once I start seriously poking at an area of Policy, I see > other little things that need to be fixed as well. Here is a general > overhaul of the additional documentation section, which should both > address this bug as well as a few other things. [...] Here

Bug#106073: recommend to install documentation into /usr/share/doc//

2012-01-06 Thread Russ Allbery
Charles Plessy writes: > There have been recurrent discussions about > /usr/share/doc/package-doc being a symbolic link to > /usr/share/doc/package. In my understanding, this is > discouraged now. Perhaps this desserves a footnote ? I tried to avoid changing anything in this area because we ha

Bug#106073: recommend to install documentation into /usr/share/doc//

2012-01-06 Thread Russ Allbery
Jonathan Nieder writes: > Russ Allbery wrote: > [...] >> >> - It is often a good idea to put text information files >> - (READMEs, changelogs, and so forth) that come with >> - the source package in /usr/share/doc/package >> - in the binary package. >> +

Bug#106073: recommend to install documentation into /usr/share/doc//

2012-01-06 Thread Jonathan Nieder
Hi, Russ Allbery wrote: > * Some reorganization and wording tweaks to hopefully make things clearer. Alas, there's a lot of this --- enough that I wish this had been prepared as a multiple-patch series, with for example whitespace-only changes split out. Oh, well. Onward. :) [...] > --- a/pol

Bug#106073: recommend to install documentation into /usr/share/doc//

2012-01-06 Thread Russ Allbery
As always, once I start seriously poking at an area of Policy, I see other little things that need to be fixed as well. Here is a general overhaul of the additional documentation section, which should both address this bug as well as a few other things. The changes here are: * Shared library doc

Bug#106073: recommend to install documentation into /usr/share/doc//

2010-09-01 Thread Russ Allbery
I'm not sure where in the thread we lost this, but please copy the relevant bug on Policy discussions so that we have an archived record of the discussion without having to search out the appropriate time-based portion of the debian-policy archive. I also make extensive use of debian-bug-get-bug-a

Bug#106073: recommend to install documentation into /usr/share/doc//

2010-08-27 Thread Andrew McMillan
On Fri, 2010-08-27 at 10:16 -0700, Russ Allbery wrote: > Andrew McMillan writes: > > > My personal preference would be to encourage -doc packages to install > > their files into /usr/share/doc//docs - including their > > internal administrivia. > > That would break Lintian, apt-listchanges, prob

Bug#106073: recommend to install documentation into /usr/share/doc//

2010-08-27 Thread Russ Allbery
Andrew McMillan writes: > My personal preference would be to encourage -doc packages to install > their files into /usr/share/doc//docs - including their > internal administrivia. That would break Lintian, apt-listchanges, probably the DAK processing scripts, and anything else that looks at copy

Bug#106073: recommend to install documentation into /usr/share/doc//

2010-08-27 Thread Russ Allbery
Thank you for writing this up! Ben Finney writes: > There seems to be consensus on doing this, so I've made a patch > (attached to this message) which implements that recommendation. I'm inclined to second this, although I wonder if should is too strong at this point and we should instead allow

Bug#106073: recommend to install documentation into /usr/share/doc//

2010-08-24 Thread Andrew McMillan
On Wed, 2010-08-25 at 14:55 +1000, Ben Finney wrote: > > On 27-Sep-2003, Josip Rodin wrote: > > Some proposed mandating that -doc package contents is placed into > > /usr/share/doc//, and that the administrivia such as > > copyright and changelog stays in /usr/share/doc/-doc/. This > > sounds good

Bug#106073: recommend to install documentation into /usr/share/doc//

2010-08-24 Thread Ben Finney
package debian-policy retitle 106073 recommend to install additional documentation into /usr/share/doc// tags 106073 + patch thanks On 27-Sep-2003, Josip Rodin wrote: > Some proposed mandating that -doc package contents is placed into > /usr/share/doc//, and that the administrivia such as > copyr