GNOME Bugzilla – Bug 611312
Make manual page up-to-date
Last modified: 2010-03-07 15:13:43 UTC
Some users are complaining the manual page is not up-to-date. Especially, it doesn’t reference the -c option that can be found in the --help output. If the manual page is not maintained and does not follow code changes, I think it should be dropped; only --help will always remain up-to-date. Original report: http://bugs.debian.org/435155 by Neil Williams.
The man page was once required for the debian package and as such added. If debian doesn't need it anymore I would rather drop it but if you find it still useful than we can update it of course.
There was a small discussion on debian-devel recently about manual pages which merely duplicate --help output and in which upstreams are not interested. The only reasonable conclusion is that such manual pages should be dropped. So if you don’t intend to keep the manual page up-to-date, please remove it. And please also ignore requests to re-add it unless the person who asks for it also commits to maintain it.
I would prefer to keep it. I think the command line is still useful and it's nice to have a common way to get these informations. It is accessible through devhelp too. Anjuta has few command line options so I think it's not a big amount of work to keep it up to date. I haven't updated it because we are in string freeze period and I don't know if it's possible to do it now. I don't know how man page translation is done. Then, I think it's enough to document only "useful" options: -h, -s, -c, -n, -f and perhaps -g, -p. Could I leave alone the display option and the GTK+ options ?
Thanks for your bug report. I have updated the page and push the fix.