Manual (man) pages are outdated
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
boinc (Ubuntu) |
Fix Released
|
Undecided
|
Unassigned |
Bug Description
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_
core client was launched by Manager
boincmgr --boincargs=
... so do I have to issue boincmgr --boincargs=
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 :)
Strangely boinc cares very much who launched it. And if you add a project
as one user, and another user launches boinc in the future, even the
daemon, it won't go well.
Lately the New versions, as long as you launch boincmgr from your desktop
environment it will properly connect to the daemon.
I don't know if this behavior is specific to the debian/ubuntu build, or if
it's like this upstream as well.
-Dave
On Mar 2, 2013 2:45 PM, "MestreLion" <email address hidden> wrote:
> Public bug reported: by_manager BOINC_ARGS --launched_ by_manager /bugs.launchpad .net/bugs/ 1140560 /bugs.launchpad .net/ubuntu/ +source/ boinc/+ bug/1140560/ +subscriptions lists.alioth. debian. org/cgi- bin/mailman/ listinfo/ pkg-boinc- devel
>
> 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_
> core client was launched by Manager
> boincmgr --boincargs=
> Startup BOINC with these optional arguments.
>
> ... so do I have to issue boincmgr --boincargs=
> ??? 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:/
>
> Title:
> Manual (man) pages are outdated
>
> To manage notifications about this bug go to:
> https:/
>
> --
> pkg-boinc-devel mailing list
> <email address hidden>
> http://
>