GNU bug report logs - #4654
23.1; Elisp manual doc of abbreviate-file-name

Previous Next

Full log

Message #63 received at 4654-done <at> emacsbugs.donarmstrong.com (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: "'Stefan Monnier'" <monnier <at> iro.umontreal.ca>
Cc: "'Eli Zaretskii'" <eliz <at> gnu.org>, <4654-done <at> debbugs.gnu.org>
Subject: RE: bug#4654: 23.1; Elisp manual doc of abbreviate-file-name
Date: Wed, 7 Oct 2009 20:32:24 -0700

> > Consider also making clearer the direction of substitution 
> > (e.g a one-line example). As Stefan's own misstatement shows,
> > it's easy for readers to understand the substitution backwards.
> 
> Given the name of the function, the direction of the substitution
> is unequivocal.

The question is not whether it is equivocal. I said from the beginning that it
is correct. The question is whether it is clear enough. This is a classic gotcha
for some readers.

Previous Next

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