Documentation/user/macros.itexi

   1 @c -*- coding: latin-1; mode: texinfo; -*-
   2
   3 @ifnottex
   4   @macro texisharp {word}
   5   #
   6   @end macro
   7   @macro texiflat {word}
   8   b
   9   @end macro
  10 @end ifnottex
  11
  12 @c FIXME, use \fetaaccidentalsXMC?
  13 @c \\kern0.15em\\fetachar\\fetaflat
  14 @iftex
  15  @macro texiflat {word}
  16  @tex
  17  FIXME: fetaflat
  18  @end tex
  19  @end macro
  20 @c FIXME, use \fetaaccidentalsXC?
  21 @c  \\raise0.5ex\\fetachar\\fetasharp
  22  @macro texisharp {word}
  23   @tex
  24   FIXME: fetasharp
  25   @end tex
  26   @end macro
  27 @end iftex
  28
  29
  30 @macro arrow{}
  31 @iftex
  32 @tex $\\Rightarrow$ @end tex@c
  33 @end iftex
  34 @ifhtml
  35 @html
  36 &rarr;
  37 @end html
  38 @end ifhtml
  39 @ifinfo
  40 -->
  41 @end ifinfo
  42 @end macro
  43
  44
  45 @ifhtml
  46 @c ***** HTML *****
  47
  48 @c makeinfo-4.7 encodes html names, which means that nodes that
  49 @c contain nonalphanum characters will be broken links on the website.
  50 @c @uref{../lilypond-internals/\NAME\.html,\NAME\}@c
  51 @c @inforef{} adds ``See'' to the sentence, which is annoying, but
  52 @c better than a broken link.
  53 @c @inforef{\NAME\,,lilypond-internals}@c
  54 @c using @ref without punctuation is OK without for formats other than info
  55
  56 @macro internalsref{NAME}@c
  57 @c annoying parentheses stripped by add-html-footer.py
  58 @ref{\NAME\,,,lilypond-internals}@c
  59 @findex \NAME\
  60 @end macro
  61
  62 @c usage: @inputfileref{input@/regression,FILE@/-NAME.ly}
  63 @macro inputfileref{DIR,NAME}
  64 @uref{source/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c
  65 @end macro
  66
  67 @macro rglos{NAME}@c
  68 @c annoying parentheses stripped by add-html-footer.py
  69 @ref{\NAME\,,,music-glossary}@c
  70 @findex \NAME\
  71 @end macro
  72
  73 @end ifhtml
  74
  75
  76 @ifdocbook
  77 @c ***** DOCBOOK-XML *****
  78
  79 @macro internalsref{NAME}
  80 @ref{\NAME\,,,lilypond-internals}@c
  81 @findex @code{\NAME\}
  82 @end macro
  83
  84 @macro inputfileref{DIR,NAME}
  85 @uref{source/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c
  86 @end macro
  87
  88 @macro rglos{NAME}@c
  89 @ref{\NAME\,,,music-glossary}@c
  90 @findex \NAME\
  91 @end macro
  92
  93 @end ifdocbook
  94
  95
  96 @ifinfo
  97 @c **** INFO ****
  98
  99 @macro internalsref{NAME}
 100 @inforef{\NAME\,,lilypond-internals}@c
 101 @findex \NAME\@c
 102 @end macro
 103
 104 @macro inputfileref{DIR,NAME}
 105 @file{\DIR\/\NAME\}
 106 @end macro
 107
 108 @macro rglos{NAME}@c
 109 @inforef{\NAME\,,,music-glossary}@c
 110 @findex \NAME\
 111 @end macro
 112
 113 @macro usermanref{NAME}
 114 @inforef{\NAME\}@c
 115 @end macro
 116
 117 @end ifinfo
 118
 119
 120 @c **** TEX ****
 121 @iftex
 122
 123 @macro internalsref{NAME}@c
 124 @findex \NAME\ @c
 125 @code{\NAME\}@c
 126 @end macro
 127
 128 @macro inputfileref{DIR,NAME}@c
 129 @file{\DIR\/@/\NAME\}@c
 130 @end macro
 131
 132 @macro rglos {NAME}
 133 @findex \NAME\ @c
 134 @code{\NAME\}@c
 135 @end macro
 136
 137 @macro seeinternals{NAME}
 138 internals document, @internalsref{\NAME\}
 139 @end macro
 140
 141 @macro usermanref{NAME}
 142 user manual, @internalsref{\NAME\}
 143 @end macro
 144
 145 @end iftex
 146
 147 @ifnottex
 148 @c **** not TEX ****
 149
 150 @macro seeinternals{NAME}
 151 @internalsref{\NAME\}
 152 @end macro
 153
 154 @ifnotinfo
 155 @macro usermanref{NAME}
 156 @ref{\NAME\}@c
 157 @end macro
 158 @end ifnotinfo
 159
 160 @end ifnottex
 161
 162 @macro refbugs
 163 @noindent
 164 @subsubheading Bugs
 165
 166 @end macro
 167
 168 @macro seealso
 169 @noindent
 170 @subsubheading See also
 171
 172 @end macro
 173
 174 @macro refcommands
 175 @noindent
 176 @subsubheading Predefined commands
 177
 178 @end macro
 179
 180 @macro context{NAME}@c
 181 @code{\NAME\}@c should use internalsref
 182 @findex \NAME\@c
 183 @end macro
 184
 185 @macro refcommand{WHAT}
 186 @findex \WHAT\
 187 @code{\WHAT\}
 188 @end macro
 189
 190 @macro commonprop
 191 @noindent
 192 @subsubheading Commonly tweaked properties
 193
 194 @end macro
 195