@node Manuals
@unnumbered Manuals
-@c ugh! don't put a newline within this span - it generates a <p> tag!-td
@macro details{reference}
-@spanClass{detail} (@ref{\reference\, details of \reference\}) @spanEnd
+@spanClass{detail}
+(@ref{\reference\, details of \reference\})
+@spanEnd
@end macro
-
@divClass{heading-center}
@ifclear web_version
@heading Manuals for LilyPond @version
@divEnd
+@divClass{link-headings}
+
@divClass{column-center-top}
@subheading Introduction
@itemize
-@c ugh! don't put a newline after spanEnd - it generates a <p> tag! -td
@item
-@spanClass{strong-link}
@ref{Text input}:
-@spanEnd LilyPond is a @strong{text-based} music engraver. Read this first!
+LilyPond is a @strong{text-based} music engraver. Read this first!
@item
-@spanClass{strong-link}
@ifWebLinks{@manualStableLearningSplitNoName,@rlearningnamed{Top,Learning}}
-@spanEnd a @qq{must-read} gentle introduction to LilyPond.
+a @qq{must-read} gentle introduction to LilyPond.
@details{Learning}
@item
-@spanClass{strong-link}
@ifWebLinks{@manualStableGlossarySplitNoName,@rglosnamed{Top,Glossary}}
-@spanEnd @emph{(optional reading)} musical terms and translations.
+@emph{(optional reading)} musical terms and translations.
@details{Glossary}
@item
-@spanClass{strong-link}
@ifWebLinks{@manualStableEssaySplitNoName,@ressaynamed{Top,Essay}}
-@spanEnd @emph{(optional reading)} background information about computer engraving.
+@emph{(optional reading)} background information about computer engraving.
@details{Essay}
@end itemize
@itemize
@item
-@spanClass{strong-link}
@ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Top,Notation}}
-@spanEnd syntax reference.
+syntax reference.
@details{Notation}
@item
-@spanClass{strong-link}
@ifWebLinks{@manualStableUsageSplitNoName,@rprogramnamed{Top,Usage}}
-@spanEnd running the programs.
+running the programs.
@details{Usage}
@item
-@spanClass{strong-link}
@ifWebLinks{@manualStableSnippetsSplitNoName,@rlsrnamed{Top,Snippets}}
-@spanEnd short tricks and tips.
+short tricks and tips.
@details{Snippets}
@end itemize
@itemize
@item
-@spanClass{strong-link}
@ref{FAQ}:
-@spanEnd Frequently Asked Questions.
+Frequently Asked Questions.
@item
-@spanClass{strong-link}
@ref{Top, Web}:
-@spanEnd this document.
+this document.
@details{Web}
@item
-@spanClass{strong-link}
@ifWebLinks{@manualStableChangesSplitNoName,@rchangesnamed{Top,Changes}}
-@spanEnd what's new?
+what's new?
@details{Changes}
@item
-@spanClass{strong-link}
@ifWebLinks{@manualStableExtendingSplitNoName,@rextendnamed{Top,Extending}}
-@spanEnd fancy tweaks.
+fancy tweaks.
@details{Extending}
@item
-@spanClass{strong-link}
@ifWebLinks{@manualStableInternalsSplitNoName,@rinternalsnamed{Top,Internals}}
-@spanEnd tweaks reference.
+tweaks reference.
@details{Internals}
@end itemize
@itemize
@item
-@spanClass{strong-link}
+@ref{All}:
+previous stable versions and current as a compressed archive.
+
+@item
@ref{Translated}:
-@spanEnd translation status for non-English readers.
+translation status for non-English readers.
@item
-@spanClass{strong-link}
-@ref{All}:
-@spanEnd downloadable and old manuals.
+@uref{http://lsr@/.dsi@/.unimi@/.it,LilyPond Snippet Repository}:
+user-created examples, hints and tips.
+
+@item
+@uref{http://benlemon.me/blog/music/lilypond/operation-lilypond/,Video Tutorials}:
+Ben Lemon, a LilyPond user, has created a range of video tutorials on
+his blog and which are aimed at new users.
@item
-@spanClass{strong-link}
@ref{Development}:
-@spanEnd manuals for the unstable version.
+manuals for the unstable version.
@item
-@spanClass{strong-link}
@ref{FDL}:
-@spanEnd these manuals are published under the GNU Free Documentation License.
+these manuals are published under the GNU Free Documentation License.
@end itemize
@divEnd
+@divClass{column-center-bottom}
+@subheading Manual formats
+
+The LilyPond manuals generally come in three formats: split HTML, big HTML and
+PDF. Split HTML is good for reading online. Big HTML (and some of these can be
+very big) contains the whole manual in a single page. PDF is available for
+downloading and using offline. To get to these 3 formats, follow the links
+that read @code{details of} and then the manual name.
+
+@divEnd
+
+@divEnd
+
@divClass{hide}
@menu
@docLinks{Learning, learning,
@rlearningnamed{Top,Learning},
@manualStableLearningSplit,
- @manualStableLearningBig, 1.5 MB,
- @manualStableLearningPdf, 3 MB}
+ @manualStableLearningBig, 3 MB,
+ @manualStableLearningPdf, 5 MB}
@divEnd
@docLinks{Essay, essay,
@ressaynamed{Top,Essay},
@manualStableEssaySplit,
- @manualStableEssayBig, 2 MB,
- @manualStableEssayPdf, 2.5 MB}
+ @manualStableEssayBig, 1 MB,
+ @manualStableEssayPdf, 2 MB}
@divEnd
@docLinks{Notation, notation,
@rusernamed{Top,Notation},
@manualStableNotationSplit,
- @manualStableNotationBig, 7 MB,
- @manualStableNotationPdf, 18 MB}
+ @manualStableNotationBig, 9 MB,
+ @manualStableNotationPdf, 35 MB}
@divEnd
@docLinks{Usage, usage,
@rprogramnamed{Top,Usage},
@manualStableUsageSplit,
- @manualStableUsageBig, 300 KB,
- @manualStableUsagePdf, 400 KB}
+ @manualStableUsageBig, 400 KB,
+ @manualStableUsagePdf, 650 KB}
@divEnd
@docLinks{Snippets, snippets,
@rlsrnamed{Top,Snippets},
@manualStableSnippetsSplit,
- @manualStableSnippetsBig, 2.5 MB,
- @manualStableSnippetsPdf, 8 MB}
+ @manualStableSnippetsBig, 1.5 MB,
+ @manualStableSnippetsPdf, 12.5 MB}
@divEnd
@docLinksBare{Web, web,
@ref{Top,Web},
@manualDevelWebSplit,
- @manualDevelWebBig, 1 MB,
- @manualDevelWebPdf, 2 MB}
+ @manualDevelWebBig, 2.5 MB,
+ @manualDevelWebPdf, 3.5 MB}
@divEnd
@docLinks{Changes, changes,
@rchangesnamed{Top,Changes},
@manualStableChangesSplit,
- @manualStableChangesBig, 6 KB,
- @manualStableChangesPdf, 200 KB}
+ @manualStableChangesBig, 90 KB,
+ @manualStableChangesPdf, 80 KB}
@divEnd
@docLinks{Extending, extending,
@rextendnamed{Top,Extending},
@manualStableExtendingSplit,
- @manualStableExtendingBig, 200 KB,
- @manualStableExtendingPdf, 400 KB}
+ @manualStableExtendingBig, 300 KB,
+ @manualStableExtendingPdf, 500 KB}
@divEnd
@docLinks{Internals, internals,
@rinternalsnamed{Top,Internals},
@manualStableInternalsSplit,
- @manualStableInternalsBig, 2.5 MB,
- @manualStableInternalsPdf, 2.8 MB}
+ @manualStableInternalsBig, 3 MB,
+ @manualStableInternalsPdf, 4 MB}
@divEnd
@divClass{keep-bullets}
@itemize
+@item @uref{http://lilypond.org/doc/v2.14/Documentation/web/manuals,
+LilyPond 2.14 Documentation}
+
@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}