Doc: fix links, add Extending to website.

diff --git a/Documentation/general/manuals.itexi b/Documentation/general/manuals.itexi
index 2dd863b2c1d0955c4a96a47c3ddedad3de8bfffa..b3c01cf3a09c850bd882f2bcf50360eabc19cc42 100644 (file)
--- a/Documentation/general/manuals.itexi
+++ b/Documentation/general/manuals.itexi
@@ -73,6 +73,9 @@ links to the answers of Frequently Asked Questions.
 @item @ref{Changes}:
 updates since the last major version.
 
+@item @ref{Extend}:
+programming fancy tweaks in lilypond.
+
 @item @ref{Internals}:
 information about LilyPond's internal structures, which is
 required for constructing tweaks.
@@ -115,6 +118,7 @@ License.
 * Snippets::                Snippets.
 * FAQ::                         FAQ.
 * Changes::                     NEWS.
+* Extend::         Programming.
 * Internals::         Internals.
 * Translated::          Translation.
 * All::                 All manuals.
@@ -536,6 +540,52 @@ GNU info format for documentation.  FIXME, link broken.
 @divEnd
 
 
+@node Extend
+@unnumberedsec Extend
+
+@divClass{column-left-top}
+@subheading Extend LilyPond
+
+This manual explains how to write extensions to LilyPond.
+
+@divEnd
+
+@divClass{column-right-top}
+@subheading Read it now
+
+@itemize
+
+@item @rextendnamed{Top,Extend}: 
+read this manual in the same format as this one.
+
+@end itemize
+@divEnd
+
+@divClass{column-center-bottom}
+@subheading Other formats
+
+@divClass{keep-bullets}
+@itemize
+
+@item @uref{extending/index.html, Extend (split HTML)}:
+the manual is split between many HTML pages.
+@emph{(small download for each page)}
+
+@item @uref{extending-big-page.html, Extend (big HTML)}:
+read this manual as one huge HTML page.
+@emph{(large single download, around 10? Mb)}
+
+@item @uref{extending.pdf, extending.pdf}:
+download as a PDF file.
+@emph{(large single download, 2.8 Mb)}
+
+@item @uref{FIXME, extending.info}:
+GNU info format for documentation.  FIXME, link broken.
+
+@end itemize
+@divEnd
+@divEnd
+
 
 @node Internals
 @unnumberedsec Internals

diff --git a/Documentation/learning.tely b/Documentation/learning.tely
index adcecb5ece61905c178c72e31aa42b5da69d1710..26719f4a3429423f867df3d2cf117401d24509ff 100644 (file)
--- a/Documentation/learning.tely
+++ b/Documentation/learning.tely
@@ -51,7 +51,6 @@ by the authors.
 Appendices
 
 * Templates::                      Ready-made templates.
-* Scheme tutorial::                Programming inside LilyPond.
 * GNU Free Documentation License:: License of this document.
 * LilyPond index::
 @end menu
@@ -72,7 +71,6 @@ Appendices
 @include learning/tweaks.itely
 
 @include learning/templates.itely
-@include learning/scheme-tutorial.itely
 @include fdl.itexi
 
 

diff --git a/Documentation/learning/tweaks.itely b/Documentation/learning/tweaks.itely
index 12158ee87dc35c4645a4b83ecd052db9930ddef1..9c0b98edba1b943022a5e66c9f6e408590d6f96f 100644 (file)
--- a/Documentation/learning/tweaks.itely
+++ b/Documentation/learning/tweaks.itely
@@ -816,8 +816,8 @@ LilyPond.  Some of them are the names of properties, like
 @code{thickness} or @code{font-shape}, others are used as values that
 can be given to properties, like @code{italic}.  Note the distinction
 from arbitrary text strings, which would appear as @code{"a text
-string"}; for more details about symbols and strings, see @ref{Scheme
-tutorial}.
+string"}; for more details about symbols and strings, see
+@rextend{Scheme tutorial}.
 
 So we see that the @code{\override} command needed to print the lyrics
 in italics is:
@@ -882,7 +882,7 @@ the dot between the context name and the object name.}
 
 
 @seealso
-Learning Manual: @ref{Scheme tutorial}.
+Extending: @rextend{Scheme tutorial}.
 
 
 @node Types of properties
