Subject: Re: bug#4654: 23.1; Elisp manual doc of abbreviate-file-name

From: Eli Zaretskii <[email-masked]>
Date: Wed, 07 Oct 2009 19:44:30 +0200

> From: "Drew Adams" <[email-masked]>
> Cc: <[email-masked]>
> Date: Wed, 7 Oct 2009 08:19:06 -0700
> 
> > I fixed the manual.  The description now says
> > 
> > (If the home directory is a root directory, it is not
> > replaced with @samp{~}, because this does not make the result
> > shorter on many systems.)
> > 
> > I hope this is something everybody can live with.
> 
> Thank you.
> 
> 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.

That is why the text quoted above makes a point of saying "replaced
with", which should be unequivocal.