]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/index.texi
* Documentation/windows/zlily-profile.sh:
[lilypond.git] / Documentation / index.texi
index 0e969c7132f3c28ba42ef0f47e9d0ebaab593178..b4c0b0cf220fe525d93ef6bc28d0544a06e0b35a 100644 (file)
 @setfilename index.info
 @settitle Index to LilyPond documentation
 
+@html
+<!--- @@WEB-TITLE@@=Documentation --->
+@end html
+
 @node Top, , , (dir)
 @top
 
+@html
+<a name="everyone">
+@end html
+
+
+@unnumberedsubsec General information
 
-@unnumberedsubsec Info
 
 @itemize @bullet 
-@item @uref{DEDICATION.txt,Dedication}
-@item @uref{../topdocs/out-www/AUTHORS.html, Authors}
-@item @uref{../topdocs/out-www/README.html, Readme file}
-@item @uref{../topdocs/out-www/INSTALL.html, Installation instructions}
-@item @uref{faq.html,FAQ: Frequently asked questions}, with answers
+@item @uref{DEDICATION.html,Dedication}  Lily is  dedicated to our friends.
+@item @uref{http://www.gnu.org/copyleft/gpl.html,GPL} it is released under
+  the GNU GPL.
+@item @uref{http://www.lilypond.org/wiki, Lilypond Wiki} A wikiwiki site
+  dedicated to lilypond.
+@end itemize
+
+@html
+<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{../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.
 @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.
+@end itemize
 
-@unnumberedsubsec Manuals
+@unnumberedsubsubsec Documents
 
+@c direct links into first steps and running lily?
 @itemize @bullet
-@item @uref{../user/out-www/lilypond.html,LilyPond reference manual}
-also available in @uref{../user/out-www/lilypond.ps.gz,Postscript}
-@item @uref{../user/out-www/glossary.html,A glossary of musical
-terms}, includes translations.  Also available in @uref{../user/out-www/glossary.ps.gz,Postscript})
-@item @uref{../user/out-www/mudela-book.html,mudela-book}, a tool for
-integrating text and music in LaTeX and texinfo; also available in
-@uref{../user/out-www/mudela-book.ps.gz,Postscript}
-@item @uref{ly2dvi.html,ly2dvi} manual. Ly2dvi does page layout for
-LilyPond prints
-@item @uref{midi2ly.html,midi2ly} manual. midi2ly converts MIDI files to
-LilyPond input
-@item @uref{../programmer/out-www/index.html,Programmer documentation}
+@item @uref{../user/out-www/lilypond/Tutorial.html,Tutorial} Learn how to use LilyPond.
 @end itemize
 
+@end quotation
+
+@html
+<a name="users">
+@end html
+
+@unnumberedsubsec Information for users
 
-@unnumberedsubsec Status
 
 @itemize @bullet
-@item @uref{TODO.txt, Thing to do}
-@item @uref{CHANGES.txt, Things recently done}
+@item @uref{CHANGES.html, CHANGES} Things recently done.
+
+@c download sites?
+
+@c archives?
+
+@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.
+
+@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}
+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
+
+
+
+@html
+<a name="developers">
+@end html
+
+@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 large document that tests all kinds of features (also as
+@uref{../out-www/regression-test.ps.gz,Postscript}
+and
+@uref{../out-www/regression-test.pdf,PDF}).
+@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
 
 
 @unnumberedsubsec Logo
 @itemize @bullet
-@item @uref{../pictures/out-www/lelieblond.png,  logo} in large size
+@item @uref{../pictures/out-www/lelieblond.png, logo} in large size
 @item @uref{../pictures/out-www/lelie-logo.png, logo} in medium size
 @item @uref{../pictures/out-www/lelie-icon.png, logo} in small size
 @end itemize
 
 
+@unnumberedsubsec Background information
+
+
+@html
+<a name="background">
+@end html
+
+@itemize @bullet
+@item @uref{../topdocs/out-www/AUTHORS.html, Authors} documents who did
+what on LilyPond.
+@item @uref{../out-www/NEWS.txt,NEWS} summary of changes for 1.4
+@item @uref{../misc/out-www/CHANGES-0.0.html, CHANGES-0.0} Change logs from 0.0 till 0.1
+@item @uref{../misc/out-www/CHANGES-0.1.html, CHANGES-0.1} Change logs from 0.1 till 1.0 
+@item @uref{../misc/out-www/CHANGES-1.0.html, CHANGES-1.0} Change logs from 1.0 till 1.1 
+@item @uref{../misc/out-www/CHANGES-1.1.html, CHANGES-1.1} Change logs from 1.1 till
+1.2 
+@item @uref{../misc/out-www/CHANGES-1.2.html, CHANGES-1.2} Change logs from 1.2 till 1.3 
+@item @uref{../misc/out-www/NEWS-1.2.html, NEWS-1.2} summary of changes from 1.1 till 1.2
+@item @uref{../misc/out-www/ANNOUNCE-0.1.html, ANNOUNCE-0.1} Announcement of 0.1 (includes summary of
+changes)
+@item @uref{../misc/out-www/ANNOUNCE-1.0.html, ANNOUNCE-1.0} Announcement of 1.0 (includes summary of
+changes)
+@item @uref{../misc/out-www/ANNOUNCE-1.2.html, ANNOUNCE-1.2} Announcement of 1.2 (includes summary of changes)
+@item @uref{../misc/out-www/AIMS.html, AIMS} Why LilyPond?
+@item @uref{../misc/out-www/interview.html, interview} Answers to the Brave GNU world standard questions.
+@item @uref{../windows/out-www/lily-wins.html, lily-wins} musings on the
+Windows installer
+@end itemize
 
 @unnumberedsubsec Literature
 
@@ -59,7 +187,7 @@ LilyPond input
 @item @uref{../bibliography/out-www/colorado.html,University of
 Colorado Engraving music bibliography}. Books refered from the
 @uref{http://www.cc.colorado.edu/Dept/MU/Musicpress/,Big Site of Music
-Notation and Engraving} at University  of Colorado.
+Notation and Engraving} at University of Colorado.
 @item References on
 @uref{../bibliography/out-www/engraving.html,engraving and music
 notation}.
