I did a quick check by adding id tags to all 700-or-so <indexterm>s in func.sgml (don't get excited, it was a perl one-liner that just added random id strings).
I did, actually, get excited for a second.
The runtime difference for building the HTML docs seems to be under 1%, and negligible for PDF output. So it looks like we don't have to worry about scalability of tagging all the functions.
Ok, so that's the function anchors.
So some references to functions are just the name, and xrefs will work fine for those.
I was thinking that there were references that included parameters, but I'm not finding any with actual parameter values, so at most we'd lose the "()" of a reference.
Assuming we want to make the anchors visible, we need a way for people to discover the anchors we've made, and my thought there is that we make the first definition a non-xref link to the indexterm just above it. Any thoughts on what the best way to do that is?
