Brian: Please see my comments below Chris
Brian Cameron ??: > Chris: > > >> These four libs are delivered with SUNWgtkmm, they are missing manpage >> originally. Attached are the manpage for them. >> > > We have a separate manpage for libgiomm, but we lump all the > other "mm" interfaces into a single manpage. This seems a bit > odd. Shouldn't we either have separate manpages for them all > or a single manpage with shadow manpages? > > These four libs are delivered in SUNWgtkmm package (pangomm will be moved out), and all belong to gtkmm project. > The NAME says: C++ interface for GTK+ > However, this manpage seems to be intended to be a shadow manpage > for libatkmm, libgdkmm, etc. also? So just saying "for GTK+" > doesn't seem right. > What I mean GTK+ here is the GTK+ project, I think they all listed under gtk.org. I can make it clear if needed. > The DESCRIPTION section only explains gtkmm, and not the other > libraries that you plan to shadow manpage to this one. > gtkmm is a name of the project, it includes these four libs, just like the manpage for libpango, it inclues libpango, libpangox etc. but in the Description, we only use the statement Pango. > You list libpango-1.4 manpage in the DESCRIPTION but you > list "libpangomm-1.4" in the FILES section. This seems an > error. > This is a slip, I'll correct > The "SEE ALSO" section should probably refer to the libatk-1.0, > libgdk_pixbuf-2.0, libgdk_pixbuf_xlib-2.0 manpages if the > pixbuf interfaces are also in these libraries? Are they? > > Would be good to reference the libgiomm-2.4.3 and libglibmm-2.4.3 > manpages in the "SEE ALSO" section, I think. > > Good point. > The manpages referenced should also be updated to reference their > corresponding "mm" manpage, so libatk-1.0 should refer to the > libatkmm-1.6 manpage. > > Good point > There seems to be a /usr/share/doc/gtkmm-2.4 directory, but this > doesn't seem referenced in the FILE section as a documentation > reference. Why don't the other interfaces have docs installed > to /usr/share/doc? Even if we don't install docs, we probably > should provide online doc links for each interface. > /usr/share/doc/gtkmm-2.4 directory contains the demo sourcecode in /usr/demo/jds/bin/gtkmm, I will add it to the FILE section > I notice a /usr/share/doc/cairomm directory. Should we also > have a manpage for this? > > cairomm is onwed by Ghee, I think he will provide the manpage. > Brian >
