Hi Inaky,
> > > From: Inaky Perez-Gonzalez <[email protected]>
> > >
> > > Modified HACKING and man page to have more formation on what are the
> > > debugging options and how to enable them.
> > > ---
> > > HACKING | 10 ++++++++++
> > > doc/ofonod.8 | 5 ++++-
> > > src/main.c | 4 +++-
> > > 3 files changed, 17 insertions(+), 2 deletions(-)
> > >
> > > diff --git a/HACKING b/HACKING
> > > index ae420aa..e825185 100644
> > > --- a/HACKING
> > > +++ b/HACKING
> > > @@ -81,3 +81,13 @@ automatically includes this option.
> > >
> > > For production installations or distribution packaging it is important
> > > that
> > > the "--enable-maintainer-mode" option is NOT used.
> > > +
> > > +Note multiple arguments to -d can be specified, colon, comma or space
> > > +separated. The arguments are relative source code filenames for which
> > > +debugging output should be enabled; output shell-style globs are
> > > +accepted (e.g.: 'plugins/*:src/main.c').
> > > +
> > > +Other debugging settings that can be toggled:
> > > +
> > > + - Environment variable OFONO_AT_DEBUG (set to 1): enable AT commands
> > > + debugging
> > > diff --git a/doc/ofonod.8 b/doc/ofonod.8
> > > index 474d7fb..7bb908c 100644
> > > --- a/doc/ofonod.8
> > > +++ b/doc/ofonod.8
> > > @@ -18,7 +18,10 @@ is used to manage \fID-Bus\fP permissions for oFono.
> > > .SH OPTIONS
> > > .TP
> > > .B --debug, -d
> > > -Enable debug information output.
> > > +Enable debug information output. Note multiple arguments to -d can be
> > > +specified, colon, comma or space separated. The arguments are relative
> > > +source code filenames for which debugging output should be enabled;
> > > +output shell-style globs are accepted (e.g.: "plugins/*:src/main.c").
> > > .TP
> > > .B --nodetach, -n
> > > Don't run as daemon in background.
> >
> > you need to hook this up to automake :)
>
> Can you clarify, please?
we do wanna install the man pages, right? Then this needs man_MANS and
EXTRA_DIST magic to get included and installed.
> > > diff --git a/src/main.c b/src/main.c
> > > index 8e686ac..c5791be 100644
> > > --- a/src/main.c
> > > +++ b/src/main.c
> > > @@ -98,7 +98,9 @@ static gboolean option_version = FALSE;
> > >
> > > static GOptionEntry options[] = {
> > > { "debug", 'd', 0, G_OPTION_ARG_STRING, &option_debug,
> > > - "Specify debug options to enable", "DEBUG" },
> > > + "Specify debug options to enable (see the "
> > > + "man page for ofonod(8) for more information).",
> > > + "DEBUG" },
> > > { "nodetach", 'n', G_OPTION_FLAG_REVERSE,
> > > G_OPTION_ARG_NONE, &option_detach,
> > > "Don't run as daemon in background" },
> >
> > Please leave this out. If we have a man page and man ofonod works, then
> > this is not needed.
>
> Denis and me, AFAIR, agreed on this wording as it just gives the quick
> pointer to where the extra information is found. Again, not critical,
> but confusing feedback.
Maybe I am too old school Linux here ;)
If we have an installed man page and I don't understand the usage
information, then it is clear to just do man ofonod. I don't need the
usage tell me that.
Regards
Marcel
_______________________________________________
ofono mailing list
[email protected]
http://lists.ofono.org/listinfo/ofono
