Re: GTK documentation in Emacs

[Jan D.]

> > I will shortly check in the GTK changes in to CVS,  I really would like
> > some feedback on the documentation I've written
>
> Thanks!  A couple of technical points:
>
> > + @node GTK resources, GTK widget paths, LessTif Resources, X Resources
> > + @appendixsec GTK resources
> > + @cindex GTK resources
> > + @cindex GTK customize
> > + @cindex GTK resource files
>
> It is not useful to have multiple index entries pointing to the same
> place and beginning with the same string.  So I suggest to replace the
> 3 index entries above with this:
>
>   @cindex GTK resources and customization
>   @cindex resource files for GTK

Good point, I will change this.


> > + @node GTK widget paths, GTK names in Emacs, GTK resources, GTK resources
>
> In general, please use just "@node Foo", without the prev/next/up
> links, as in "@node GTK widget paths".  This makes it easier to move
> nodes around.

Hmm, I had that at first and then makeinfo complained.  I probably
did something wrong, I'll look in to this.

        Jan D.