scsh-users
[Top] [All Lists]

## Scsh HTML manual index anchors

 To: scsh-news@zurich.ai.mit.edu Scsh HTML manual index anchors stktrc Sun, 20 Apr 2003 19:30:42 +0200 News UmU SE
 The index entries link to anchors inside the manual to enable comfortable navigation from the index. But the anchors are placed *after* the items they are anchoring, so (at least) in Mozilla the item ends up (non-visible) just above the viewport. For example, navigating to http://www.scsh.net/docu/html/man-Z-H-4.html#node_idx_354 for the definition of the glob producedure ends up with the first line "(glob pat1 ...) ---> string list (procedure)" non-visible with a paragraph of flowing text as the first visible element in the window. This is confusing until you realize what has happened. This is so because the HTML (generated by tex2page) has the anchor element placed after the procedure declaration line. Looking at the TeX source, the index entry is generated by the \index command on line 211 of doc/scsh-manual/decls.tex: \newcommand{\dfnix}[5] {\hbox to \linewidth{\ttchars% {\ttt(#1\testvoid{#2}{}{\ }{\sem{#2}}\testvoid{#2}{}{\/})\hskip 1em minus 0.5em$\longrightarrow$\hskip 1em minus 0.5em{\sem{#3}}\hfill\quad\textnormal{#4}}}\index{#5}} Maybe a solution would be to move the \index command to the beginning of the line? I'm not entirely sure what's being done in that TeX snippet, someone else might know better. If not, I might get tex2page installated and experiment a little myself. 
 Current Thread Scsh HTML manual index anchors, stktrc <= Re: Scsh HTML manual index anchors, stktrc Re: Scsh HTML manual index anchors, stktrc Re: Scsh HTML manual index anchors, Martin Gasbichler