Hi Soyt,
It looks to me like the manpages are generated automatically from the DocBook
(sgml) files in the various doc/docbook directories. Why don't you go in there
and add and change what you can in the libggi and libgii docbook directories. I
don't know what distro you're using but I'm guessing you can get docbook
packages for yours. Personally I'm not a big fan of docbook, too much markup,
too hard to install, but it's what we got. When you think things are better, If
you sent a patch to the mailing list right away , we could all get 'n sync.
You're elected.
Here are my suggestions.
> *** libgg ***
>
> - libgg functions are not documented. (I suppose they are all 'private' though
Ignore libgg.
> *** libgii ***
> - giiGetConfDir,giiMTInit, giiQueryDeviceInfo,giiQueryDeviceInfoByNumber and
> giiQueryValInfo are not documented.
Skeletal additions. I'm not sure what these do. Will somebody who does
please stand up?
>
> - giiPanic prototype is:
> void giiPanic(char *format, ...)
> but documented as:
> int giiPanic(const char *format, ...);
>
> - first argument of giiEventSelect is 'gii_input_t' in source and 'gii_input
> *' in manpage (gii-unix.h)
>
> *** libggi ***
>
> - ggiEventSelect, giiGetConfDir, ggiExtension*, ggiGetAPI, ggiIndicateChange,
> are not documented
If it's not in ggi.h, I say ignore it for now.
> - ggiPanic : same as gii.
>
> - ggiCrossBlit : args should be 'ggi_visual_t' instead of 'ggi_visual *' in man
>
> - ggiSetTextMode: the 'ggi_graphtype type' argument is not mentioned in manpage.
>
> - ggiCheckTextMode:
> int ggiCheckTextMode(ggi_visual_t visual,int cols,int rows,
> int vcols,int vrows, int fontx,int fonty,
> ggi_graphtype type, ggi_mode *suggested_mode);
>
> but stated in manpage as:
> int ggiCheckTextMode(ggi_visual_t visual, int cols, int
> rows, int vcols, int vrows, int fontx, int fonty,
> ggi_mode *suggested_mode, ...);
>
> - ggiCheckGraphMode: doesn't expect additionnal args, but ends with ... in
> manpage.
These should be quick fixes.
Good.
--
Lee Brown Jr.
[EMAIL PROTECTED]
