Alan Coopersmith wrote: > Have you considered asking on docs-discuss at opensolaris.org for man > page review? That's where the doc experts would be found. (I've > gone ahead and done just that - for their benefit, your original > message is attached so they can see the entire man pages.)
Thanks. > >> EXAMPLES >> Example 1: Launching gnome-power-statistics >> >> example% gnome-power-statistics >> >> Example 2: Launching gnome-power-statistics with displaying >> extra debugging messages. >> >> example% gnome-power-statistics --verbose > > I'd rather see no examples section than including such obvious and > trivial examples. If you must keep it, then Example 2 should either > be "Launching gnome-power-statistics with the display of extra > debugging messages" or "Launching gnome-power-statistics displaying > extra debugging messages" - "with displaying" is poor grammar. Sure. Will keep only one, "Launching gnome-power-statistics with the display of extra debugging messages". > >> NOTES >> This manual page was written by Simon Zheng >> simon.zheng at sun.com for the Debian system. > > Don't you mean for OpenSolaris, not Debian? That's a copy I created in Debian format for GNOME community. There's 3 executables in /usr/bin. Earlier man pages for gnome-power-manager and gnome-power-preferences are ready in GNOME community, but that of gnome-power-statistics is missing. So firstly I put one copy into upstream firstly. > >> DESCRIPTION >> This manual page documents briefly the gnome-power- >> preferences. > > That seems like a useless paragraph, of course the man page documents > the program, that's what all man pages do - why not delete it and just > leave the description as: Will remove all the similar paragraphs. Thanks, -Simon > >> gnome-power-preferences is the configuration gui for the >> gnome power management infrastructure. > > > > ------------------------------------------------------------------------ > > Subject: > [jds-review] Man page for GNOME Power Manager > From: > "simon.zheng at sun.com" <Simon.Zheng at Sun.COM> > Date: > Thu, 14 Feb 2008 15:44:01 +0800 > To: > jds-review at opensolaris.org > > To: > jds-review at opensolaris.org > CC: > Jeff.Cai at Sun.COM > > > Hi, > > 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. > > Thanks, > -Simon >
