Re: dabbrev-completion doc string

[Luc Teirlinck]

Drew Adams wrote:

   The last sentence of the doc string should be removed, IMO:

     "With no prefix argument, it reuses an old completion list
      if there is a suitable one already."

It would seem very odd to explain in detail what happens if you use
various prefix arguments and not say anything whatsoever about what is
going to happen if you use no prefix argument.

     "With no prefix argument, it reuses an old completion list
      if there is a suitable one already."

   This is a user command, and (IIUC) the last sentence means nothing to users
   (it just documents the implementation).

   If I misunderstand the importance of the last sentence, then please consider
   rephrasing it in user terms.

Unless I am the one misunderstanding the last sentence, the sentence
you quoted and want to delete seems completely self-explanatory.  How
can it be phrased more clearly?  Without a prefix argument, if there
is already a completion list, `dabbrev-completion' just uses it
without trying to update it (meaning it may not be up to date).

Sincerely,

Luc.