Simon:
> Because man pages in GPM tarball are in Debian system format, I update
> them for Solaris. Attach man page for 3 applications.
>
> Please review or comment.
- I think the DESCRIPTION could explain more about what each program
does. A description like "gnome-power-statistics is the gui
program for the gnome power management infrastructure." just doesn't
tell me much about this program. Likewise the description for
gnome-power-preferences doesn't tell me much about what preferences
I can change.
- Are there other power manager related kernel programs that should
be mentioned in SEE ALSO?
One thing I notice about these manpages is that your <variablelist> are
not making good use of the termlength element. Note this:
---
--help Show summary of options.
--verbose Show extra debugging.
--no-daemon Do not detach gnome-power-
manager into the background
so that error messages will
be displayed on console.
--debug Only show specific debugging
options. Useful for develop-
ers only.
---
The spacing is a little ugly because there is a lot of white
space between the arguments and the explanation. Note that in
the variablelist tag, you can specify the termlength element
to control the spacing, Try some of these:
<variablelist termlength="wide">
<variablelist termlength="narrow">
<variablelist termlength="xtranarrow">
<variablelist termlength="medium">
<variablelist termlength="xtranarrow">
<variablelist termlength="fullscreen">
See which looks best. I think the FILES sections are using an
especially bad termlength value.
I also agree with Alan that there is no need for two trivial examples.
Just have one trivial example.
