Release: update news.

[lilypond.git] / Documentation / web / manuals.itexi

diff --git a/Documentation/web/manuals.itexi b/Documentation/web/manuals.itexi
index 342c117050bbd15384d028e7fdfffe88388112a7..e741a960eaa3831bdd43d9fe184ab9ac987537ba 100644 (file)
--- a/Documentation/web/manuals.itexi
+++ b/Documentation/web/manuals.itexi
@@ -10,12 +10,12 @@
 @node Manuals
 @unnumbered Manuals
 
 @node Manuals
 @unnumbered Manuals
 

-@c ugh! don't put a newline within this span - it generates a <p> tag!-td

 @macro details{reference}
 @macro details{reference}

-@spanClass{detail} (@ref{\reference\, details of \reference\}) @spanEnd
+@spanClass{detail}
+(@ref{\reference\, details of \reference\})
+@spanEnd

 @end macro
 
 @end macro
 

-

 @divClass{heading-center}
 @ifclear web_version
   @heading Manuals for LilyPond @version
 @divClass{heading-center}
 @ifclear web_version
   @heading Manuals for LilyPond @version


@@ -26,33 +26,30 @@
 
 @divEnd
 
 
 @divEnd
 

+@divClass{link-headings}
+

 @divClass{column-center-top}
 @subheading Introduction
 
 @itemize
 
 @divClass{column-center-top}
 @subheading Introduction
 
 @itemize
 

-@c ugh! don't put a newline after spanEnd - it generates a <p> tag! -td

 @item
 @item

-@spanClass{strong-link}

 @ref{Text input}:
 @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
 
 @item

-@spanClass{strong-link}

 @ifWebLinks{@manualStableLearningSplitNoName,@rlearningnamed{Top,Learning}}
 @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
 @details{Learning}
 
 @item

-@spanClass{strong-link}

 @ifWebLinks{@manualStableGlossarySplitNoName,@rglosnamed{Top,Glossary}}
 @ifWebLinks{@manualStableGlossarySplitNoName,@rglosnamed{Top,Glossary}}

-@spanEnd @emph{(optional reading)} musical terms and translations.
+@emph{(optional reading)} musical terms and translations.

 @details{Glossary}
 
 @item
 @details{Glossary}
 
 @item

-@spanClass{strong-link}

 @ifWebLinks{@manualStableEssaySplitNoName,@ressaynamed{Top,Essay}}
 @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
 @details{Essay}
 
 @end itemize


@@ -65,21 +62,18 @@
 @itemize
 
 @item
 @itemize
 
 @item

-@spanClass{strong-link}

 @ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Top,Notation}}
 @ifWebLinks{@manualStableNotationSplitNoName,@rusernamed{Top,Notation}}

-@spanEnd syntax reference.
+syntax reference.

 @details{Notation}
 
 @item
 @details{Notation}
 
 @item

-@spanClass{strong-link}

 @ifWebLinks{@manualStableUsageSplitNoName,@rprogramnamed{Top,Usage}}
 @ifWebLinks{@manualStableUsageSplitNoName,@rprogramnamed{Top,Usage}}

-@spanEnd running the programs.
+running the programs.

 @details{Usage}
 
 @item
 @details{Usage}
 
 @item

-@spanClass{strong-link}

 @ifWebLinks{@manualStableSnippetsSplitNoName,@rlsrnamed{Top,Snippets}}
 @ifWebLinks{@manualStableSnippetsSplitNoName,@rlsrnamed{Top,Snippets}}

-@spanEnd short tricks and tips.
+short tricks and tips.

 @details{Snippets}
 
 @end itemize
 @details{Snippets}
 
 @end itemize


@@ -93,32 +87,27 @@
 @itemize
 
 @item
 @itemize
 
 @item

-@spanClass{strong-link}

 @ref{FAQ}:
 @ref{FAQ}:

-@spanEnd Frequently Asked Questions.
+Frequently Asked Questions.

 
 @item
 
 @item

-@spanClass{strong-link}

 @ref{Top, Web}:
 @ref{Top, Web}:

-@spanEnd this document.
+this document.

 @details{Web}
 
 @item
 @details{Web}
 
 @item

