Begin simplifying macros.itexi.

[lilypond.git] / Documentation / user / macros.itexi

@c -*- coding: us-ascii; mode: texinfo; -*-
@ignore
    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH

    When revising a translation, copy the HEAD committish of the
    version that you are working on.  See TRANSLATION for details.
@end ignore


@c **** format-independant ****

@c   regions of a doc subsection
@macro refcommands
@noindent
@subsubheading Predefined commands

@end macro

@macro commonprop
@noindent
@subsubheading Commonly tweaked properties

@end macro

@macro seealso
@noindent
@subsubheading See also

@end macro

@macro refbugs
@noindent
@subsubheading Bugs

@end macro


@c  use inside the text
@macro context{NAME}
@vindex \NAME\
@code{\NAME\}@c should use internalsref
@end macro

@macro refcommand{WHAT}
@vindex \WHAT\
@code{\WHAT\}
@end macro

@macro funindex {WORD}
@findex \WORD\
@kindex \WORD\
@end macro



@c  *** Macros with variable output ***

@c   Use inside the text

@c usage: @lsr{ancient,custodes.ly}
@macro lsr{DIR,NAME}
@ifhtml
  @uref{source/input/lsr/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}
@end ifhtml
@ifnothtml
  @file{\DIR\/\NAME\}
@end ifnothtml
@end macro

@macro lsrdir{DIR}
@ifhtml
  @uref{source/input/lsr/\DIR\/collated-files.html,@file{\DIR\}/}
@end ifhtml
@ifnothtml
  @file{\DIR\}
@end ifnothtml
@end macro




@c we need this since @q{\} doesn't work with makeinfo 4.8 --
@c say @q{@value{backslash}} instead
@set backslash \


@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

@ifset bigpage

@macro internalsref{NAME}
@vindex \NAME\
@ref{\NAME\,,,lilypond-internals-big-page}
@end macro

@macro rglos{NAME}
@vindex \NAME\
@ref{\NAME\,,,music-glossary-big-page}
@end macro

@macro rprogram{NAME}
@vindex \NAME\
@ref{\NAME\,,,lilypond-program-big-page}
@end macro

@macro ruser{NAME}
@vindex \NAME\
@ref{\NAME\,,,lilypond-big-page}
@end macro

@macro rlearning{NAME}
@vindex \NAME\
@ref{\NAME\,,,lilypond-learning-big-page}
@end macro

@end ifset


@ifclear bigpage

@macro internalsref{NAME}
@vindex \NAME\
@ref{\NAME\,,,lilypond-internals}
@end macro

@macro rglos{NAME}
@vindex \NAME\
@ref{\NAME\,,,music-glossary}
@end macro

@macro rprogram{NAME}
@vindex \NAME\
@ref{\NAME\,,,lilypond-program}
@end macro

@macro ruser{NAME}
@vindex \NAME\
@ref{\NAME\,,,lilypond}
@end macro

@macro rlearning{NAME}
@vindex \NAME\
@ref{\NAME\,,,lilypond-learning}
@end macro

@end ifclear


@c to get decent quotes in `foo'
@macro q{TEXT}
@html
‘\TEXT\’
@end html
@end macro

@c to get decent quotes in ``foo''
@macro qq{TEXT}
@html
“\TEXT\”
@end html
@end macro

@end ifhtml


@ifdocbook
@c ***** DOCBOOK-XML *****

@macro internalsref{NAME}
@vindex \NAME\
@ref{\NAME\,,,lilypond-internals}
@end macro

@macro rglos{NAME}
@vindex \NAME\
@ref{\NAME\,,,music-glossary}
@end macro

@macro rprogram{NAME}
@vindex \NAME\
@ref{\NAME\,,,lilypond-program}
@end macro

@macro ruser{NAME}
@vindex \NAME\
@ref{\NAME\,,,lilypond}
@end macro

@macro rlearning{NAME}
@vindex \NAME\
@ref{\NAME\,,,lilypond-learning}
@end macro

@c to get decent quotes in `foo'
@c to get decent quotes in `foo'
@macro q{TEXT}
@xml
‘\TEXT\’
@end xml
@end macro

@c to get decent quotes in ``foo''
@macro qq{TEXT}
@xml
“\TEXT\”
@end xml
@end macro

@end ifdocbook


@ifinfo
@c **** INFO ****

@macro internalsref{NAME}
@vindex \NAME\
@inforef{\NAME\,,lilypond-internals}
@end macro

@macro rglos{NAME}
@vindex \NAME\
@inforef{\NAME\,,music-glossary}
@end macro

@macro usermanref{NAME}
@inforef{\NAME\}
@end macro

@macro learningref{NAME}
@inforef{\NAME\}
@end macro

@macro rprogram{NAME}
@vindex \NAME\
@ref{\NAME\,,,lilypond-program}
@end macro

@macro ruser{NAME}
@vindex \NAME\
@ref{\NAME\,,,lilypond}
@end macro

@macro rlearning{NAME}
@vindex \NAME\
@ref{\NAME\,,,lilypond-learning}
@end macro

@c to get decent quotes in `foo'
@c to get decent quotes in `foo'
@macro q{TEXT}
`\TEXT\'
@end macro

@c to get decent quotes in ``foo''
@macro qq{TEXT}
``\TEXT\''
@end macro

@end ifinfo


@c **** TEX ****
@iftex

@macro internalsref{NAME}
@vindex \NAME\
@code{\NAME\}
@end macro

@macro rglos {NAME}
@vindex \NAME\
@code{\NAME\}
@end macro

@macro seeinternals{NAME}
internals document, @internalsref{\NAME\}
@end macro

@macro usermanref{NAME}
user manual, @internalsref{\NAME\}
@end macro

@macro learningref{NAME}
learning manual, @internalsref{\NAME\}
@end macro

@macro rprogram{NAME}
program usage manual, @internalsref{\NAME\}
@end macro

@alias ruser=usermanref
@alias rlearning=learningref

@c to get decent quotes in `foo'
@macro q{TEXT}
`\TEXT\'
@end macro

@c to get decent quotes in ``foo''
@macro qq{TEXT}
``\TEXT\''
@end macro

@end iftex


@ifnottex
@c **** not TEX ****

@macro seeinternals{NAME}
@internalsref{\NAME\}
@end macro

@ifnotinfo
@macro usermanref{NAME}
@ref{\NAME\}
@end macro

@macro learningref{NAME}
@ref{\NAME\}
@end macro
@end ifnotinfo

@end ifnottex


@c EOF