[Bug 1140560] [NEW] Manual (man) pages are outdated

[MestreLion]

Public bug reported:

man pages for the command-line tools boinc, boinccmd and boincmgr are
outdated, missing newer options and still listing removed ones. A quick
comparison with their respective --help shows many differences. A few
examples:

boinccmd
 --get_cc_status : missing from man

boincmgr
  -s, --systray : mentioned in man, does not exist anymore
  - several new options missing  from man

boinc
  --help shows 43 options, man lists only 21!

Also, some options are interdependent between tools and deserve extra
clarification in manual. Like:

boinc  --launched_by_manager
              core client was launched by Manager
boincmgr --boincargs=BOINC_ARGS
              Startup BOINC with these optional arguments.

... so do I have to issue boincmgr --boincargs=--launched_by_manager
??? This hardly makes any sense. Besides, why would boinc care if it was
started by manager or not?

Also:

boincmgr -a, --autostart                BOINC Manager was started by the
operating system automatically

Again, why would manager care?  And what exactly "started by the
operating system automatically" means? Gnome's "Startup Applications"?
Something else?

man pages really need some love :)

** Affects: boinc (Ubuntu)
     Importance: Undecided
         Status: New


** Tags: manpage

-- 
You received this bug notification because you are a member of Debian
BOINC Maintainers, which is subscribed to boinc in Ubuntu.
https://bugs.launchpad.net/bugs/1140560

Title:
  Manual (man) pages are outdated

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/boinc/+bug/1140560/+subscriptions