Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
When revising a translation, copy the HEAD committish of the
- version that you are working on. See TRANSLATION for details.
+ version that you are working on. For details, see the Contributors'
+ Guide, node Updating translation committishes..
@end ignore
@node Manuals
@unnumbered Manuals
+@macro details{reference}
+@spanClass{detail}
+(@ref{\reference\, details of \reference\})
+@spanEnd
+@end macro
+
@divClass{heading-center}
@ifclear web_version
@heading Manuals for LilyPond @version
@heading Manuals for LilyPond @versionStable
@end ifset
-
@divEnd
-@c TODO: do we want these links to be in larger text / bold ? CSS.
+@divClass{link-headings}
-@c if you change this page, also change All.
@divClass{column-center-top}
@subheading Introduction
@itemize
-@item @ref{Text input}:
-LilyPond is a @strong{text-based} music engraver. If you are not
-familiar with this concept, please read this now!
+@item
+@ref{Text input}:
+LilyPond is a @strong{text-based} music engraver. Read this first!
-@item @ref{Learning}:
+@item
+@ifWebLinks{@manualStableLearningSplitNoName,@rlearningnamed{Top,Learning}}
a @qq{must-read} gentle introduction to LilyPond.
+@details{Learning}
-@item @ref{Glossary}:
-@emph{(optional reading)}
-explains musical terms and gives translations for users unfamiliar
-with English musical terms.
-
-@item @ref{Essay}:
-@emph{(optional reading)}
-background information about the engraving process and the
-aesthetics of 19th century music engraving.
+@item
+@ifWebLinks{@manualStableGlossarySplitNoName,@rglosnamed{Top,Glossary}}
+@emph{(optional reading)} musical terms and translations.
+@details{Glossary}
+@item
+@ifWebLinks{@manualStableEssaySplitNoName,@ressaynamed{Top,Essay}}
+@emph{(optional reading)} background information about computer engraving.
+@details{Essay}
@end itemize
@itemize
-@item @ref{Notation}:
-the main portion of the documentation; provides detailed
-information about creating notation.
+@item
+@ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Top,Notation}}
+syntax reference.
+@details{Notation}
-@item @ref{Usage}:
-discusses the actual programs and operating system-specific
-issues.
+@item
+@ifWebLinks{@manualStableUsageSplitNoName,@rprogramnamed{Top,Usage}}
+running the programs.
+@details{Usage}
-@item @ref{Snippets}:
-short tricks, tips, and examples.
+@item
+@ifWebLinks{@manualStableSnippetsSplitNoName,@rlsrnamed{Top,Snippets}}
+short tricks and tips.
+@details{Snippets}
@end itemize
@itemize
-@item @ref{Web}:
-this document.
+@item
+@ref{FAQ}:
+Frequently Asked Questions.
-@item @ref{FAQ}:
-links to the answers of Frequently Asked Questions.
+@item
+@ref{Top, Web}:
+this document.
+@details{Web}
-@item @ref{Changes}:
-updates since the last major version.
+@item
+@ifWebLinks{@manualStableChangesSplitNoName,@rchangesnamed{Top,Changes}}
+what's new?
+@details{Changes}
-@item @ref{Extend}:
-programming fancy tweaks in LilyPond.
+@item
+@ifWebLinks{@manualStableExtendingSplitNoName,@rextendnamed{Top,Extending}}
+fancy tweaks.
+@details{Extending}
-@item @ref{Internals}:
-information about LilyPond's internal structures, which is
-required for constructing tweaks.
+@item
+@ifWebLinks{@manualStableInternalsSplitNoName,@rinternalsnamed{Top,Internals}}
+tweaks reference.
+@details{Internals}
@end itemize
@itemize
-@item @ref{Translated}:
+@item
+@ref{All}:
+previous stable versions and current as a compressed archive.
+
+@item
+@ref{Translated}:
translation status for non-English readers.
-@item @ref{All}:
-quick links, downloadable manuals, and old manuals.
+@item
+@uref{http://lsr@/.dsi@/.unimi@/.it,LilyPond Snippet Repository}:
+user-created examples, hints and tips.
-@item @ref{Development}:
+@item
+@ref{Development}:
manuals for the unstable version.
-@item @ref{FDL}:
-these manuals are published under the GNU Free Documentation
-License.
+@item
+@ref{FDL}:
+these manuals are published under the GNU Free Documentation License.
@end itemize
@divEnd
+@divEnd
+
@divClass{hide}
@menu
* Notation:: Reference.
* Usage:: Usage.
* Snippets:: Snippets.
-* Web:: Web.
* FAQ:: FAQ.
+* Web:: Web.
* Changes:: NEWS.
-* Extend:: Programming.
+* Extending:: Programming.
* Internals:: Internals.
* Translated:: Translation.
* All:: All manuals.
an examination of LilyPond's engraving techniques. A comparison
between LilyPond and other music engraving systems is given.
-@warning{The detailed typographical examples are easier to analyze
+@warning{the detailed typographical examples are easier to analyze
in the PDF version due to its higher resolution.}
@divEnd
@divClass{column-right-bottom}
@docLinks{Essay, essay,
- @rglosnamed{Top,Essay},
+ @ressaynamed{Top,Essay},
@manualStableEssaySplit,
@manualStableEssayBig, 2 MB,
@manualStableEssayPdf, 2.5 MB}
This book explains all the LilyPond commands which produce
notation.
-@warning{The Notation reference assumes that the reader knows
+@warning{the Notation reference assumes that the reader knows
basic material covered in the Learning manual and is familiar with
the English musical terms presented in the glossary.}
@divClass{column-right-bottom}
@docLinks{Notation, notation,
- @rglosnamed{Top,Notation},
+ @rusernamed{Top,Notation},
@manualStableNotationSplit,
@manualStableNotationBig, 7 MB,
@manualStableNotationPdf, 18 MB}
@divClass{column-right-bottom}
@docLinks{Usage, usage,
- @rglosnamed{Top,Usage},
+ @rprogramnamed{Top,Usage},
@manualStableUsageSplit,
- @manualStableUsageBig, 300 KB,
- @manualStableUsagePdf, 400 KB}
+ @manualStableUsageBig, 400 KB,
+ @manualStableUsagePdf, 600 KB}
@divEnd
Please note that this document is not an exact subset of LSR. LSR
is running a stable LilyPond version, so any snippet which
demonstrates new features of a development version must be added
-separately. These are stored in @file{input/new/} in the LilyPond
+separately. These are stored in @file{Documentation/snippets/new/} in the LilyPond
source tree.
The list of snippets for each subsection of the Notation are also
@divClass{column-right-bottom}
@docLinks{Snippets, snippets,
- @rglosnamed{Top,Snippets},
+ @rlsrnamed{Top,Snippets},
@manualStableSnippetsSplit,
@manualStableSnippetsBig, 2.5 MB,
@manualStableSnippetsPdf, 8 MB}
@divEnd
-@node Web
-@unnumberedsec Web
-
-@divClass{column-left-top}
-@subheading Web
-
-This manual supplies general information about LilyPond. It also
-contains information about various community forums, bug
-reporting, and development.
-
-@divEnd
-
-@divClass{column-right-bottom}
-
-@docLinks{Web, web,
- @rglosnamed{Top,Web},
- @manualStableWebSplit,
- @manualStableWebBig, 1 MB,
- @manualStableWebPdf, 2 MB}
-
-@divEnd
-
-
@node FAQ
@unnumberedsec FAQ
@divEnd
+@node Web
+@unnumberedsec Web
+
+@divClass{column-left-top}
+@subheading Web
+
+This manual supplies general information about LilyPond. It also
+contains information about various community forums, bug
+reporting, and development.
+
+@divEnd
+
+@divClass{column-right-bottom}
+@subheading Read it
+
+@subsubheading Latest manual
+
+@divClass{keep-bullets}
+@itemize
+@ref{Top,Web}
+@end itemize
+@divEnd
+
+@subsubheading Web manual in @versionDevel
+
+@docLinksBare{Web, web,
+ @ref{Top,Web},
+ @manualDevelWebSplit,
+ @manualDevelWebBig, 1 MB,
+ @manualDevelWebPdf, 2 MB}
+
+@divEnd
+
+
@node Changes
@unnumberedsec Changes
@divClass{column-right-bottom}
@docLinks{Changes, changes,
- @rglosnamed{Top,Changes},
+ @rchangesnamed{Top,Changes},
@manualStableChangesSplit,
@manualStableChangesBig, 6 KB,
@manualStableChangesPdf, 200 KB}
@divEnd
-@node Extend
-@unnumberedsec Extend
+@node Extending
+@unnumberedsec Extending
@divClass{column-left-top}
-@subheading Extend LilyPond
+@subheading Extending LilyPond
This manual explains how to write extensions to LilyPond.
@divClass{column-right-bottom}
-@docLinks{Extend, extend,
- @rglosnamed{Top,Extend},
+@docLinks{Extending, extending,
+ @rextendnamed{Top,Extending},
@manualStableExtendingSplit,
@manualStableExtendingBig, 200 KB,
@manualStableExtendingPdf, 400 KB}
@divClass{column-left-top}
@subheading Internals reference
-This is a set of heavily cross linked HTML pages which document
+This is a set of heavily cross linked pages which document
the nitty-gritty details of each and every LilyPond class, object,
and function. It is produced directly from the formatting
definitions in the source code.
files. There are a huge number of formatting options, and all of
them are described in this document. Each section of the Notation
Reference has a @b{See also} subsection, which refers to the
-generated documentation. In the HTML document, these subsections
-have clickable links.
+generated documentation.
@divEnd
@divClass{column-right-bottom}
@docLinks{Internals, internals,
- @rglosnamed{Top,Internals},
+ @rinternalsnamed{Top,Internals},
@manualStableInternalsSplit,
@manualStableInternalsBig, 2.5 MB,
@manualStableInternalsPdf, 2.8 MB}
@unnumberedsec Translated
@divClass{column-center-bottom}
-@subheading Translation status
-
-TODO: clean up / prettify
+@subheading Translations status
-@uref{../translations.html}.
+@include translations.itexi
@divEnd
@node All
@unnumberedsec All
-@divClass{heading-center}
-@heading Documentation quick links
-
-Links to other formats of these manuals can be found in
-@ref{Manuals}.
-
-@divEnd
-
-@c this should match the (main) manual page.
-@divClass{column-center-top}
-@subheading Introduction
-
-@itemize
-
-@c no colon : needed in this section
-@item @ifWebLinks{@manualStableLearningSplit,@rlearningnamed{Top,Learning}}
-a @qq{must-read} gentle introduction to LilyPond.
-
-@item @ifWebLinks{@manualStableGlossarySplit,@rglosnamed{Top,Glossary}}
-@emph{(optional reading)}
-explains musical terms and gives translations for users unfamiliar
-with English musical terms.
-
-@item @ifWebLinks{@manualStableEssaySplit,@ressaynamed{Top,Essay}}
-@emph{(optional reading)}
-background information about the engraving process and the
-aesthetics of 19th century music engraving.
-
-@end itemize
-
-@divEnd
-
@divClass{column-left-top}
-@subheading Regular use
-
-@itemize
-
-@item @ifWebLinks{@manualStableNotationSplit,@rusernamed{Top,Notation}}
-the main portion of the documentation; provides detailed
-information about creating notation.
-
-@item @ifWebLinks{@manualStableUsageSplit,@rprogramnamed{Top,Usage}}
-discusses the actual programs and operation system-specific
-issues.
-
-@item @ifWebLinks{@manualStableSnippetsSplit,@rlsrnamed{Top,Snippets}}
-short tricks, tips, and examples.
-
-@end itemize
-
-@divEnd
-
-
-@divClass{column-right-top}
-@subheading Infrequent Use
-
-@itemize
-
-@item @ref{FAQ}:
-links to answers of Frequently Asked Questions.
-
-@item @ifWebLinks{@manualStableChangesSplit,@rchangesnamed{Top,Changes}}
-updates since the last major version.
-
-@item @ifWebLinks{@manualStableExtendingSplit,@rextendnamed{Top,Extend}}
-programming fancy tweaks in LilyPond.
-
-@item @ifWebLinks{@manualStableInternalsSplit,@rinternalsnamed{Top,Internals}}
-information about LilyPond's internal structures, which is
-required for constructing tweaks.
-
-@end itemize
-
-@divEnd
-
-
-@divClass{column-center-bottom}
@subheading Downloadable versions
-@help{compare tarball vs. zip size, ask about windows users
-dealing with tarballs (both gz and bz2), etc.}
-
-@help{on second thought, wait until the new doc build. write an
-apology here for no tarballs}
+@ifclear web_version
+Downloadable tarballs only available at @uref{http://lilypond.org}
+@end ifclear
+@ifset web_version
@divClass{keep-bullets}
@itemize
-@item html-split zip
-
-@item html-big zip
-
-@item pdf zip
-
-@item info zip maybe?!?!
+@item @doctarballStable
@end itemize
@divEnd
+@end ifset
+@divEnd
+
+@divClass{column-right-bottom}
@subheading Previous stable versions
@divClass{keep-bullets}
@item @uref{http://lilypond.org/doc/v2.12/Documentation/,
LilyPond 2.12 Documentation}
+@item @uref{http://lilypond.org/doc/v2.11/Documentation/,
+LilyPond 2.11 Documentation}
+
@item @uref{http://lilypond.org/doc/v2.10/Documentation/,
LilyPond 2.10 Documentation}
@item @uref{http://lilypond.org/doc/v2.8/Documentation/,
LilyPond 2.8 Documentation}
-@help anybody want to write this stuff?
+@item @uref{http://lilypond.org/doc/v2.6/Documentation/,
+LilyPond 2.6 Documentation}
+
+@item @uref{http://lilypond.org/doc/v2.4/Documentation/out-www/,
+LilyPond 2.4 Documentation}
+
+@item @uref{http://lilypond.org/doc/v2.2/Documentation/out-www/,
+LilyPond 2.2 Documentation}
+
+@item @uref{http://lilypond.org/doc/v2.0/Documentation/out-www/,
+LilyPond 2.0 Documentation}
+
+@item @uref{http://lilypond.org/doc/v1.8/Documentation/out-www/,
+LilyPond 1.8 Documentation}
+
+@item @uref{http://lilypond.org/doc/v1.6/Documentation/out-www/,
+LilyPond 1.6 Documentation}
@end itemize
@include fdl.itexi
@divEnd
-
-
projects / lilypond.git / blobdiff