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: Thu, 02 Jan 2003 22:30:59 -0500 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <200301011944.h01Jim0U011400@stubby.bodenonline.com> Reply-To: rms@gnu.org NNTP-Posting-Host: main.gmane.org X-Trace: main.gmane.org 1041564694 11904 80.91.224.249 (3 Jan 2003 03:31:34 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Fri, 3 Jan 2003 03:31:34 +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 18UIYU-00035c-00 for ; Fri, 03 Jan 2003 04:31:30 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 18UIav-0003KJ-00 for ; Fri, 03 Jan 2003 04:34:01 +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 18UIYI-0001b7-02 for emacs-devel@quimby.gnus.org; Thu, 02 Jan 2003 22:31:18 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 18UIY1-0001aw-00 for emacs-devel@gnu.org; Thu, 02 Jan 2003 22:31:01 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 18UIXz-0001ah-00 for emacs-devel@gnu.org; Thu, 02 Jan 2003 22:31:00 -0500 Original-Received: from fencepost.gnu.org ([199.232.76.164]) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 18UIXz-0001ab-00 for emacs-devel@gnu.org; Thu, 02 Jan 2003 22:30:59 -0500 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.10) id 18UIXz-00060i-00; Thu, 02 Jan 2003 22:30:59 -0500 Original-To: jan.h.d@swipnet.se In-reply-to: <200301011944.h01Jim0U011400@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:10424 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:10424 > 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. Do you mean "that the user can include into his machine" or "something that might be on the users machine already"? I mean something that ought to be on the user's machine (though any given user may or may not have installed it, of course). If the second, can I refer to /usr/share/gtk-doc, where the GTK documentation is usually installed? Yes, but isn't there an Info file for GTK? > + 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. It is given by the GTK documentation, is it OK to just refer to that? A brief explicit concrete list would be much better than a cross-reference. When something is directly relevant for the user's understanding, using a cross reference is considerably less convenient for the user. > + For dialogs a GtkDialog is used. > > Please avoid the passive voice, here and everywhere, unless > it is absolutely necessary. How about Dialogs in Emacs are GtkDialog widgets. Exactly!