Bug#822610: connman: man connmand lists options that are not valid

[Sebastian Bachmann]

Hi!

Seems fine to me, I also could not find any more and --selftest is gone now.

regards
sebastian

On 09/02/2016 10:35 AM, Alexander Sack wrote:
> tags 822610 + confirmed patch
> thanks
> 
> Hi Sebastian,
> 
> I checked latest upstream trunk and seems this issue is still present
> even if only one option i could find in the source that is not in the
> manpage.
> 
> The other way around seems to be fine now (e.g. no options referred to
> in manpage being not available at all).
> 
> { "nobacktrace", 0, G_OPTION_FLAG_REVERSE,
> G_OPTION_ARG_NONE, _backtrace,
> "Don't print out backtrace information" },
> 
> 
> Does his patch look ok for you on the manpage front?
> 
> diff --git a/doc/connman.8.in b/doc/connman.8.in
> index 9b71779..07e6ef5 100644
> --- a/doc/connman.8.in
> +++ b/doc/connman.8.in
> @@ -80,6 +80,9 @@ Never load these plugins. The option can be a
> pattern containing
>  Wifi driver that WiFi/Supplicant should use. If this flag is omitted,
>  then the value "nl80211,wext" is used by default.
>  .TP
> +.BR \-n ", " \-\-nobacktrace
> +Don't print out backtrace information.
> +.TP
>  .BR \-n ", " \-\-nodaemon
>  Do not daemonize. This is useful for debugging, and directs log output to
>  the controlling terminal in addition to syslog.
> 
> 
> 
> 2016-04-25 17:42 GMT+02:00 Sebastian Bachmann :
>> Package: connman
>> Version: 1.21-1.2+b2
>> Severity: minor
>>
>> Dear Maintainer,
>> The manpage of connmand(8) lists options, that are not available on the 
>> command
>> itself, like -t/--selftest and connmand --help shows options that are not in
>> the manpage, like -r, --nodnsproxy
>>
>> It would be kind to correct those options.
>>
>> regards
>> Sebastian Bachmann
>>
>>
>>
>> -- System Information:
>> Debian Release: stretch/sid
>>   APT prefers testing
>>   APT policy: (900, 'testing'), (1, 'unstable')
>> Architecture: amd64 (x86_64)
>> Foreign Architectures: i386
>>
>> Kernel: Linux 4.5.0-1-amd64 (SMP w/4 CPU cores)
>> Locale: LANG=de_AT.UTF-8, LC_CTYPE=de_AT.UTF-8 (charmap=UTF-8)
>> Shell: /bin/sh linked to /bin/dash
>> Init: systemd (via /run/systemd/system)
>>
>> Versions of packages connman depends on:
>> ii  dbus 1.10.8-1
>> ii  init-system-helpers  1.29
>> ii  libc62.22-6
>> ii  libdbus-1-3  1.10.8-1
>> ii  libglib2.0-0 2.48.0-1
>> ii  libgnutls30  3.4.10-4
>> ii  libreadline6 6.3-8+b4
>> ii  libxtables11 1.6.0-2
>> ii  lsb-base 9.20160110
>>
>> Versions of packages connman recommends:
>> ii  bluez  5.36-1
>> ii  ofono  1.15-3
>> ii  wpasupplicant  2.3-2.3
>>
>> Versions of packages connman suggests:
>> pn  indicator-network  
>>
>> -- no debconf information



signature.asc
Description: OpenPGP digital signature

Bug#822610: connman: man connmand lists options that are not valid

[Alexander Sack]

tags 822610 + confirmed upstream
thanks

more tags for the record :)...

2016-09-02 10:35 GMT+02:00 Alexander Sack :
> tags 822610 + confirmed patch
> thanks
>
> Hi Sebastian,
>
> I checked latest upstream trunk and seems this issue is still present
> even if only one option i could find in the source that is not in the
> manpage.
>
> The other way around seems to be fine now (e.g. no options referred to
> in manpage being not available at all).
>
> { "nobacktrace", 0, G_OPTION_FLAG_REVERSE,
> G_OPTION_ARG_NONE, _backtrace,
> "Don't print out backtrace information" },
>
>
> Does his patch look ok for you on the manpage front?
>
> diff --git a/doc/connman.8.in b/doc/connman.8.in
> index 9b71779..07e6ef5 100644
> --- a/doc/connman.8.in
> +++ b/doc/connman.8.in
> @@ -80,6 +80,9 @@ Never load these plugins. The option can be a
> pattern containing
>  Wifi driver that WiFi/Supplicant should use. If this flag is omitted,
>  then the value "nl80211,wext" is used by default.
>  .TP
> +.BR \-n ", " \-\-nobacktrace
> +Don't print out backtrace information.
> +.TP
>  .BR \-n ", " \-\-nodaemon
>  Do not daemonize. This is useful for debugging, and directs log output to
>  the controlling terminal in addition to syslog.
>
>
>
> 2016-04-25 17:42 GMT+02:00 Sebastian Bachmann :
>> Package: connman
>> Version: 1.21-1.2+b2
>> Severity: minor
>>
>> Dear Maintainer,
>> The manpage of connmand(8) lists options, that are not available on the 
>> command
>> itself, like -t/--selftest and connmand --help shows options that are not in
>> the manpage, like -r, --nodnsproxy
>>
>> It would be kind to correct those options.
>>
>> regards
>> Sebastian Bachmann
>>
>>
>>
>> -- System Information:
>> Debian Release: stretch/sid
>>   APT prefers testing
>>   APT policy: (900, 'testing'), (1, 'unstable')
>> Architecture: amd64 (x86_64)
>> Foreign Architectures: i386
>>
>> Kernel: Linux 4.5.0-1-amd64 (SMP w/4 CPU cores)
>> Locale: LANG=de_AT.UTF-8, LC_CTYPE=de_AT.UTF-8 (charmap=UTF-8)
>> Shell: /bin/sh linked to /bin/dash
>> Init: systemd (via /run/systemd/system)
>>
>> Versions of packages connman depends on:
>> ii  dbus 1.10.8-1
>> ii  init-system-helpers  1.29
>> ii  libc62.22-6
>> ii  libdbus-1-3  1.10.8-1
>> ii  libglib2.0-0 2.48.0-1
>> ii  libgnutls30  3.4.10-4
>> ii  libreadline6 6.3-8+b4
>> ii  libxtables11 1.6.0-2
>> ii  lsb-base 9.20160110
>>
>> Versions of packages connman recommends:
>> ii  bluez  5.36-1
>> ii  ofono  1.15-3
>> ii  wpasupplicant  2.3-2.3
>>
>> Versions of packages connman suggests:
>> pn  indicator-network  
>>
>> -- no debconf information

