From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: Gtk patch version 3, part 1 Date: Wed, 01 Jan 2003 11:46:23 -0500 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <200212310414.gBV4Et0U014643@stubby.bodenonline.com> Reply-To: rms@gnu.org NNTP-Posting-Host: main.gmane.org X-Trace: main.gmane.org 1041454736 5554 80.91.224.249 (1 Jan 2003 20:58:56 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Wed, 1 Jan 2003 20:58:56 +0000 (UTC) Cc: emacs-devel@gnu.org Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 18Tpx0-0001RI-00 for ; Wed, 01 Jan 2003 21:58:54 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 18Tpyo-0002Oe-00 for ; Wed, 01 Jan 2003 22:00:46 +0100 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 18Tpww-0000a4-00 for emacs-devel@quimby.gnus.org; Wed, 01 Jan 2003 15:58:50 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 18Tm0m-0005KO-00 for emacs-devel@gnu.org; Wed, 01 Jan 2003 11:46:32 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 18Tm0f-000591-00 for emacs-devel@gnu.org; Wed, 01 Jan 2003 11:46:28 -0500 Original-Received: from fencepost.gnu.org ([199.232.76.164]) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 18Tm0e-00058D-00 for emacs-devel@gnu.org; Wed, 01 Jan 2003 11:46:24 -0500 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.10) id 18Tm0d-0002ri-00; Wed, 01 Jan 2003 11:46:23 -0500 Original-To: jan.h.d@swipnet.se In-reply-to: <200212310414.gBV4Et0U014643@stubby.bodenonline.com> (jan.h.d@swipnet.se) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1b5 Precedence: list List-Id: Emacs development discussions. List-Help: List-Post: List-Subscribe: , List-Archive: List-Unsubscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:10393 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:10393 + @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.