Chris:
These manpages should be merged into one manpage and use shadow
manpages. Note that you duplicate the same information in these
clutter manpages. In situations like this, using manpages allows
you to eliminate such duplication and only specify the text in
one manpage, the others being just shadows pointing to it.
Note how the libpango* section 3 manpages work as an example. Only
libpango-1.0.3 contains text and the other pango manpages (like
libpangox-1.0 just is a shadow to the man libpango-1.0.3 manpage).
Note when you use shadow manpages, the format of the NAME and FILES
section is a bit different, but I'm sure you can figure this out
looking at the libpango-1.0.3 example.
In the NAME section
libclutter-cairo-0.8 - Cairo library add-on of Cluter.
libclutter-gst-0.8 - Gstreamer library add-on of Cluter.
"You misspell Clutter in both places". You should say "GStreamer"
not "Gstreamer".
I think "Cairo plug-in for Clutter" and "GStreamer plug-in for Clutter"
would be more clear.
Clutter support for media playback with GStreamer, Cairo
graphics rendering, GTK+ embedding, via libclutter-gst,
libclutter-cairo, and libclutter-gtk.
I would change "GTK+ embedding, via [...]" to the following:
"and GTK+ embedding are managed via the libclutter-gst,
libclutter-cairo, and libclutter-gtk libraries."
Note you should not have a comma after the word embedding since it
is the last entry in the list. I think "are managed via the" is
more clear than just "via". Adding the word libraries to the end
of the sentence makes it a bit more clear.
Shouldn't the libclutter-glx-0.8 manpage reference some OpenGL
man page(s) in the "SEE ALSO" section?
Since libgstbase-0.10 is just a shadow manpage, I would not reference
it in the libclutter-gst man page "SEE ALSO" section.
All of your clutter manpages should reference attributes(5) in the
"SEE ALSO" section.
Brian
> ------------------------------------------------------------------------
>
> %commonents; %booktitles; ]> libclutter-cairo-0.83 19 Feb 2009 &man3;
> &release; generic &suncopy; libclutter-cairo-0.8 Cairo library add-on of
> Clutter libclutter-cairo-0.8Cairo library add-on of Cluter. Clutter uses
> OpenGL (and optionally OpenGL ES for use on Mobile and embedded
> platforms) for rendering but with an API which hides the underlying GL
> complexity from the developer. The Clutter API is intended to be easy to
> use, efficient and flexible. Clutter support for media playback with
> GStreamer, Cairo graphics rendering, GTK+ embedding, via libclutter-gst,
> libclutter-cairo, and libclutter-gtk. The following files are used by
> this library: /usr/lib/&cmd;.so Clutter shared library See attributes5
> for descriptions of the following attributes: ATTRIBUTE TYPEATTRIBUTE
> VALUE AvailabilitySUNWclutter-cairo Interface stabilityVolatile
> libclutter-glx-0.83 libcairo3 Online documentation:
> http://clutter-project.org/docs.html Written by Chris Wang, Sun
> Microsystems Inc., 2009.
> ------------------------------------------------------------------------
>
> %commonents; %booktitles; ]> libclutter-glx-0.83 19 Feb 2009 &man3;
> &release; generic &suncopy; libclutter-glx-0.8 Library for creating
> fast, visually rich and animated graphical user interfaces.
> libclutter-glx-0.8Library for creating fast, visually rich and animated
> graphical user interfaces. Clutter uses OpenGL (and optionally OpenGL ES
> for use on Mobile and embedded platforms) for rendering but with an API
> which hides the underlying GL complexity from the developer. The Clutter
> API is intended to be easy to use, efficient and flexible. Clutter
> support for media playback with GStreamer, Cairo graphics rendering,
> GTK+ embedding, via libclutter-gst, libclutter-cairo, and
> libclutter-gtk. The following files are used by this library:
> /usr/lib/&cmd;.so Clutter shared library See attributes5 for
> descriptions of the following attributes: ATTRIBUTE TYPEATTRIBUTE VALUE
> AvailabilitySUNWclutter Interface stabilityVolatile
> libclutter-cairo-0.83 libclutter-gst-0.83 libclutter-gtk-0.83 Online
> documentation: http://clutter-project.org/docs.html Written by Chris
> Wang, Sun Microsystems Inc., 2009.
> ------------------------------------------------------------------------
>
> %commonents; %booktitles; ]> libclutter-gst-0.83 19 Feb 2009 &man3;
> &release; generic &suncopy; libclutter-gst-0.8 Gstreamer library add-on
> of Clutter libclutter-gst-0.8Gstreamer library add-on of Cluter. Clutter
> uses OpenGL (and optionally OpenGL ES for use on Mobile and embedded
> platforms) for rendering but with an API which hides the underlying GL
> complexity from the developer. The Clutter API is intended to be easy to
> use, efficient and flexible. Clutter support for media playback with
> GStreamer, Cairo graphics rendering, GTK+ embedding, via libclutter-gst,
> libclutter-cairo, and libclutter-gtk. The following files are used by
> this library: /usr/lib/&cmd;.so Clutter shared library See attributes5
> for descriptions of the following attributes: ATTRIBUTE TYPEATTRIBUTE
> VALUE AvailabilitySUNWclutter-gst Interface stabilityVolatile
> libclutter-glx-0.83 libgstbase-0.103 libgstreamer-0.103 Online
> documentation: http://clutter-project.org/docs.html Written by Chris
> Wang, Sun Microsystems Inc., 2009.
> ------------------------------------------------------------------------
>
> %commonents; %booktitles; ]> libclutter-gtk-0.83 19 Feb 2009 &man3;
> &release; generic &suncopy; libclutter-gtk-0.8 Gtk library add-on of
> Clutter libclutter-gtk-0.8Gtk library add-on of Cluter. Clutter uses
> OpenGL (and optionally OpenGL ES for use on Mobile and embedded
> platforms) for rendering but with an API which hides the underlying GL
> complexity from the developer. The Clutter API is intended to be easy to
> use, efficient and flexible. Clutter support for media playback with
> GStreamer, Cairo graphics rendering, GTK+ embedding, via libclutter-gst,
> libclutter-gtk, and libclutter-gtk. The following files are used by this
> library: /usr/lib/&cmd;.so Clutter shared library See attributes5 for
> descriptions of the following attributes: ATTRIBUTE TYPEATTRIBUTE VALUE
> AvailabilitySUNWclutter-gtk Interface stabilityVolatile
> libclutter-glx-0.83 libgtk-x11-2.03 Online documentation:
> http://clutter-project.org/docs.html Written by Chris Wang, Sun
> Microsystems Inc., 2009.
