[Python-Dev] Symbol page for Language Reference Manual Index

[Terry Reedy]

"A.M. Kuchling" <amk at amk.ca> wrote in message 
news:20060608122437.GA27249 at rogue.amk.ca...
> On Thu, Jun 08, 2006 at 12:18:23AM -0400, Terry Reedy wrote:
>> [I just realized that some links need to be within-page rather than to 
>> the
>> top of the page and that I can cut and paste additional info if I find 
>> the
>> appropriate regular index entry, such as
>> http://docs.python.org/ref/parenthesized.html#l2h-342 for 5.2.3.  But I
>> will work this sort of thing out with whoever formats.]
>
> It's probably easiest to make a list of symbols and the corresponding
> section names and optionally a snippet of the paragraph that should be
> the target of the link. Section numbers like 5.2.3 and link anchors
> like #l2h-342 are generated by LaTeX2HTML and not visible when you're
> editing the source text.

I looked at the ref latex source and realized that the indexes have no 
source themselves but are autogenerated from index markup like in the 
following:

\section{Function definitions\label{function}}
\indexii{function}{definition}
\stindex{def}

A function definition defines a user-defined function object (see
section~\ref{types}):
\obindex{user-defined function}
\obindex{function}

Section numbers will allow the lines to be sorted in section insertion 
point so the formatter does not have to jump around within and between the 
multiple latex source files.  So I need to put all the info for each entry 
on one line.  I'll let the formatter worry about which index tag to use or 
whether a new \syindex tag should be added, and how to make \index{{}} 
work.

Terry Jan Reedy