[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Regarding the new Table of Contents in the GUB docs

From: Trevor Daniels
Subject: Re: Regarding the new Table of Contents in the GUB docs
Date: Mon, 29 Sep 2008 23:02:07 +0100

Yes, I missed the full ToC too. Although if you had
looked up "distances" in the index it would have
directed you to "5.4.3 Distances and measurements".
But this is a fortuitous example. In spite of the excellent work by Ralph to add @cindexes everywhere
the section headings are not in general indexed.
Maybe they should be.  I wonder if they could be
added automatically?  If not, should we go through
and add them manually?


----- Original Message ----- From: "Mats Bengtsson" <address@hidden>
To: "Mailinglist lilypond-user" <address@hidden>
Sent: Monday, September 29, 2008 10:10 PM
Subject: Regarding the new Table of Contents in the GUB docs


I haven't had the time to read all the discussions related to the new
web layout of the 2.11 documentation, but wonder if I'm the only one who miss the possibility to view the full table of contents with all subsections expanded. I'm very used to search for some word in the table of contents, when I want to find the appropriate section in the manual, but this is no longer possible if I want to find the title
of a level 3 section. For example, an email the other day mentioned
the subsection "Distances and measurements" and I actually had to run grep in the Documentation source code to find out that it was located in section 5.4.3. Similarly, I myself referred to the "Piano centered dynamics" template in a recent email and you cannot locate it easily if you search for "centered" in the table of contents.
Even if everybody made it a habit to always include the section number
when referring to a section on the mailing list, you can be certain that
these section numbers will change more often than the titles themselves
so if somebody looks into the mailing list archives 3 years later I'm sure that the section numbers will have changed so it will be hard to find the section.

I certainly realize that it might take too much space to have this
fully expanded table of contents in the left margin all the time, but it should at least be possible to select to view the full version
in the main window.


lilypond-user mailing list

reply via email to

[Prev in Thread] Current Thread [Next in Thread]