]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/index.texi
* Documentation/index.texi: Add pointers to new regression and
[lilypond.git] / Documentation / index.texi
index 4cb0c30fcbb7fe591edeea422726f3c233005687..5a4a0d16068ea80dbf7992106820f6b5b0640c98 100644 (file)
@@ -2,6 +2,10 @@
 @setfilename index.info
 @settitle Index to LilyPond documentation
 
+@html
+<!--- @@WEB-TITLE@@=Documentation --->
+@end html
+
 @node Top, , , (dir)
 @top
 
 @end itemize
 
 @html
-<a name="new-users">
+<a name="newbies">
 @end html
 
 
+@c Flat lists of links are not so handy
+@c the links themselves (basename of filename) do not make for
+@c intuitive clicking.
+
+
 @unnumberedsubsec Information for new users
 
+@c Hmm, this looks a bit better; maybe for users/developers too?
+
+@quotation
+
+@unnumberedsubsubsec Installation
+
 @itemize @bullet
-@item @uref{../../index.html,index} What is Lilypond?
-@item @uref{../topdocs/out-www/README.html, README} general information
+@item @uref{../topdocs/out-www/README.html, README} General information.
 @item @uref{../topdocs/out-www/INSTALL.html, INSTALL}
   How install on Unix.
 @item @uref{../windows/out-www/installing.html, WINDOWS}
 How to install on Windows.
