Re: doc string of insert-default-directory is unclear

[Eli Zaretskii <eliz@gnu.org>]

> From: "Drew Adams" <drew.adams@oracle.com>
> Cc: <bug-gnu-emacs@gnu.org>
> Date: Sat, 9 Feb 2008 07:59:15 -0800
> 
> > > In previous releases, the doc string said only what its first line
> > > says. The rest was presumably added in Emacs 22 to clarify 
> > > the meaning and use.
> > 
> > Not just clarify, to document its different semantics.
> 
> That semantic difference is not clear to me from the new doc string you
> propose. Sorry. Could you point out the difference?

I did not mean my changes, I meant the addition of the text that you
complained about: it was added when the effects of the value of this
variable were changed a few years ago.

> "Typing RETURN without editing will leave the minibuffer empty." No, it will
> exit the minibuffer

Well, that's ambiguity of the work "leave": it also means "exit",
which was my intent.

> I hate to say it, but I think that, in general, the added text just adds
> confusion.

If you mean my changes, then I didn't add anything.  I just rearranged
the text a bit and made some minor wording changes.

> What is the problem that adding this text is intended to solve? If you tell
> me what the problem we are solving is, perhaps I can help some more with the
> wording.

I didn't have enough time for researching all the users of this
variable's value, unfortunately.  So I simply don't know.  Perhaps Luc
Teirlinck (cc'ed), who is the author of the doc string, could help.