X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Fmacros.itexi;h=68b52bb51368db7ea2bab262a7113c35c66a1276;hb=49beaf3269c52e412285e30de038d8e8078565ab;hp=b7185a03bab9c5d8f9b653e6d0ad4ec0be35bb46;hpb=eeef5f8c434e1acba302e522d219ceb0b249b048;p=lilypond.git diff --git a/Documentation/user/macros.itexi b/Documentation/user/macros.itexi index b7185a03ba..68b52bb513 100644 --- a/Documentation/user/macros.itexi +++ b/Documentation/user/macros.itexi @@ -1,95 +1,204 @@ +@c -*- coding: latin-1; mode: texinfo; -*- + +@ifnottex + @macro texisharp {word} + # + @end macro + @macro texiflat {word} + b + @end macro +@end ifnottex + +@c FIXME, use \fetaaccidentalsXMC? +@c \\kern0.15em\\fetachar\\fetaflat +@iftex + @macro texiflat {word} + @tex + FIXME: fetaflat + @end tex + @end macro +@c FIXME, use \fetaaccidentalsXC? +@c \\raise0.5ex\\fetachar\\fetasharp + @macro texisharp {word} + @tex + FIXME: fetasharp + @end tex + @end macro +@end iftex + + +@macro arrow{} +@iftex +@tex $\\Rightarrow$ @end tex@c +@end iftex +@ifhtml +@html +→ +@end html +@end ifhtml @ifinfo -@macro reng {word} -@ref{ (lilypond-internals)Engraver \word\, \word\ }, +--> +@end ifinfo +@end macro + +@ifhtml +@c ***** HTML ***** + +@c makeinfo-4.7 encodes html names, which means that nodes that +@c contain nonalphanum characters will be broken links on the website. +@c @uref{../lilypond-internals/\NAME\.html,\NAME\}@c +@c @inforef{} adds ``See'' to the sentence, which is annoying, but +@c better than a broken link. +@c @inforef{\NAME\,,lilypond-internals}@c +@c using @ref without punctuation is OK without for formats other than info + +@c annoying parentheses stripped by add-html-footer.py +@macro internalsref{NAME} +@vindex \NAME\ +@ref{\NAME\,,,lilypond-internals} @end macro -@end ifinfo -@ifnotinfo -@macro reng {word} -@ref{ (lilypond-internals)Engraver \word\, \word\ } +@c usage: @inputfileref{input@/regression,FILE@/-NAME.ly} +@macro inputfileref{DIR,NAME} +@uref{source/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c +@end macro +@c annoying parentheses stripped by add-html-footer.py +@macro rglos{NAME} +@vindex \NAME\ +@ref{\NAME\,,,music-glossary} @end macro -@end ifnotinfo + +@end ifhtml +@ifdocbook +@c ***** DOCBOOK-XML ***** -@iftex -@macro separate +@macro internalsref{NAME} +@vindex \NAME\ +@ref{\NAME\,,,lilypond-internals} +@end macro -@tex -\\hbox to\\hsize{\\hfill\\smallrm*\\textrm*\\smallrm*\\hfill} -@end tex +@macro inputfileref{DIR,NAME} +@uref{source/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}} +@end macro +@macro rglos{NAME} +@vindex \NAME\ +@ref{\NAME\,,,music-glossary} @end macro -@end iftex -@c \heartsf was supposed to be filled? +@end ifdocbook -@c center*** is broken? @ifinfo -@macro separate - -@quotation -@quotation -@quotation -@quotation -@quotation -@quotation -*** -@end quotation -@end quotation -@end quotation -@end quotation -@end quotation -@end quotation +@c **** INFO **** + +@macro internalsref{NAME} +@vindex \NAME\ +@inforef{\NAME\,,lilypond-internals} @end macro + +@macro inputfileref{DIR,NAME} +@file{\DIR\/\NAME\} +@end macro + +@macro rglos{NAME}@c +@vindex \NAME\ +@inforef{\NAME\,,,music-glossary} +@end macro + +@macro usermanref{NAME} +@inforef{\NAME\} +@end macro + @end ifinfo -@ifhtml -@macro separate -@html -