Frank Küster <[EMAIL PROTECTED]> writes: > Severity: important
This severity is wrong. A disagreement with the content of a documentation file does not have "a major effect on the usability of a package". Please don't gratuitously exaggerate the importance of bugs. > The README.Debian file currently starts with: > > ,---- > | README for Debian Autoconf package > | ---------------------------------- > | > | No documentation, because the Debian project has decided that the GNU > | FDL is not an acceptable license for documentation. If you disagree > | with this decision, write to [EMAIL PROTECTED] I can't > | do anything about it by myself, so filing bugs will do you no good. > | Sorry. > `---- > > A README.Debian file is not the correct place to indicate your > disagreement with debian-legal's, or rather the project as a whole's, > decisions. Every fact in that paragraph is correct, and no opinions are stated. It does not even take a side--instead, it says that if you disagree with the project's opinion, you must take it up with the project, not with me. The goal is to discourage filing more bugs complaining about the lack of documentation; I can't do anything about that, short of writing a manual myself. > More gravely, it doesn't help the user. Instead, > > - This README should point to the autoconf-doc package in non-free, and > maybe also to online versions of the document > > - autoconf(1) should be patched so that the "SEE ALSO" section explains > that autoconf-doc needs to be installed. > > The last change has nothing to do with freeness, it should be good > practice for any package whose documentation is split off into a > separate binary package. The autoconf-doc package didn't exist when I wrote the README.Debian. It is probably a good idea to do these things now, although I do not like the idea of adding more references to non-free software. -- "Note that nobody reads every post in linux-kernel. In fact, nobody who expects to have time left over to actually do any real kernel work will read even half. Except Alan Cox, but he's actually not human, but about a thousand gnomes working in under-ground caves in Swansea." --Linus