-@spanClass{strong-link}

 @ifWebLinks{@manualStableChangesSplitNoName,@rchangesnamed{Top,Changes}}
 @ifWebLinks{@manualStableChangesSplitNoName,@rchangesnamed{Top,Changes}}

-@spanEnd what's new?
+what's new?

 @details{Changes}
 
 @item
 @details{Changes}
 
 @item

-@spanClass{strong-link}

 @ifWebLinks{@manualStableExtendingSplitNoName,@rextendnamed{Top,Extending}}
 @ifWebLinks{@manualStableExtendingSplitNoName,@rextendnamed{Top,Extending}}

-@spanEnd fancy tweaks.
+fancy tweaks.

 @details{Extending}
 
 @item
 @details{Extending}
 
 @item

-@spanClass{strong-link}

 @ifWebLinks{@manualStableInternalsSplitNoName,@rinternalsnamed{Top,Internals}}
 @ifWebLinks{@manualStableInternalsSplitNoName,@rinternalsnamed{Top,Internals}}

-@spanEnd tweaks reference.
+tweaks reference.

 @details{Internals}
 
 @end itemize
 @details{Internals}
 
 @end itemize


@@ -132,29 +121,47 @@
 @itemize
 
 @item
 @itemize
 
 @item

-@spanClass{strong-link}
+@ref{All}:
+previous stable versions and current as a compressed archive.
+
+@item

 @ref{Translated}:
 @ref{Translated}:

-@spanEnd translation status for non-English readers.
+translation status for non-English readers.

 
 @item
 
 @item

-@spanClass{strong-link}
-@ref{All}:
-@spanEnd downloadable and old manuals.
+@uref{http://lsr@/.di@/.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
 
 @item

-@spanClass{strong-link}

 @ref{Development}:
 @ref{Development}:

-@spanEnd manuals for the unstable version.
+manuals for the unstable version.

 
 @item
 
 @item

-@spanClass{strong-link}

 @ref{FDL}:
 @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
 
 
 @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
 
 @divClass{hide}
 @menu


@@ -203,8 +210,8 @@ and follow those cross-references for more information.
 @docLinks{Learning, learning,
   @rlearningnamed{Top,Learning},
   @manualStableLearningSplit,
 @docLinks{Learning, learning,
   @rlearningnamed{Top,Learning},
   @manualStableLearningSplit,

-  @manualStableLearningBig, 1.5 MB,
-  @manualStableLearningPdf, 3 MB}
+  @manualStableLearningBig, 3 MB,
+  @manualStableLearningPdf, 5 MB}

 
 @divEnd
 
 
 @divEnd
 


@@ -253,8 +260,8 @@ in the PDF version due to its higher resolution.}
 @docLinks{Essay, essay,
   @ressaynamed{Top,Essay},
   @manualStableEssaySplit,
 @docLinks{Essay, essay,
   @ressaynamed{Top,Essay},
   @manualStableEssaySplit,

-  @manualStableEssayBig, 2 MB,
-  @manualStableEssayPdf, 2.5 MB}
+  @manualStableEssayBig, 1 MB,
+  @manualStableEssayPdf, 2 MB}

 
 @divEnd
 
 
 @divEnd
 


@@ -279,8 +286,8 @@ the English musical terms presented in the glossary.}
 @docLinks{Notation, notation,
   @rusernamed{Top,Notation},
   @manualStableNotationSplit,
 @docLinks{Notation, notation,
   @rusernamed{Top,Notation},
   @manualStableNotationSplit,

-  @manualStableNotationBig, 7 MB,
-  @manualStableNotationPdf, 18 MB}
+  @manualStableNotationBig, 9 MB,
+  @manualStableNotationPdf, 35 MB}

 
 @divEnd
 
 
 @divEnd
 


@@ -303,8 +310,8 @@ attempting any large projects.
 @docLinks{Usage, usage,
   @rprogramnamed{Top,Usage},
   @manualStableUsageSplit,
 @docLinks{Usage, usage,
   @rprogramnamed{Top,Usage},
   @manualStableUsageSplit,

-  @manualStableUsageBig, 300 KB,
-  @manualStableUsagePdf, 400 KB}
+  @manualStableUsageBig, 400 KB,
+  @manualStableUsagePdf, 650 KB}

 
 @divEnd
 
 
 @divEnd
 


