GNU bug report logs - #12695
24.2.50; Describe file-name cache at (emacs) `File Conveniences'

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 12695 in the body.
You can then email your comments to 12695 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <bug-gnu-emacs <at> gnu.org>
Subject: 24.2.50; Describe file-name cache at (emacs) `File Conveniences'
Date: Sat, 20 Oct 2012 16:12:29 -0700

This is a node about "convenient facilities for finding" files.  It
should mention the file-name cache and cross-reference node `File Name
Cache'.  That feature too provides a way to quickly find files that
might be far from the current directory.

In GNU Emacs 24.2.50.1 (i386-mingw-nt5.1.2600)
 of 2012-10-15 on DANI-PC
Bzr revision: 110553 monnier <at> iro.umontreal.ca-20121015164957-6zms5w2js1xkldtg
Windowing system distributor `Microsoft Corp.', version 5.1.2600
Configured using:
 `configure --with-gcc (4.7) --no-opt --enable-checking --cflags
 -I../../libs/libxpm-3.5.8/include -I../../libs/libxpm-3.5.8/src
 -I../../libs/libpng-1.4.10 -I../../libs/zlib-1.2.6
 -I../../libs/giflib-4.1.4-1/include -I../../libs/jpeg-6b-4/include
 -I../../libs/tiff-3.8.2-1/include
 -I../../libs/libxml2-2.7.8-w32-bin/include/libxml2
 -I../../libs/gnutls-3.0.16/include
 -I../../libs/libiconv-1.14-2-mingw32-dev/include'
 

Message #8 received at 12695 <at> debbugs.gnu.org (full text, mbox):

From: Chong Yidong <cyd <at> gnu.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 12695 <at> debbugs.gnu.org
Subject: Re: bug#12695: 24.2.50;
	Describe file-name cache at (emacs) `File Conveniences'
Date: Sat, 17 Nov 2012 14:30:06 +0800

"Drew Adams" <drew.adams <at> oracle.com> writes:

> This is a node about "convenient facilities for finding" files.  It
> should mention the file-name cache and cross-reference node `File Name
> Cache'.  That feature too provides a way to quickly find files that
> might be far from the current directory.

File Name Cache is the immediately preceding node, so this is redundant.

Message #15 received at 12695 <at> debbugs.gnu.org (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: "'Chong Yidong'" <cyd <at> gnu.org>
Cc: 12695 <at> debbugs.gnu.org
Subject: RE: bug#12695: 24.2.50;
	Describe file-name cache at (emacs) `File Conveniences'
Date: Fri, 16 Nov 2012 22:45:52 -0800

> > This is a node about "convenient facilities for finding" files.  It
> > should mention the file-name cache and cross-reference node 
> > `File Name Cache'.  That feature too provides a way to quickly
> > find files that might be far from the current directory.
> 
> File Name Cache is the immediately preceding node, so this is 
> redundant.

Not at all redundant.  There is nothing in that node that refers you to the
other or even mentions file-name caching.

People do not necessarily read the manual from start to finish in a linear
fashion.  They can land in a given node in any number of ways, including via the
index or a cross reference.

It makes no sense to say that because some information is in a sibling node
there is no reason to cross reference it.  Whether to cross reference it should
depend only on whether its content is relevant/related.  Which it is, in this
case.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.