-@item @uref{http://www.lilypond.org/wiki?LilyPondFaqs,FAQ} Frequently
-asked questions, with answers.
+@end itemize
+
+@c also for users...
+@unnumberedsubsubsec Support
+
+@itemize @bullet
+@item @uref{../../index.html,index} What is Lilypond?
+@item @uref{../topdocs/out-www/FAQ.html,mini-FAQ} Mini FAQ -- very
+frequently asked questions, with answers.
+@item @uref{http://www.lilypond.org/wiki?LilyPondFaqs,FAQs} Frequently
+Asked Questions, with answers.
 @item @uref{http://www.lilypond.org/wiki?MailingLists,MailingLists} Subscribe to
-the mailing lists
-@item @uref{../user/out-www/lilypond/Tutorial.html,Tutorial} Learn how to use LilyPond.
+the mailing lists.
 @end itemize
 
+@unnumberedsubsubsec Documents
 
+@c direct links into first steps and running lily?
+@itemize @bullet
+@item @uref{../user/out-www/lilypond/Tutorial.html,Tutorial} Learn how to use LilyPond.
+@end itemize
+
+@end quotation
 
 @html
-<a name="other-users">
+<a name="users">
 @end html
 
 @unnumberedsubsec Information for users
 
 
 @itemize @bullet
-@item @uref{CHANGES.html, CHANGES} things recently done
+@item @uref{ChangeLog.html, ChangeLog} Things recently done.
 
 @c download sites?
 
 @c archives?
 
-@item @uref{../user/out-www/lilypond-internals/lilypond-internals.html,lilypond-internals}
-Documentation of internals, generated from the sources. If you want to
-fine-tune output, you need the information in this document.
-@item @uref{../user/out-www/lilypond/lilypond.html,lilypond}
-  The user manual, (in @uref{../user/out-www/lilypond.ps.gz,PostScript})
+@c tutorial?
+
+@item
+@uref{../user/out-www/lilypond/Reference-Manual.html,Reference-Manual}
+The reference manual.
+
+@item @uref{../user/out-www/lilypond/lilypond.html,lilypond} The complete
+user manual, (in @uref{../user/out-www/lilypond.ps.gz,PostScript} and
+@uref{../user/out-www/lilypond.pdf,PDF}). This manual contains among
+others the tutorial, the reference manual.  The HTML version is also
+available as @uref{../user/out-www/lilypond.html,one big page}.
+
+@c glossary maybe for new users?
 @item @uref{../user/out-www/glossary.html,glossary} A glossary of musical
 terms, including translations.  (in
-@uref{../user/out-www/glossary.ps.gz,Postscript})
+@uref{../user/out-www/glossary.ps.gz,Postscript}
+and
+@uref{../user/out-www/glossary.pdf,PDF})  Read this if you're not
+familiar with English terms for notation.
+
+@item @uref{../user/out-www/lilypond-internals/lilypond-internals.html,lilypond-internals}
+Full documentation of internals, generated from the sources.  If you
+want to fine-tune output, you need the information in this document.
 @end itemize
 
 
@@ -76,15 +120,31 @@ terms, including translations.  (in
 
 @unnumberedsubsec Information for developers
 
+@c Han-Wen's site?
+@c Jan's site?
 
 @itemize @bullet
-@item @uref{../out-www/regression-test.html,regression-test} A glossary
-of musical terms, including translations.  (in
-@uref{../out-www/regression-test.ps.gz,Postscript})
+@item @uref{../../input/regression/out-www/regression.html,Regression Tests}
+A large document that tests all kinds of features.
+@c (also as
+@c @uref{../out-www/regression-test.ps.gz,Postscript}
+@c and
+@c @uref{../out-www/regression-test.pdf,PDF}).
+@item @uref{../../input/test/out-www/test.html,Feature Tests}
+A large document that tests all kinds of features.
+@item @uref{../../input/bugs/out-www/bugs.html,Bugs}
+A document that shows bugs.
+
+
+@c  (also as
+@c @uref{../../input/bugs/out-www/bugs.ps.gz,Postscript}
+@c and @uref{../../input/bugs/out-www/bugs.pdf,PDF}).
+
 @item
 @uref{http://www2.iro.umontreal.ca/~pinard/po/registry.cgi?domain=lilypond">Translations,lilypond
 textual domain
 }  in the Translation Project.
+@item Compiling for @uref{../windows/out-www/compiling.html,Windows/Cygwin}.
 @end itemize
 
 
@@ -147,34 +207,36 @@ by computer}.
 @unnumberedsec Mailing lists
 
 If you have questions, do write to the mailing lists.  But don't forget
-to read the @uref{Documentation/topdocs/out-www/FAQ.html,Very Frequently
+to read the @uref{../topdocs/out-www/FAQ.html,Very Frequently
 Asked Questions} and @uref{http://appel.dyndns.org/wiki?LilyPondFaqs,
 Frequently Asked Questions} first.
 
 
 @itemize @bullet
-@item @uref{http://mail.gnu.org/mailman/listinfo/gnu-music-discuss,gnu-music-discuss@@gnu.org}
-This list is for discussions concerning LilyPond.
+@item @uref{http://mail.gnu.org/mailman/listinfo/lilypond-devel,lilypond-devel@@gnu.org}
+This list is for discussions concerning the development release of
+LilyPond.
 
 Searchable archives are available from
-@uref{http://www.mail-archive.com/gnu-music-discuss@@gnu.org}.
+@uref{http://www.mail-archive.com/lilypond-devel@@gnu.org}.
 
-@item @uref{http://mail.gnu.org/mailman/listinfo/info-gnu-music,info-gnu-music@@gnu.org}
+@item @uref{http://mail.gnu.org/mailman/listinfo/info-lilypond,info-lilypond@@gnu.org}
 is a low-volume list for information on the GNU Music project.
     This list is moderated; ask 
     @email{drl@@gnu.org, David R. Linn} or
     @email{hanwen@@cs.uu.nl, Han-Wen} to send announcements for this list.
 
 Searchable archives are available from
-@uref{http://www.mail-archive.com/info-gnu-music@@gnu.org}.
+@uref{http://www.mail-archive.com/info-lilypond@@gnu.org}.
 
-@item @uref{http://mail.gnu.org/mailman/listinfo/help-gnu-music,help-gnu-music@@gnu.org}
-    For help with using LilyPond.
+@item @uref{http://mail.gnu.org/mailman/listinfo/lilypond-user,lilypond-user@@gnu.org}
+        For discussing every-day use of LilyPond, in particular the
+stable releases.
 
 Searchable archives are available from
-@uref{http://www.mail-archive.com/help-gnu-music@@gnu.org}.
+@uref{http://www.mail-archive.com/lilypond-user@@gnu.org}.
 
-@item @uref{http://mail.gnu.org/mailman/listinfo/bug-gnu-music,bug-gnu-music@@gnu.org}
+@item @uref{http://mail.gnu.org/mailman/listinfo/bug-lilypond,bug-lilypond@@gnu.org}
 If you have bugreports, you should send them to this list.  
 
 
@@ -185,7 +247,7 @@ they tend to be very big and don't help with describing the problem.
 
 
 Searchable archives are available from
-@uref{http://www.mail-archive.com/bug-gnu-music@@gnu.org}.
+@uref{http://www.mail-archive.com/bug-lilypond@@gnu.org}.
 
 @end itemize