Documentation/user/macros.itexi

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