Hi, On Tue, Nov 16, 2010 at 10:06:50PM -0500, Jeff Mahoney wrote:
This goes to the heart of something I was thinking about earlier. We have so many checks in the creation of RPMs that make the distribution more stable and easier to use for users. What about adding a check to ensure that executables installed in standard locations *must* have man pages?
There are a bunch of commands with no help and no man pages. In a lot of cases it would be enough to have a man page that states the user probably shouldn't run the command manually.
Yes, I absolutely second this. And I am also concerned about the fragmentation with documentation. There are plenty of READMEs under /usr/share/doc, but they mainly contain compilation hints. Some have man pages, other info pages, for some you only need the --help output. I think everyone here oversaw "obvious" documentation. The problem is usually not the amount or quality of documentation, but to find the right one. Some once started to use README.SUSE for starter help, but it seems it is not widely used anymore: locate README.SUSE | wc -l 38 Maybe writing such a file should be encouraged, because it could also contain links to the openSUSE wiki or upstream docs. -- Bye, Stephan Barth Novell Technical Services, Worldwide Support Services Linux SUSE LINUX GmbH, GF: Felix Imendörffer, HRB 21284 (AG Nürnberg) Maxfeldstr. 5, D-90409 Nuremberg -- To unsubscribe, e-mail: opensuse-factory+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-factory+help@opensuse.org