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

[Drew Adams]

> > > > 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.

I understood that. I should have said that the semantic difference is not
clear to me from either the Emacs 22 doc string or your proposed text. What
is the semantic difference from pre-Emacs 22? What behavior has changed?

> > "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.

Right. Exit is less ambiguous.

> > 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.

I meant both the Emacs 22 text and your proposed text. I don't think either
clarifies things.

> > 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.

OK, understood; I appreciate your trying to help. If someone lets me know,
I'll try to suggest an improvement. For the moment, IMO, we were better off
with just the one-liner.