Bug#822610: connman: man connmand lists options that are not valid

[Alexander Sack]

tags 822610 + confirmed patch
thanks

Hi Sebastian,

I checked latest upstream trunk and seems this issue is still present
even if only one option i could find in the source that is not in the
manpage.

The other way around seems to be fine now (e.g. no options referred to
in manpage being not available at all).

{ "nobacktrace", 0, G_OPTION_FLAG_REVERSE,
G_OPTION_ARG_NONE, _backtrace,
"Don't print out backtrace information" },


Does his patch look ok for you on the manpage front?

diff --git a/doc/connman.8.in b/doc/connman.8.in
index 9b71779..07e6ef5 100644
--- a/doc/connman.8.in
+++ b/doc/connman.8.in
@@ -80,6 +80,9 @@ Never load these plugins. The option can be a
pattern containing
 Wifi driver that WiFi/Supplicant should use. If this flag is omitted,
 then the value "nl80211,wext" is used by default.
 .TP
+.BR \-n ", " \-\-nobacktrace
+Don't print out backtrace information.
+.TP
 .BR \-n ", " \-\-nodaemon
 Do not daemonize. This is useful for debugging, and directs log output to
 the controlling terminal in addition to syslog.



2016-04-25 17:42 GMT+02:00 Sebastian Bachmann :
> Package: connman
> Version: 1.21-1.2+b2
> Severity: minor
>
> Dear Maintainer,
> The manpage of connmand(8) lists options, that are not available on the 
> command
> itself, like -t/--selftest and connmand --help shows options that are not in
> the manpage, like -r, --nodnsproxy
>
> It would be kind to correct those options.
>
> regards
> Sebastian Bachmann
>
>
>
> -- System Information:
> Debian Release: stretch/sid
>   APT prefers testing
>   APT policy: (900, 'testing'), (1, 'unstable')
> Architecture: amd64 (x86_64)
> Foreign Architectures: i386
>
> Kernel: Linux 4.5.0-1-amd64 (SMP w/4 CPU cores)
> Locale: LANG=de_AT.UTF-8, LC_CTYPE=de_AT.UTF-8 (charmap=UTF-8)
> Shell: /bin/sh linked to /bin/dash
> Init: systemd (via /run/systemd/system)
>
> Versions of packages connman depends on:
> ii  dbus 1.10.8-1
> ii  init-system-helpers  1.29
> ii  libc62.22-6
> ii  libdbus-1-3  1.10.8-1
> ii  libglib2.0-0 2.48.0-1
> ii  libgnutls30  3.4.10-4
> ii  libreadline6 6.3-8+b4
> ii  libxtables11 1.6.0-2
> ii  lsb-base 9.20160110
>
> Versions of packages connman recommends:
> ii  bluez  5.36-1
> ii  ofono  1.15-3
> ii  wpasupplicant  2.3-2.3
>
> Versions of packages connman suggests:
> pn  indicator-network  
>
> -- no debconf information

Bug#822610: connman: man connmand lists options that are not valid

[Sebastian Bachmann]

Package: connman
Version: 1.21-1.2+b2
Severity: minor

Dear Maintainer,
The manpage of connmand(8) lists options, that are not available on the command
itself, like -t/--selftest and connmand --help shows options that are not in
the manpage, like -r, --nodnsproxy

It would be kind to correct those options.

regards
Sebastian Bachmann



-- System Information:
Debian Release: stretch/sid
  APT prefers testing
  APT policy: (900, 'testing'), (1, 'unstable')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 4.5.0-1-amd64 (SMP w/4 CPU cores)
Locale: LANG=de_AT.UTF-8, LC_CTYPE=de_AT.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages connman depends on:
ii  dbus 1.10.8-1
ii  init-system-helpers  1.29
ii  libc62.22-6
ii  libdbus-1-3  1.10.8-1
ii  libglib2.0-0 2.48.0-1
ii  libgnutls30  3.4.10-4
ii  libreadline6 6.3-8+b4
ii  libxtables11 1.6.0-2
ii  lsb-base 9.20160110

Versions of packages connman recommends:
ii  bluez  5.36-1
ii  ofono  1.15-3
ii  wpasupplicant  2.3-2.3

Versions of packages connman suggests:
pn  indicator-network  

-- no debconf information