@@ -69,23 +197,59 @@ by computer}.
 @end itemize
 
 
-@unnumberedsubsec Miscellaneous texts
+@html
+<a name="mailing-lists">
+@end html
+@unnumberedsec Mailing lists
+
+If you have questions, do write to the mailing lists.  But don't forget
+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{../misc/out-www/CHANGES-0.0.txt, Change logs from 0.0 till 0.1 }
-@item @uref{../misc/out-www/CHANGES-0.1.txt, Change logs from 0.1 till 1.0 }
-@item @uref{../misc/out-www/CHANGES-1.0.txt, Change logs from 1.0 till 1.1 }
-@item @uref{../misc/out-www/CHANGES-1.1.txt, Change logs from 1.1 till 1.2 }
-@item @uref{../misc/out-www/NEWS-1.2.txt, summary of changes from 1.1 till 1.2 }
-@item @uref{../misc/out-www/ANNOUNCE-0.1.txt, Announcement of 0.1 (includes summary of
-changes)}
-@item @uref{../misc/out-www/ANNOUNCE-1.0.txt, Announcement of 1.0 (includes summary of
-changes)}
-@item @uref{../misc/out-www/ANNOUNCE-1.2.txt, Announcement of 1.2 (includes summary of changes)}
-@item @uref{../misc/out-www/AIMS.txt, Why LilyPond?}
-@item @uref{../misc/out-www/interview.txt, Answers} to the Brave GNU world standard questions.
+@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/lilypond-devel@@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-lilypond@@gnu.org}.
+
+@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/lilypond-user@@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.  
+
+
+        Please include in your bugreport the version of LilyPond that
+you experience the problem with, a description of your system and sample
+input to reproduce the problem. Do not send output files over the list,
+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-lilypond@@gnu.org}.
+
 @end itemize
 
+These pages were entirely created from a @strong{development snapshot}
+of the LilyPond package.  The version of this webpage is printed at the
+bottom.
 
 
 @bye