On Wed, Jun 22, 2011 at 09:36:43AM +0100, Neil Williams wrote: > On Wed, 22 Jun 2011 01:20:04 +0200 > Yann Dirson <ydir...@free.fr> wrote: > > Don't play around with bug reports. This bug has been closed.
I am not playing, and systematically disregarding people opinions will not improve anything. > > > Patch is not acceptable as it demonstrates misunderstandings of the > > > existing documentation and the manpage is quite long enough as it is. > > > There is plenty more documentation on the website and the wiki. > > > > Ok I admit that I have misunderstood, but this answer is not that useful. > > > > So (appart from *not* being documented as a keyword, "include" here > > just does not have the usual semantics we see in "include" mechanisms > > - and as such, without proper docs, it is sure to confuse users. > > > > So the question is, how best can we describe the behaviour ? > > Expand the Wiki content, there's no place for this in the manpage which > is already too long. Suitable content from the wiki can then be > included into the website. Sorry if the manpage is too long, but that's not a reason to assume that all of the package's user have net access. Documentation can also live in /usr/share/doc/. A package with bad documentation is not much more than useless. There are lots a ways the existing multistrap documentation can be improved, and diluting all of it in a hardly-searchable wiki is not part of them. Improving the manpage is, and I suggest you reconsider your position of refusing to improve it. Further more, closing a bugreport because *you* have no incentive to address a problem that someone took the pain to report is bad: it drives potential contributors away from this project, and suppresses a list of possible tasks a newcomer could look at. -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
