From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Robert J. Chassell" Newsgroups: gmane.emacs.devel Subject: Re: tumme testing Date: Sat, 11 Feb 2006 12:57:59 +0000 (UTC) Message-ID: References: <17366.53124.274532.548329@kahikatea.snap.net.nz> <87d5hy43b6.fsf@jurta.org> <87u0b8lwhw.fsf@jurta.org> <87bqxgynfn.fsf@jurta.org> Reply-To: bob@rattlesnake.com NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1139693968 14318 80.91.229.2 (11 Feb 2006 21:39:28 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 11 Feb 2006 21:39:28 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Feb 11 22:39:22 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1F82SY-0008Ds-Fg for ged-emacs-devel@m.gmane.org; Sat, 11 Feb 2006 22:39:14 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1F82DA-0006gA-KV for ged-emacs-devel@m.gmane.org; Sat, 11 Feb 2006 16:23:20 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1F81fS-0003uB-IY for emacs-devel@gnu.org; Sat, 11 Feb 2006 15:48:31 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1F81Cd-0001lx-8z for emacs-devel@gnu.org; Sat, 11 Feb 2006 15:18:44 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1F80KG-0007yZ-33 for emacs-devel@gnu.org; Sat, 11 Feb 2006 14:22:32 -0500 Original-Received: from [69.168.108.225] (helo=rattlesnake.com) by monty-python.gnu.org with esmtp (Exim 4.52) id 1F7uOC-0004vy-MV for emacs-devel@gnu.org; Sat, 11 Feb 2006 08:02:12 -0500 Original-Received: by rattlesnake.com via sendmail from stdin id (Debian Smail3.2.0.115) Sat, 11 Feb 2006 12:57:59 +0000 (UTC) Original-To: Mattis In-reply-to: (message from Mattis on Sat, 11 Feb 2006 01:17:18 +0100) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:50367 Archived-At: > I didn't even know about a database file. That should be mentioned in > the functions document string so describe-function displays it. (I > had not read the documentation in the Emacs manual.) Would all "tag commands" need that info? Although there are quite few of them now, more could be added, and I hate redundant documentation. Please remember, not every one will have read the manual. Or if they have, they may not remember it. Perhaps they last read the relevant node 20 years ago. If you do as well as others, and you should, people for whom Chinese is a second language will read a translation of your words in 2026. The doc string and the Texinfo documentation are not redundant; the purposes of each are different. As an example, please look at the dired documentation: `describe-function' provides a long description, not only saying on one line "Edit" directory DIRNAME--delete, rename, print, etc. some files in it. but also listing some of its commands on additional lines. Think of the purpose of this documentation. Then compare it to the documentation in Texinfo. Like the `describe-function' documentation, the (emacs)Dired node also says that dired is a directory editor. However, it explains what that means in different words than `describe-function'. It takes a paragraph. In addition, that Info node contains 15 other nodes that describe matters such as navigation and deletion. And that number does not count the two nodes `wdired' and `tumme'. Each tag command requires documentation that `describe-function' displays and, in different and when necessary more words, the Texinfo file requires documentation, too. > To tag > image files, mark them in the dired buffer and type `C-t t' > (`tumme-tag-files'). To mark files having a certain tag, type `C-t f' > (`tumme-mark-tagged-files'). Sorry, I really tried to understand what you mean above, but it seems I am the sleepy one right now. Could you maybe suggest a change of the manual (which, btw, is not done yet). You simply want to say something like the following (in one filled paragraph; but at the moment, there is no command to view the image files as small thumbnails in dired, I am leaving the commands as ellipses and the paragraph unfilled): The viewing commands are the same as before. To view those image files as small thumbnails in dired, type ... To view those image files as thumbnails in a different buffer, type ... -- Robert J. Chassell bob@rattlesnake.com GnuPG Key ID: 004B4AC8 http://www.rattlesnake.com http://www.teak.cc