@@ -954,7 +954,7 @@ by apostrophe-hash, @code{'#}.
 
 
 @seealso
-Learning Manual: @ref{Scheme tutorial}.
+Extending: @rextend{Scheme tutorial}.
 
 
 @node Appearance of objects
@@ -3913,7 +3913,7 @@ LilyPond internal operation.  Further explanation of these files
 is currently outside the scope of this manual, as a knowledge of
 the Scheme language is required.  Users should be warned that
 a substantial amount of technical knowledge or time is required
-to understand Scheme and these files (see @ref{Scheme tutorial}).
+to understand Scheme and these files (see @rextend{Scheme tutorial}).
 
 If you have this knowledge, the Scheme files which may be of
 interest are:
@@ -3974,7 +3974,7 @@ interface to the LilyPond internal operation.  Code written in
 the Scheme programming language can be incorporated directly in
 the internal operation of LilyPond.  Of course, at least a basic
 knowledge of programming in Scheme is required to do this, and an
-introduction is provided in the @ref{Scheme tutorial}.
+introduction is provided in the @rextend{Scheme tutorial}.
 
 As an illustration of one of the many possibilities, instead of
 setting a property to a constant it can be set to a Scheme
@@ -4019,7 +4019,7 @@ the staff.
 @end lilypond
 
 Further examples showing the use of these programmable interfaces
-can be found in @ref{Tweaking with Scheme}.
+can be found in @rextend{Tweaking with Scheme}.
 
 
 

diff --git a/Documentation/macros.itexi b/Documentation/macros.itexi
index 2c923d7208439a93965ceb9448ccf3cddabff051..d580fdf02785314123b6df9b50fce7f28dee975d 100644 (file)
--- a/Documentation/macros.itexi
+++ b/Documentation/macros.itexi
@@ -193,6 +193,7 @@ For LilyPond version @version{}
 @c     @rprogram
 @c     @ruser
 @c     @rchanges
+@c     @rextend
 @c     @rcontrib
 @c
 @c  All these also have a @...named version which allows to specify the
@@ -240,6 +241,16 @@ For LilyPond version @version{}
 @ref{\TEXT\,,\DISPLAY\,notation-big-page,Notation Reference}
 @end macro
 
+@macro rextend{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,extending-big-page,Extending}
+@end macro
+
+@macro rextendnamed{TEXT,DISPLAY}
+@vindex \TEXT\
+@ref{\TEXT\,,\DISPLAY\,extending-big-page,Extending}
+@end macro
+
 @macro rchanges{TEXT}
 @vindex \TEXT\
 @ref{\TEXT\,,,changes-big-page,Changes}
@@ -357,6 +368,16 @@ For LilyPond version @version{}
 @ref{\TEXT\,,\DISPLAY\,changes,Changes}
 @end macro
 
+@macro rextend{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,extending,Extending}
+@end macro
+
+@macro rextendnamed{TEXT,DISPLAY}
+@vindex \TEXT\
+@ref{\TEXT\,,\DISPLAY\,extending,Extending}
+@end macro
+
 @macro rcontrib{TEXT}
 @vindex \TEXT\
 @ref{\TEXT\,,,contributor,Contributor's Guide}
@@ -459,6 +480,16 @@ For LilyPond version @version{}
 @ref{\TEXT\,,\DISPLAY\,lilypond-changes,Changes}
 @end macro
 
+@macro rextend{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-extending,Extending}
+@end macro
+
+@macro rextendnamed{TEXT,DISPLAY}
+@vindex \TEXT\
+@ref{\TEXT\,,\DISPLAY\,lilypond-extending,Extending}
+@end macro
+
 @macro rcontrib{TEXT}
 @vindex \TEXT\
 @ref{\TEXT\,,,lilypond-contributor,Contributor's Guide}
@@ -578,6 +609,16 @@ For LilyPond version @version{}
 @ref{\TEXT\,,\DISPLAY\,changes,Changes}
 @end macro
 
+@macro rextend{TEXT}
+@lilyvindex{\TEXT\}
+@ref{\TEXT\,,,extending,Extending}
+@end macro
+
+@macro rextendnamed{TEXT,DISPLAY}
+@lilyvindex{\TEXT\}
+@ref{\TEXT\,,\DISPLAY\,extending,Extending}
+@end macro
+
 @macro rcontrib{TEXT}
 @lilyvindex{\TEXT\}
 @ref{\TEXT\,,,contributor,Contributor's Guide}

diff --git a/Documentation/web-texi2html.init b/Documentation/web-texi2html.init
index 3700107e5eed662e464ca32172238f1eeb3c4a37..fb49202c8f365dc65373b739d9056084aecb0d9e 100644 (file)
--- a/Documentation/web-texi2html.init
+++ b/Documentation/web-texi2html.init
@@ -651,7 +651,7 @@ sub generate_ly_toc_entries($$$)
   my @color_3 = (
         "Productions", "Testimonials",
        "Source", "Old downloads",
-        "FAQ", "Changes", "Internals",
+        "FAQ", "Changes", "Extend", "Internals",
         "Publications", "Old news"
         );
   my @color_4 = (