New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[std] Improve index by adding cross-references to defined terms #1939
Comments
This would be fantastic for cxxdraft-htmlgen! For turning uses of defined terms into links, I currently use my own big but incomplete patch that basically does the third step you mention. The suggested change would severely reduce the need for this patching. |
Editorial meeting consensus: Yes, we want to do this. Optional: Have use of terms show they are defined terms somehow. \defn/x should write to a separate, non-displayed hidden index so that the section lookup can be made automatic. Investigate details to retrieve the section number from that hidden index. Use \term (once freed) for use of a defined term. |
@godbyk, I believe I need some LaTeX help here. Essentially, I want a macro |
@jensmaurer Happy to help! Initially, it sounds like By convention, we usually don't use spaces with labels. It can cause some problems in some obscure circumstances, but in the normal cases, should be just fine. The labels are case-sensitive. If you want Can you give me an example of the input and desired output? I'd be happy to put the code together for you. |
@godbyk: Thanks, that helps. |
Consider "odr-use": We're pretty good at sticking a cross-reference to [basic.def.odr] after each mention of the term, but the index still only lists page 27, where the term is defined.
Suggestion:
\usedefn{term}{xref}
and\usedefnx{term}{index-term}{xref}
. They would render asterm\iref{xref}
and also put add an index entry forterm
orindex-term
, respectively.odr-use\iref{basic.def.odr}
with\usedefn{odr-use}{basic.def.odr}
etc.Opinions?
The text was updated successfully, but these errors were encountered: