From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Miles Bader Newsgroups: gmane.emacs.devel Subject: Re: GTK documentation in Emacs Date: Fri, 10 Jan 2003 20:27:37 -0500 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <20030111012737.GA4543@gnu.org> References: <200301101817.h0AIHBDU019211@stubby.bodenonline.com> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: main.gmane.org 1042248524 26984 80.91.224.249 (11 Jan 2003 01:28:44 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Sat, 11 Jan 2003 01:28:44 +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 18XAS3-000715-00 for ; Sat, 11 Jan 2003 02:28:43 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 18XAYK-00062L-00 for ; Sat, 11 Jan 2003 02:35:12 +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 18XAS1-00017h-05 for emacs-devel@quimby.gnus.org; Fri, 10 Jan 2003 20:28:41 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 18XARj-0000zX-00 for emacs-devel@gnu.org; Fri, 10 Jan 2003 20:28:23 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 18XARI-00080v-00 for emacs-devel@gnu.org; Fri, 10 Jan 2003 20:28:00 -0500 Original-Received: from fencepost.gnu.org ([199.232.76.164]) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 18XAR0-000773-00 for emacs-devel@gnu.org; Fri, 10 Jan 2003 20:27:38 -0500 Original-Received: from miles by fencepost.gnu.org with local (Exim 4.10) id 18XAQz-0001Jl-00; Fri, 10 Jan 2003 20:27:37 -0500 Original-To: "Jan D." Content-Disposition: inline In-Reply-To: <200301101817.h0AIHBDU019211@stubby.bodenonline.com> User-Agent: Mutt/1.3.28i Blat: Foop 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:10645 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:10645 On Fri, Jan 10, 2003 at 06:20:49PM +0100, Jan D. wrote: > > Here's a patch that makes some minor clarifications, corrections, and > > formatting changes to what you did: > > Thanks, I applied it, except for the @itemize parts. I think it is > easier to find what to write in lists like this than in running text. The problem is that in info they look really ugly (mostly because it inserts a newline between each entry in the list, so it ends up looking really tall, skinny, and `sparse' [and taking up lots of screen real-estate]). Since these particular lists are `intuitive' -- that is they consist of many related words arranged in an obvious order -- I think there's less need for distinguishing each individual entry than if they were lists of unrelated items. Despite the above reasoning, I wasn't quite sure either which was the best way, so I looked at other places in the emacs manual that use similar lists -- in particular the description of faces (which in fact have almost exactly the same lists, like bold, ultra-bold, etc.) -- and they use in-text lists. So that's why I made that change: when in doubt, be consistent... :o) -Miles -- Quidquid latine dictum sit, altum viditur.