[Top][All Lists]
[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: |
Drew Adams |
Subject: |
RE: doc for try-completion etc. conflicts with doc for completing-read |
Date: |
Sat, 27 Jan 2007 12:25:49 -0800 |
> > Thanks. `test-completion' is in the same boat, BTW.
>
> Not AFAICS: it calls that argument ALIST, not TABLE.
That's what I meant. It is in the same category as `try-completion' and
`all-completions' - they all call it "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.
I know that you're trying to make a quick and unrisky fix for this release.
That is fine. I was only mentioning the rest for the future.
Thanks for the fix.