emacs-pretest-bug
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: doc for try-completion etc. conflicts with doc for completing-read


From: Eli Zaretskii
Subject: Re: doc for try-completion etc. conflicts with doc for completing-read
Date: Sat, 27 Jan 2007 20:28:48 +0200

> From: "Drew Adams" <address@hidden>
> Cc: <address@hidden>
> Date: Sat, 27 Jan 2007 10:16:04 -0800
> >
> > I didn't want to rename the argument so close to the release, so I
> > added a few more words to the doc string of completing-read, and
> > mentioned the fact that TABLE is called ALIST in try-completion and
> > all-completions.
> 
> Thanks. `test-completion' is in the same boat, BTW.

Not AFAICS: it calls that argument ALIST, not TABLE.

> IOW, if the fix is made where we send people elsewhere for the explanation,
> then it needs to be made everywhere we might do that. If the fix (renaming)
> is made at the target, not the source, then there is no such problem.

I generally don't like sending people to read doc strings of other
symbols at all, so if it were up to me, I'd just spill everything
about TABLE and PREDICATE into each function that calls the low-level
primitives.  But the explanations are very long, so I will let Richard
decide.




reply via email to

[Prev in Thread] Current Thread [Next in Thread]