Re: Gtk patch version 3, part 1

[Richard Stallman]

+ @cindex GTK customize, @file{~/.gtkrc-2.0} file

This is too long for an index entry.  Also, they
don't belong in the same entry.  They should be two entries.

  See documents at
+ @uref{http://www.gtk.org/} for that.

It is not good to refer to a web site for documentation purposes.
Please refer to something that can be included in the user's machine.

    +   Note that this is only for customizing specific GTK widget features.
    + To customize Emacs font, background, faces e.t.c., use the normal
    + X Resources, see @ref{Resources}.

To make this useful, it is important to be at least a little more
specific about which aspects to customize through GTK and which
through X resources.  If you can do this clearly with a description,
that is fine; otherwise you could use a list.

The word "resources" is an ordinary noun, so don't capitailze it.
It should be "etc.", not "e.t.c."

+   For dialogs a GtkDialog is used.

Please avoid the passive voice, here and everywhere, unless
it is absolutely necessary.

    + @example
    + widget_class "GtkWindow.GtkVBox.GtkFixed.GtkVScrollbar" style "my_style"
    + @end example

That line is very long.  It might work ok if you use @smallexample
instead of @example.  Please do that for all the examples in the
section; inconsistency looks bad.

Can this be written as two lines?

+   So the two full paths above are in Emacs the same as:

That's not very clear language.  How about

    Thus, for Emacs you can write the two examples above as:

if that is what you mean.