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

Reply via email to