@@ -316,7 +323,7 @@ attempting any large projects.
 @subheading Snippets
 
 This shows a selected set of LilyPond snippets from the
 @subheading Snippets
 
 This shows a selected set of LilyPond snippets from the

-@uref{http://lsr@/.dsi@/.unimi@/.it,LilyPond Snippet Repository}
+@uref{http://lsr@/.di@/.unimi@/.it,LilyPond Snippet Repository}

 (LSR).  All the snippets are in the public domain.
 
 Please note that this document is not an exact subset of LSR.  LSR
 (LSR).  All the snippets are in the public domain.
 
 Please note that this document is not an exact subset of LSR.  LSR


@@ -334,8 +341,8 @@ linked from the @strong{See also} portion.
 @docLinks{Snippets, snippets,
   @rlsrnamed{Top,Snippets},
   @manualStableSnippetsSplit,
 @docLinks{Snippets, snippets,
   @rlsrnamed{Top,Snippets},
   @manualStableSnippetsSplit,

-  @manualStableSnippetsBig, 2.5 MB,
-  @manualStableSnippetsPdf, 8 MB}
+  @manualStableSnippetsBig, 1.5 MB,
+  @manualStableSnippetsPdf, 12.5 MB}

 
 @divEnd
 
 
 @divEnd
 


@@ -409,8 +416,8 @@ reporting, and development.
 @docLinksBare{Web, web,
   @ref{Top,Web},
   @manualDevelWebSplit,
 @docLinksBare{Web, web,
   @ref{Top,Web},
   @manualDevelWebSplit,

-  @manualDevelWebBig, 1 MB,
-  @manualDevelWebPdf, 2 MB}
+  @manualDevelWebBig, 2.5 MB,
+  @manualDevelWebPdf, 3.5 MB}

 
 @divEnd
 
 
 @divEnd
 


@@ -431,8 +438,8 @@ LilyPond since the previous stable version.
 @docLinks{Changes, changes,
   @rchangesnamed{Top,Changes},
   @manualStableChangesSplit,
 @docLinks{Changes, changes,
   @rchangesnamed{Top,Changes},
   @manualStableChangesSplit,

-  @manualStableChangesBig, 6 KB,
-  @manualStableChangesPdf, 200 KB}
+  @manualStableChangesBig, 90 KB,
+  @manualStableChangesPdf, 80 KB}

 
 @divEnd
 
 
 @divEnd
 


@@ -452,8 +459,8 @@ This manual explains how to write extensions to LilyPond.
 @docLinks{Extending, extending,
   @rextendnamed{Top,Extending},
   @manualStableExtendingSplit,
 @docLinks{Extending, extending,
   @rextendnamed{Top,Extending},
   @manualStableExtendingSplit,

-  @manualStableExtendingBig, 200 KB,
-  @manualStableExtendingPdf, 400 KB}
+  @manualStableExtendingBig, 300 KB,
+  @manualStableExtendingPdf, 500 KB}

 
 @divEnd
 
 
 @divEnd
 


@@ -484,8 +491,8 @@ generated documentation.
 @docLinks{Internals, internals,
   @rinternalsnamed{Top,Internals},
   @manualStableInternalsSplit,
 @docLinks{Internals, internals,
   @rinternalsnamed{Top,Internals},
   @manualStableInternalsSplit,

-  @manualStableInternalsBig, 2.5 MB,
-  @manualStableInternalsPdf, 2.8 MB}
+  @manualStableInternalsBig, 3 MB,
+  @manualStableInternalsPdf, 4 MB}

 
 @divEnd
 
 
 @divEnd
 


@@ -530,12 +537,15 @@ Downloadable tarballs only available at @uref{http://lilypond.org}
 @divClass{keep-bullets}
 @itemize
 
 @divClass{keep-bullets}
 @itemize
 

+@item @uref{http://lilypond.org/doc/v2.16/Documentation/web/manuals,
+LilyPond 2.16 Documentation}
+
+@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.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.10/Documentation/,
 LilyPond 2.10 Documentation}