X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fmacros.itexi;h=3a4447a898bffd8301975f84218c30555fb537f4;hb=d8f8e23dbd11cf213a37ad233c7f78b9b84e8ac1;hp=38609b25efbe6fc8570abcd247e293dedc7ca80f;hpb=ee7ca91ef74b9d17aad3b6927c5dfb217e94cc5c;p=lilypond.git diff --git a/Documentation/macros.itexi b/Documentation/macros.itexi index 38609b25ef..3a4447a898 100644 --- a/Documentation/macros.itexi +++ b/Documentation/macros.itexi @@ -27,9 +27,15 @@ @ifhtml @macro warning{TEXT} -@cartouche -@b{Note:} \TEXT\ -@end cartouche +@html +
+@end html +@strong{Note:} \TEXT\ +@c keep the space for proper nesting of

+ +@html +
+@end html @end macro @end ifhtml @@ -49,9 +55,91 @@ @end ifnothtml +@macro docMain +@cartouche +For more information about how this manual fits with the other +documentation, or to read this manual in other formats, see +@rweb{Manuals}. + +If you are missing any manuals, the complete documentation can be +found at @w{@uref{http://@/www@/.lilypond@/.org/}}. +@end cartouche +@end macro + + +@macro lilyTitlePage{TITLE} +@c This produces the unified index +@syncodeindex fn cp +@syncodeindex vr cp + + +@c ***** Copyright stuff ***** +@ifset FDL +@copying +@copyrightDeclare + +@quotation +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.1 +or any later version published by the Free Software Foundation; +with no Invariant Sections. +A copy of the license is included in the section entitled ``GNU +Free Documentation License''. +@end quotation +@end copying +@end ifset + +@ifclear FDL +@copying +This document has been placed in the public domain. +@end copying +@end ifclear + + + +@c ***** Title page ***** +@ifnottex +@node Top +@top LilyPond --- \TITLE\ + +@cartouche +@manualIntro{} +@end cartouche +@end ifnottex + +@finalout + +@titlepage +@title LilyPond +@subtitle The music typesetter +@titlefont{\TITLE\} +@author The LilyPond development team + +@vskip 60pt + +@cartouche +@manualIntro{} +@end cartouche + +@vskip 40pt + +@docMain{} + +@vskip 0pt plus 1filll + +@insertcopying{} + +For LilyPond version @version{} +@end titlepage + +@end macro + @c ***** Headings in a doc subsection ***** +@c The next macro is a dummy currently since texinfo doesn't +@c provide a real ragged-right environment yet. +@c @c Don't insert an empty line after @predefined! Right now @c it doesn't matter, but a future implementation will probably @c add some code which needs this restriction. @@ -61,11 +149,8 @@ @subsubheading Predefined commands @end macro -@c The next macro is a dummy currently since texinfo doesn't -@c provide a real ragged-right environment yet. -@c @c Due to a bug in texi2html (texi2html.pl CVS versions <= 1.245) -@c the macro must not be empty. +@c the next macro must not be empty. @macro endpredefined @c @@ -99,13 +184,17 @@ @c Definitions for references: @c +@c @rweb +@c @ressay @c @rglos +@c @rinternals @c @rlearning -@c @ruser -@c @ressay -@c @rprogram @c @rlsr -@c @rinternals +@c @rprogram +@c @ruser +@c @rchanges +@c @rextend +@c @rcontrib @c @c All these also have a @...named version which allows to specify the @c displayed text for the reference as second argument. @@ -152,6 +241,46 @@ @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} +@end macro + +@macro rchangesnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,changes-big-page,Changes} +@end macro + +@macro rcontrib{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,contributor-big-page,Contributor's Guide} +@end macro + +@macro rcontribnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,contributor-big-page,Contributor's Guide} +@end macro + +@macro rweb{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,web-big-page,General Information} +@end macro + +@macro rwebnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,web-big-page,General Information} +@end macro + @macro ressay{TEXT} @vindex \TEXT\ @ref{\TEXT\,,,essay-big-page,Essay} @@ -164,12 +293,12 @@ @macro rprogram{TEXT} @vindex \TEXT\ -@ref{\TEXT\,,,application-big-page,Application Usage} +@ref{\TEXT\,,,usage-big-page,Application Usage} @end macro @macro rprogramnamed{TEXT,DISPLAY} @vindex \TEXT\ -@ref{\TEXT\,,\DISPLAY\,application-big-page,Application Usage} +@ref{\TEXT\,,\DISPLAY\,usage-big-page,Application Usage} @end macro @macro rlsr{TEXT} @@ -229,6 +358,46 @@ @ref{\TEXT\,,\DISPLAY\,notation,Notation Reference} @end macro +@macro rchanges{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,changes,Changes} +@end macro + +@macro rchangesnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@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} +@end macro + +@macro rcontribnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,contributor,Contributor's Guide} +@end macro + +@macro rweb{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,web,General Information} +@end macro + +@macro rwebnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,web,General Information} +@end macro + @macro ressay{TEXT} @vindex \TEXT\ @ref{\TEXT\,,,essay,Essay} @@ -241,12 +410,12 @@ @macro rprogram{TEXT} @vindex \TEXT\ -@ref{\TEXT\,,,application,Application Usage} +@ref{\TEXT\,,,usage,Application Usage} @end macro @macro rprogramnamed{TEXT,DISPLAY} @vindex \TEXT\ -@ref{\TEXT\,,\DISPLAY\,application,Application Usage} +@ref{\TEXT\,,\DISPLAY\,usage,Application Usage} @end macro @macro rlsr{TEXT} @@ -301,6 +470,46 @@ @ref{\TEXT\,,\DISPLAY\,lilypond-notation,Notation Reference} @end macro +@macro rchanges{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-changes,Changes} +@end macro + +@macro rchangesnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@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} +@end macro + +@macro rcontribnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,lilypond-contributor,Contributor's Guide} +@end macro + +@macro rweb{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-web,General Information} +@end macro + +@macro rwebnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,lilypond-web, General Information} +@end macro + @macro ressay{TEXT} @vindex \TEXT\ @ref{\TEXT\,,,lilypond-essay,Essay} @@ -313,12 +522,12 @@ @macro rprogram{TEXT} @vindex \TEXT\ -@ref{\TEXT\,,,lilypond-application,Application Usage} +@ref{\TEXT\,,,lilypond-usage,Application Usage} @end macro @macro rprogramnamed{TEXT,DISPLAY} @vindex \TEXT\ -@ref{\TEXT\,,\DISPLAY\,lilypond-application,Application Usage} +@ref{\TEXT\,,\DISPLAY\,lilypond-usage,Application Usage} @end macro @macro rlsr{TEXT} @@ -357,7 +566,7 @@ @c delimits arguments in the standard way (i.e., with braces). @tex -\gdef\lilyvindex#1{\doind{vr}{\code #1}\ignorespaces} +\gdef\lilyvindex#1{\doind{vr}{\code{#1}}\ignorespaces} @end tex @macro rglos{TEXT} @@ -390,6 +599,46 @@ @ref{\TEXT\,,\DISPLAY\,notation,Notation Reference} @end macro +@macro rchanges{TEXT} +@lilyvindex{\TEXT\} +@ref{\TEXT\,,,changes,Changes} +@end macro + +@macro rchangesnamed{TEXT,DISPLAY} +@lilyvindex{\TEXT\} +@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} +@end macro + +@macro rcontribnamed{TEXT,DISPLAY} +@lilyvindex{\TEXT\} +@ref{\TEXT\,,\DISPLAY\,contributor,Contributor's Guide} +@end macro + +@macro rweb{TEXT} +@lilyvindex{\TEXT\} +@ref{\TEXT\,,,web,General Information} +@end macro + +@macro rwebnamed{TEXT,DISPLAY} +@lilyvindex{\TEXT\} +@ref{\TEXT\,,\DISPLAY\,web,General Information} +@end macro + @macro ressay{TEXT} @lilyvindex{\TEXT\} @ref{\TEXT\,,,essay,Essay} @@ -402,12 +651,12 @@ @macro rprogram{TEXT} @lilyvindex{\TEXT\} -@ref{\TEXT\,,,application,Application Usage} +@ref{\TEXT\,,,usage,Application Usage} @end macro @macro rprogramnamed{TEXT,DISPLAY} @lilyvindex{\TEXT\} -@ref{\TEXT\,,\DISPLAY\,application,Application Usage} +@ref{\TEXT\,,\DISPLAY\,usage,Application Usage} @end macro @macro rlsr{TEXT} @@ -459,7 +708,7 @@ The @qq{X image} is not a registered trademark. It was created by placed under the GNU Free Documentation License version 1.2 or later. We found the image on @uref{http://commons.wikimedia.org/wiki/File:Mac_OS_X_Userbox_X.png, -this Wikipedia Commons page}. +this Wikimedia Commons page}. @end macro @@ -470,7 +719,7 @@ trademark. It was created by placed under the GNU Free Documentation License version 1.2. We found the image on @uref{http://commons.wikimedia.org/wiki/Category:Microsoft_Windows_logos, -this Wikipedia Commons page}. +this Wikimedia Commons page}. @end macro