Attached are gpilotd and libgpilotd manpages modified based on Brian's review. Please review again.
Thanks, Jerry Brian Cameron wrote: > > Jerry: > >> These four libs are delivered with SUNWgnome-pilot, they are missing >> originally. Please noete libgpilotdcm and libgpilotdconduit are >> shadow manpages. Please review. > > gpilotd(1): > > - I would just say "gnome-pilot daemon" rather than "gnome-pilot gpilotd > daemon" > - I would remove "shipped with Gnome-Pilot package" in the DESCRIPTION > - I'd say "that monitors" rather than "that monitor". > > - You say: > > Gnome-pilot has an API for creating conduits as well as a couple > of default conduits, including one for backing up files, and > one for installing files. > > I would say: > > Gnome-pilot has default conduits for backing up files and > installing files. It also includes an API for creating conduits. > > - You say: > > > for example, the Evolution mail/calendar/memo PIM application > > suite. > > I would make this a new sentence. > > - I would also include the new section 3 manpages in the "SEE ALSO" > section. Also there seem to already be a manpage for > gpilot-install-file.1. I would mention this in SEE ALSO as well. > > libgpilotd(3): > > - I would say "C interfaces" rather than "C interface". I would > also change "gnome-pilot gpilotd daemon" to just "gnome-pilot > daemon". > > - I would say "The gpilotd daemon monitors for pilot connections > on one or more devices." instead of the first sentence of the > DESCRIPTION. Note "connections" rather than "connects". No > need to mention about the package. > > - I would also reword the "It has an API for creating conduits" > sentence as I show above for gpilotd(1). > > - The SEE ALSO section should also mention gnome-pilot-install-file.1 > > - Are there any API references installed to /usr/share/gtk-doc, or > someplace else, perhaps online? If so, I would also mention a > reference to the docs in the SEE ALSO section. > > Brian -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://mail.opensolaris.org/pipermail/jds-review/attachments/20080801/3605a135/attachment.html> -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://mail.opensolaris.org/pipermail/jds-review/attachments/20080801/3605a135/attachment-0001.html>
