Re: [TeX-music] Index added to musixdoc

2006-04-19 Thread Dirk Laurie
Don Simons skryf:
> Then perhaps either Dirk or Olivier would like to volunteer to edit the
> index for the upcoming (but not necessarily soon), completely revised
> version of musixdoc.
It is precisely because I do NOT have the intimate acquaintance
with the contents of musixdoc required for that task, that I have 
the warmest appreciation for what Daniel Taupin produced, and tried 
imitating his index (to the extent of borrowing his macros) in mtxdoc.  

One does not edit a TeX index.  The author of the document inserts a
command in the text wherever a word to be indexed appears.  Then
"makeindex" takes care of producing the index.

E.g. "PMX was written by \ixem{Don Simons}" will print "PMX was written
by Don Simons" and produce an index entry for "Don Simons", whereas
"PMX was written by Don Simons \index{Simons!Don}" will produce one for
"Don" as a subentry under "Simons".

I dare not volunteer to add index macros to all of the new documentation. 
But I do volunteer to give technical advice on Daniel's indexing macros 
(including how to modify them for use with hyperref.sty) to whoever needs 
it.

Dirk
___
TeX-music mailing list
TeX-music@icking-music-archive.org
http://icking-music-archive.org/mailman/listinfo/tex-music


RE: [TeX-music] Index added to musixdoc

2006-04-19 Thread Don Simons
Then perhaps either Dirk or Olivier would like to volunteer to edit the
index for the upcoming (but not necessarily soon), completely revised
version of musixdoc.

--Don Simons

> -Original Message-
> From: [EMAIL PROTECTED]
> [mailto:[EMAIL PROTECTED] Behalf Of Olivier
> Vogel
> Sent: Wednesday, April 19, 2006 1:30 AM
> To: Typesetting music with TeX
> Subject: Re: [TeX-music] Index added to musixdoc
>
>
> Thank you Don for the correction of musixdoc.pdf.
>
> About the utility of an index, I totally agree with Dirk.
>
> Olivier
>
> ___
> TeX-music mailing list
> TeX-music@icking-music-archive.org
> http://icking-music-archive.org/mailman/listinfo/tex-music
>


___
TeX-music mailing list
TeX-music@icking-music-archive.org
http://icking-music-archive.org/mailman/listinfo/tex-music


Re: [TeX-music] Index added to musixdoc

2006-04-19 Thread Olivier Vogel
Thank you Don for the correction of musixdoc.pdf.

About the utility of an index, I totally agree with Dirk.

Olivier

___
TeX-music mailing list
TeX-music@icking-music-archive.org
http://icking-music-archive.org/mailman/listinfo/tex-music


Re: [TeX-music] Index added to musixdoc

2006-04-19 Thread Dirk Laurie
Don Simons skryf:
> 
> This might be a good time to mention something about indices that I've often
> thought about. If you are viewing a document electronically rather than in
> hard copy, there's hardly any use for an index. Just text search for the
> entry you want. And if it's a tex document, then whether or not every
> occurrance gets into the index depends on the vigilance of the editor. A
> text search will not skip over any occurrances, and could very well be more
> accurate.
> 
A well-made index is a great help, even for electronic viewing.  By well-made 
I mean that it incorporates expertise on where to find the nitty-gritty. 

Say I want to know something about \zqu. 
 
A text search gives me a dozen hits.  Daniel's index gives me one: the 
one I need.  

And if you \usepackage{hyperref}, then you can just click the page
number in the index when viewing the PDF file and that puts you straight
on that page.

A poorly-made index is no use at all, I agree.

Dirk
___
TeX-music mailing list
TeX-music@icking-music-archive.org
http://icking-music-archive.org/mailman/listinfo/tex-music


[TeX-music] Index added to musixdoc

2006-04-18 Thread Don Simons
Olivier Vogel just pointed out that there was no index in musixdoc.pdf. So
I've remade it with an index, and replaced the copies inside musixtex.zip
and also the one directly accessible from the software page.

This might be a good time to mention something about indices that I've often
thought about. If you are viewing a document electronically rather than in
hard copy, there's hardly any use for an index. Just text search for the
entry you want. And if it's a tex document, then whether or not every
occurrance gets into the index depends on the vigilance of the editor. A
text search will not skip over any occurrances, and could very well be more
accurate.

--Don Simons


___
TeX-music mailing list
TeX-music@icking-music-archive.org
http://icking-music-archive.org/mailman/listinfo/tex-music