> If I take that entry manual and then toggle read only and then "M-x keep-lines -- function" I end up with:
>
> -- Function: assoc key alist &optional testfn
> -- Function: rassoc value alist
> -- Function: assq key alist
> -- Function: alist-get key alist &optional default remove testfn
> -- Function: rassq value alist
> -- Function: assoc-default key alist &optional test default
> -- Function: copy-alist alist
> -- Function: assq-delete-all key alist
> -- Function: assoc-delete-all key alist
> -- Function: rassq-delete-all value alist
>
> That's what I would like to get out of the manual easily.
If I may, it sounds like you have described a process which a (small) GNU Elpa
package could replicate easily. I for one would install it. In the Common Lisp
hyperspec pages with this kind of information are found in "the string
dictionary",
"the sequences dictionary". I think demanding namespacing for discoverability
is mixing up two not entirely orthogonal but also not entirely dependent things.
Interesting point. I think that could work, but wouldn't it be much easier if the language itself was self-documenting?
Sure we can create indexes and manuals and all that, but I find it much more logical for the language to simply self-index and self-document itself by naming things "logically" in the language itself.
But yeah, you're right. Eventually either all of those who think like me will create even more `s.el`, `f.el` and friends, or they'll write manual helpers, or they'll simply give up.
Philippe