From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: "Eli Zaretskii" Newsgroups: gmane.emacs.devel Subject: Re: GTK documentation in Emacs Date: Fri, 10 Jan 2003 22:27:43 +0300 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <6480-Fri10Jan2003222743+0200-eliz@is.elta.co.il> References: <200301091754.h09HsDDU023888@stubby.bodenonline.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: main.gmane.org X-Trace: main.gmane.org 1042230715 26455 80.91.224.249 (10 Jan 2003 20:31:55 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Fri, 10 Jan 2003 20:31:55 +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 18X5o1-0006pt-00 for ; Fri, 10 Jan 2003 21:31:05 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 18X5uC-00036a-00 for ; Fri, 10 Jan 2003 21:37:28 +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 18X5or-0004vh-01 for emacs-devel@quimby.gnus.org; Fri, 10 Jan 2003 15:31:57 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 18X5oS-0004rP-00 for emacs-devel@gnu.org; Fri, 10 Jan 2003 15:31:32 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 18X5oE-0004dR-00 for emacs-devel@gnu.org; Fri, 10 Jan 2003 15:31:19 -0500 Original-Received: from gandalf.inter.net.il ([192.114.186.22]) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 18X5no-00044d-00 for emacs-devel@gnu.org; Fri, 10 Jan 2003 15:30:52 -0500 Original-Received: from zaretsky ([80.230.85.156]) by gandalf.inter.net.il (Mirapoint Messaging Server MOS 3.2.1-GA) with ESMTP id ACK64685; Fri, 10 Jan 2003 22:30:41 +0200 (IST) Original-To: jan.h.d@swipnet.se X-Mailer: emacs 21.3.50 (via feedmail 8 I) and Blat ver 1.8.9 In-reply-to: <200301091754.h09HsDDU023888@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:10632 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:10632 > From: "Jan D." > Date: Thu, 9 Jan 2003 17:58:06 +0100 (CET) > > 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 > + @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.