Documentation/macros.itexi

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @ignore
   3     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
   4
   5     When revising a translation, copy the HEAD committish of the
   6     version that you are working on.  For details, see the Contributors'
   7     Guide, node Updating translation committishes..
   8 @end ignore
   9
  10
  11 @include version.itexi
  12 @include common-macros.itexi
  13
  14 @ignore
  15 ****************************
  16 MACRO DEFINITIONS GUIDELINES
  17 ****************************
  18
  19 This file should contain macro definitions which are common to all
  20 languages, i.e. all macro definitions which do not contain text that
  21 should be translated (namely text visible in the output).
  22
  23 Macro definitions which contain text that should be translated in
  24 translations should be in macros.itexi.
  25 @end ignore
  26
  27 @c   ***** Displaying text *****
  28
  29 @c To get decent quotes in `foo' and ``foo''.
  30
  31 @macro q{TEXT}
  32 @quoteleft{}\TEXT\@quoteright{}
  33 @end macro
  34
  35 @macro qq{TEXT}
  36 @quotedblleft{}\TEXT\@quotedblright{}
  37 @end macro
  38
  39
  40 @ifhtml
  41
  42 @macro warning{TEXT}
  43 @html
  44 <div class="warning">
  45 @end html
  46 @strong{Note:} \TEXT\
  47 @c keep the space for proper nesting of </p>
  48
  49 @html
  50 </div>
  51 @end html
  52 @end macro
  53
  54 @end ifhtml
  55
  56 @ifnothtml
  57
  58 @macro warning{TEXT}
  59 @quotation
  60 @quotation
  61 @cartouche
  62 @b{Note:} \TEXT\
  63 @end cartouche
  64 @end quotation
  65 @end quotation
  66 @end macro
  67
  68 @end ifnothtml
  69
  70 @c do not translate the following macro -- it is used in
  71 @c an untranslated manual.
  72
  73 @ifhtml
  74
  75 @macro advanced{TEXT}
  76 @html
  77 <div class="advanced">
  78 @end html
  79 @strong{Advanced note:} \TEXT\
  80 @c keep the space for proper nesting of </p>
  81
  82 @html
  83 </div>
  84 @end html
  85 @end macro
  86
  87 @end ifhtml
  88
  89 @ifnothtml
  90
  91 @macro advanced{TEXT}
  92 @quotation
  93 @b{Advanced note:} \TEXT\
  94 @end quotation
  95 @end macro
  96
  97 @end ifnothtml
  98
  99
 100 @macro docMain
 101 @cartouche
 102 For more information about how this manual fits with the other
 103 documentation, or to read this manual in other formats, see
 104 @rweb{Manuals}.
 105
 106 If you are missing any manuals, the complete documentation can be
 107 found at @w{@uref{http://@/lilypond@/.org/}}.
 108 @end cartouche
 109 @end macro
 110
 111
 112 @macro lilyTitlePage{TITLE}
 113 @c  This produces the unified index
 114 @syncodeindex fn cp
 115 @syncodeindex vr cp
 116
 117
 118 @c   ***** Copyright stuff *****
 119 @ifset FDL
 120 @copying
 121 @copyrightDeclare
 122
 123 @quotation
 124 Permission is granted to copy, distribute and/or modify this document
 125 under the terms of the GNU Free Documentation License, Version 1.1
 126 or any later version published by the Free Software Foundation;
 127 with no Invariant Sections.
 128 A copy of the license is included in the section entitled ``GNU
 129 Free Documentation License''.
 130 @end quotation
 131 @end copying
 132 @end ifset
 133
 134 @ifclear FDL
 135 @copying
 136 This document has been placed in the public domain.
 137 @end copying
 138 @end ifclear
 139
 140
 141
 142 @c   ***** Title page *****
 143 @ifnottex
 144 @node Top
 145 @top LilyPond --- \TITLE\
 146
 147 @cartouche
 148 @manualIntro{}
 149 @end cartouche
 150 @end ifnottex
 151
 152 @finalout
 153
 154 @titlepage
 155 @title LilyPond
 156 @subtitle The music typesetter
 157 @titlefont{\TITLE\}
 158 @author The LilyPond development team
 159
 160 @vskip 60pt
 161
 162 @cartouche
 163 @manualIntro{}
 164 @end cartouche
 165
 166 @vskip 40pt
 167
 168 @docMain{}
 169
 170 @vskip 0pt plus 1filll
 171
 172 @insertcopying
 173
 174 For LilyPond version @version{}
 175 @end titlepage
 176
 177 @end macro
 178
 179
 180 @c   ***** Headings in a doc subsection *****
 181
 182 @c The next macro is a dummy currently since texinfo doesn't
 183 @c provide a real ragged-right environment yet.
 184 @c
 185 @c Don't insert an empty line after @predefined!  Right now
 186 @c it doesn't matter, but a future implementation will probably
 187 @c add some code which needs this restriction.
 188
 189 @c @raggedright can be enabled as soon as texinfo 5.x or larger
 190 @c is in use for Gub and LilyDev 3.
 191
 192 @macro predefined
 193 @noindent
 194 @subsubheading Predefined commands
 195 @c @raggedright
 196 @end macro
 197
 198 @c Due to a bug in texi2html (texi2html.pl CVS versions <= 1.245)
 199 @c the next macro must not be empty.
 200
 201 @macro endpredefined
 202 @c @end raggedright
 203 @end macro
 204
 205
 206 @macro snippets
 207 @noindent
 208 @subsubheading Selected Snippets
 209 @end macro
 210
 211
 212 @c Don't insert an empty line after @seealso!  Otherwise we get
 213 @c unwanted extra vertical space in the PDF output.
 214
 215 @macro seealso
 216 @noindent
 217 @subsubheading See also
 218 @indent
 219 @end macro
 220
 221
 222 @macro knownissues
 223 @noindent
 224 @subsubheading Known issues and warnings
 225 @end macro
 226
 227
 228
 229 @c   ***** Links and references *****
 230
 231 @c  Definitions for references:
 232 @c
 233 @c     @rweb
 234 @c     @ressay
 235 @c     @rglos
 236 @c     @rinternals
 237 @c     @rlearning
 238 @c     @rlsr
 239 @c     @rprogram
 240 @c     @ruser
 241 @c     @rchanges
 242 @c     @rextend
 243 @c     @rcontrib
 244 @c
 245 @c  All these also have a @...named version which allows to specify the
 246 @c  displayed text for the reference as second argument.
 247 @c
 248 @c ***** HTML + bigpage is a special case (other manual names); all other
 249 @c formats are treated similarly.
 250
 251
 252 @c *** not TeX ***
 253
 254 @ifnottex
 255
 256 @c ** bigpage **
 257
 258 @ifset bigpage
 259
 260 @macro rglos{TEXT}
 261 @vindex \TEXT\
 262 @ref{\TEXT\,,,music-glossary-big-page,Music Glossary}
 263 @end macro
 264
 265 @macro rglosnamed{TEXT,DISPLAY}
 266 @vindex \TEXT\
 267 @ref{\TEXT\,,\DISPLAY\,music-glossary-big-page,Music Glossary}
 268 @end macro
 269
 270 @macro rlearning{TEXT}
 271 @vindex \TEXT\
 272 @ref{\TEXT\,,,learning-big-page,Learning Manual}
 273 @end macro
 274
 275 @macro rlearningnamed{TEXT,DISPLAY}
 276 @vindex \TEXT\
 277 @ref{\TEXT\,,\DISPLAY\,learning-big-page,Learning Manual}
 278 @end macro
 279
 280 @macro ruser{TEXT}
 281 @vindex \TEXT\
 282 @ref{\TEXT\,,,notation-big-page,Notation Reference}
 283 @end macro
 284
 285 @macro rusernamed{TEXT,DISPLAY}
 286 @vindex \TEXT\
 287 @ref{\TEXT\,,\DISPLAY\,notation-big-page,Notation Reference}
 288 @end macro
 289
 290 @macro rextend{TEXT}
 291 @vindex \TEXT\
 292 @ref{\TEXT\,,,extending-big-page,Extending}
 293 @end macro
 294
 295 @macro rextendnamed{TEXT,DISPLAY}
 296 @vindex \TEXT\
 297 @ref{\TEXT\,,\DISPLAY\,extending-big-page,Extending}
 298 @end macro
 299
 300 @macro rchanges{TEXT}
 301 @vindex \TEXT\
 302 @ref{\TEXT\,,,changes-big-page,Changes}
 303 @end macro
 304
 305 @macro rchangesnamed{TEXT,DISPLAY}
 306 @vindex \TEXT\
 307 @ref{\TEXT\,,\DISPLAY\,changes-big-page,Changes}
 308 @end macro
 309
 310 @macro rcontrib{TEXT}
 311 @vindex \TEXT\
 312 @ref{\TEXT\,,,contributor-big-page,Contributor's Guide}
 313 @end macro
 314
 315 @macro rcontribnamed{TEXT,DISPLAY}
 316 @vindex \TEXT\
 317 @ref{\TEXT\,,\DISPLAY\,contributor-big-page,Contributor's Guide}
 318 @end macro
 319
 320 @macro rweb{TEXT}
 321 @vindex \TEXT\
 322 @ref{\TEXT\,,,web-big-page,General Information}
 323 @end macro
 324
 325 @macro rwebnamed{TEXT,DISPLAY}
 326 @vindex \TEXT\
 327 @ref{\TEXT\,,\DISPLAY\,web-big-page,General Information}
 328 @end macro
 329
 330 @macro ressay{TEXT}
 331 @vindex \TEXT\
 332 @ref{\TEXT\,,,essay-big-page,Essay}
 333 @end macro
 334
 335 @macro ressaynamed{TEXT,DISPLAY}
 336 @vindex \TEXT\
 337 @ref{\TEXT\,,\DISPLAY\,essay-big-page,Essay}
 338 @end macro
 339
 340 @macro rprogram{TEXT}
 341 @vindex \TEXT\
 342 @ref{\TEXT\,,,usage-big-page,Application Usage}
 343 @end macro
 344
 345 @macro rprogramnamed{TEXT,DISPLAY}
 346 @vindex \TEXT\
 347 @ref{\TEXT\,,\DISPLAY\,usage-big-page,Application Usage}
 348 @end macro
 349
 350 @macro rlsr{TEXT}
 351 @ref{\TEXT\,,,snippets-big-page,Snippets}
 352 @end macro
 353
 354 @macro rlsrnamed{TEXT,DISPLAY}
 355 @ref{\TEXT\,,\DISPLAY\,snippets-big-page,Snippets}
 356 @end macro
 357
 358 @macro rinternals{TEXT}
 359 @vindex \TEXT\
 360 @ref{\TEXT\,,,internals-big-page,Internals Reference}
 361 @end macro
 362
 363 @macro rinternalsnamed{TEXT,DISPLAY}
 364 @vindex \TEXT\
 365 @ref{\TEXT\,,\DISPLAY\,internals-big-page,Internals Reference}
 366 @end macro
 367
 368 @end ifset
 369
 370
 371 @c ** not bigpage **
 372
 373 @ifclear bigpage
 374
 375 @ifnotinfo
 376
 377 @macro rglos{TEXT}
 378 @vindex \TEXT\
 379 @ref{\TEXT\,,,music-glossary,Music Glossary}
 380 @end macro
 381
 382 @macro rglosnamed{TEXT,DISPLAY}
 383 @vindex \TEXT\
 384 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
 385 @end macro
 386
 387 @macro rlearning{TEXT}
 388 @vindex \TEXT\
 389 @ref{\TEXT\,,,learning,Learning Manual}
 390 @end macro
 391
 392 @macro rlearningnamed{TEXT,DISPLAY}
 393 @vindex \TEXT\
 394 @ref{\TEXT\,,,learning,Learning Manual}
 395 @end macro
 396
 397 @macro ruser{TEXT}
 398 @vindex \TEXT\
 399 @ref{\TEXT\,,,notation,Notation Reference}
 400 @end macro
 401
 402 @macro rusernamed{TEXT,DISPLAY}
 403 @vindex \TEXT\
 404 @ref{\TEXT\,,\DISPLAY\,notation,Notation Reference}
 405 @end macro
 406
 407 @macro rchanges{TEXT}
 408 @vindex \TEXT\
 409 @ref{\TEXT\,,,changes,Changes}
 410 @end macro
 411
 412 @macro rchangesnamed{TEXT,DISPLAY}
 413 @vindex \TEXT\
 414 @ref{\TEXT\,,\DISPLAY\,changes,Changes}
 415 @end macro
 416
 417 @macro rextend{TEXT}
 418 @vindex \TEXT\
 419 @ref{\TEXT\,,,extending,Extending}
 420 @end macro
 421
 422 @macro rextendnamed{TEXT,DISPLAY}
 423 @vindex \TEXT\
 424 @ref{\TEXT\,,\DISPLAY\,extending,Extending}
 425 @end macro
 426
 427 @macro rcontrib{TEXT}
 428 @vindex \TEXT\
 429 @ref{\TEXT\,,,contributor,Contributor's Guide}
 430 @end macro
 431
 432 @macro rcontribnamed{TEXT,DISPLAY}
 433 @vindex \TEXT\
 434 @ref{\TEXT\,,\DISPLAY\,contributor,Contributor's Guide}
 435 @end macro
 436
 437 @macro rweb{TEXT}
 438 @vindex \TEXT\
 439 @ref{\TEXT\,,,web,General Information}
 440 @end macro
 441
 442 @macro rwebnamed{TEXT,DISPLAY}
 443 @vindex \TEXT\
 444 @ref{\TEXT\,,\DISPLAY\,web,General Information}
 445 @end macro
 446
 447 @macro ressay{TEXT}
 448 @vindex \TEXT\
 449 @ref{\TEXT\,,,essay,Essay}
 450 @end macro
 451
 452 @macro ressaynamed{TEXT,DISPLAY}
 453 @vindex \TEXT\
 454 @ref{\TEXT\,,\DISPLAY\,essay,Essay}
 455 @end macro
 456
 457 @macro rprogram{TEXT}
 458 @vindex \TEXT\
 459 @ref{\TEXT\,,,usage,Application Usage}
 460 @end macro
 461
 462 @macro rprogramnamed{TEXT,DISPLAY}
 463 @vindex \TEXT\
 464 @ref{\TEXT\,,\DISPLAY\,usage,Application Usage}
 465 @end macro
 466
 467 @macro rlsr{TEXT}
 468 @ref{\TEXT\,,,snippets,Snippets}
 469 @end macro
 470
 471 @macro rlsrnamed{TEXT,DISPLAY}
 472 @ref{\TEXT\,,\DISPLAY\,snippets,Snippets}
 473 @end macro
 474
 475 @macro rinternals{TEXT}
 476 @vindex \TEXT\
 477 @ref{\TEXT\,,,internals,Internals Reference}
 478 @end macro
 479
 480 @macro rinternalsnamed{TEXT,DISPLAY}
 481 @vindex \TEXT\
 482 @ref{\TEXT\,,\DISPLAY\,internals,Internals Reference}
 483 @end macro
 484
 485 @end ifnotinfo
 486
 487 @ifinfo
 488
 489 @macro rglos{TEXT}
 490 @vindex \TEXT\
 491 @ref{\TEXT\,,,music-glossary,Music Glossary}
 492 @end macro
 493
 494 @macro rglosnamed{TEXT,DISPLAY}
 495 @vindex \TEXT\
 496 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
 497 @end macro
 498
 499 @macro rlearning{TEXT}
 500 @vindex \TEXT\
 501 @ref{\TEXT\,,,lilypond-learning,Learning Manual}
 502 @end macro
 503
 504 @macro rlearningnamed{TEXT,DISPLAY}
 505 @vindex \TEXT\
 506 @ref{\TEXT\,,,lilypond-learning,Learning Manual}
 507 @end macro
 508
 509 @macro ruser{TEXT}
 510 @vindex \TEXT\
 511 @ref{\TEXT\,,,lilypond-notation,Notation Reference}
 512 @end macro
 513
 514 @macro rusernamed{TEXT,DISPLAY}
 515 @vindex \TEXT\
 516 @ref{\TEXT\,,\DISPLAY\,lilypond-notation,Notation Reference}
 517 @end macro
 518
 519 @macro rchanges{TEXT}
 520 @vindex \TEXT\
 521 @ref{\TEXT\,,,lilypond-changes,Changes}
 522 @end macro
 523
 524 @macro rchangesnamed{TEXT,DISPLAY}
 525 @vindex \TEXT\
 526 @ref{\TEXT\,,\DISPLAY\,lilypond-changes,Changes}
 527 @end macro
 528
 529 @macro rextend{TEXT}
 530 @vindex \TEXT\
 531 @ref{\TEXT\,,,lilypond-extending,Extending}
 532 @end macro
 533
 534 @macro rextendnamed{TEXT,DISPLAY}
 535 @vindex \TEXT\
 536 @ref{\TEXT\,,\DISPLAY\,lilypond-extending,Extending}
 537 @end macro
 538
 539 @macro rcontrib{TEXT}
 540 @vindex \TEXT\
 541 @ref{\TEXT\,,,lilypond-contributor,Contributor's Guide}
 542 @end macro
 543
 544 @macro rcontribnamed{TEXT,DISPLAY}
 545 @vindex \TEXT\
 546 @ref{\TEXT\,,\DISPLAY\,lilypond-contributor,Contributor's Guide}
 547 @end macro
 548
 549 @macro rweb{TEXT}
 550 @vindex \TEXT\
 551 @ref{\TEXT\,,,lilypond-web,General Information}
 552 @end macro
 553
 554 @macro rwebnamed{TEXT,DISPLAY}
 555 @vindex \TEXT\
 556 @ref{\TEXT\,,\DISPLAY\,lilypond-web, General Information}
 557 @end macro
 558
 559 @macro ressay{TEXT}
 560 @vindex \TEXT\
 561 @ref{\TEXT\,,,lilypond-essay,Essay}
 562 @end macro
 563
 564 @macro ressaynamed{TEXT,DISPLAY}
 565 @vindex \TEXT\
 566 @ref{\TEXT\,,\DISPLAY\,lilypond-essay,Essay}
 567 @end macro
 568
 569 @macro rprogram{TEXT}
 570 @vindex \TEXT\
 571 @ref{\TEXT\,,,lilypond-usage,Application Usage}
 572 @end macro
 573
 574 @macro rprogramnamed{TEXT,DISPLAY}
 575 @vindex \TEXT\
 576 @ref{\TEXT\,,\DISPLAY\,lilypond-usage,Application Usage}
 577 @end macro
 578
 579 @macro rlsr{TEXT}
 580 @ref{\TEXT\,,,lilypond-snippets,Snippets}
 581 @end macro
 582
 583 @macro rlsrnamed{TEXT,DISPLAY}
 584 @ref{\TEXT\,,\DISPLAY\,lilypond-snippets,Snippets}
 585 @end macro
 586
 587 @macro rinternals{TEXT}
 588 @vindex \TEXT\
 589 @ref{\TEXT\,,,lilypond-internals,Internals Reference}
 590 @end macro
 591
 592 @macro rinternalsnamed{TEXT,DISPLAY}
 593 @vindex \TEXT\
 594 @ref{\TEXT\,,\DISPLAY\,lilypond-internals,Internals Reference}
 595 @end macro
 596
 597 @end ifinfo
 598
 599 @end ifclear
 600
 601 @end ifnottex
 602
 603
 604 @c *** TeX ***
 605
 606 @iftex
 607
 608 @c All commands below should work in the middle of the line;
 609 @c we thus must not use @vindex directly since it works only if placed
 610 @c on a line of its own.  To overcome this problem, we define a
 611 @c replacement macro using the internal definition of @vindex which
 612 @c delimits arguments in the standard way (i.e., with braces).
 613
 614 @tex
 615 \gdef\lilyvindex#1{\doind{vr}{\code{#1}}\ignorespaces}
 616 @end tex
 617
 618 @macro rglos{TEXT}
 619 @lilyvindex{\TEXT\}
 620 @ref{\TEXT\,,,music-glossary,Music Glossary}
 621 @end macro
 622
 623 @macro rglosnamed{TEXT,DISPLAY}
 624 @lilyvindex{\TEXT\}
 625 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
 626 @end macro
 627
 628 @macro rlearning{TEXT}
 629 @lilyvindex{\TEXT\}
 630 @ref{\TEXT\,,,learning,Learning Manual}
 631 @end macro
 632
 633 @macro rlearningnamed{TEXT,DISPLAY}
 634 @lilyvindex{\TEXT\}
 635 @ref{\TEXT\,,\DISPLAY\,learning,Learning Manual}
 636 @end macro
 637
 638 @macro ruser{TEXT}
 639 @lilyvindex{\TEXT\}
 640 @ref{\TEXT\,,,notation,Notation Reference}
 641 @end macro
 642
 643 @macro rusernamed{TEXT,DISPLAY}
 644 @lilyvindex{\TEXT\}
 645 @ref{\TEXT\,,\DISPLAY\,notation,Notation Reference}
 646 @end macro
 647
 648 @macro rchanges{TEXT}
 649 @lilyvindex{\TEXT\}
 650 @ref{\TEXT\,,,changes,Changes}
 651 @end macro
 652
 653 @macro rchangesnamed{TEXT,DISPLAY}
 654 @lilyvindex{\TEXT\}
 655 @ref{\TEXT\,,\DISPLAY\,changes,Changes}
 656 @end macro
 657
 658 @macro rextend{TEXT}
 659 @lilyvindex{\TEXT\}
 660 @ref{\TEXT\,,,extending,Extending}
 661 @end macro
 662
 663 @macro rextendnamed{TEXT,DISPLAY}
 664 @lilyvindex{\TEXT\}
 665 @ref{\TEXT\,,\DISPLAY\,extending,Extending}
 666 @end macro
 667
 668 @macro rcontrib{TEXT}
 669 @lilyvindex{\TEXT\}
 670 @ref{\TEXT\,,,contributor,Contributor's Guide}
 671 @end macro
 672
 673 @macro rcontribnamed{TEXT,DISPLAY}
 674 @lilyvindex{\TEXT\}
 675 @ref{\TEXT\,,\DISPLAY\,contributor,Contributor's Guide}
 676 @end macro
 677
 678 @macro rweb{TEXT}
 679 @lilyvindex{\TEXT\}
 680 @ref{\TEXT\,,,web,General Information}
 681 @end macro
 682
 683 @macro rwebnamed{TEXT,DISPLAY}
 684 @lilyvindex{\TEXT\}
 685 @ref{\TEXT\,,\DISPLAY\,web,General Information}
 686 @end macro
 687
 688 @macro ressay{TEXT}
 689 @lilyvindex{\TEXT\}
 690 @ref{\TEXT\,,,essay,Essay}
 691 @end macro
 692
 693 @macro ressaynamed{TEXT,DISPLAY}
 694 @lilyvindex{\TEXT\}
 695 @ref{\TEXT\,,\DISPLAY\,essay,Essay}
 696 @end macro
 697
 698 @macro rprogram{TEXT}
 699 @lilyvindex{\TEXT\}
 700 @ref{\TEXT\,,,usage,Application Usage}
 701 @end macro
 702
 703 @macro rprogramnamed{TEXT,DISPLAY}
 704 @lilyvindex{\TEXT\}
 705 @ref{\TEXT\,,\DISPLAY\,usage,Application Usage}
 706 @end macro
 707
 708 @macro rlsr{TEXT}
 709 @lilyvindex{\TEXT\}
 710 @ref{\TEXT\,,,snippets,Snippets}
 711 @end macro
 712
 713 @macro rlsrnamed{TEXT,DISPLAY}
 714 @lilyvindex{\TEXT\}
 715 @ref{\TEXT\,,\DISPLAY\,snippets,Snippets}
 716 @end macro
 717
 718 @macro rinternals{TEXT}
 719 @lilyvindex{\TEXT\}
 720 @ref{\TEXT\,,,internals,Internals Reference}
 721 @end macro
 722
 723 @macro rinternalsnamed{TEXT,DISPLAY}
 724 @lilyvindex{\TEXT\}
 725 @ref{\TEXT\,,\DISPLAY\,internals,Internals Reference}
 726 @end macro
 727
 728 @end iftex
 729
 730 @c  ***** Macros specific to the web site *****
 731
 732 @ifset web
 733
 734 @macro exampleImage{IMAGE-FILE}
 735 @html
 736 <div class="float-center example-image-wrapper">
 737   <a class="clickable" href="ly-examples/\IMAGE-FILE\.png">
 738     <img src="ly-examples/\IMAGE-FILE\-small.png" alt="\IMAGE-FILE\">
 739   </a>
 740   <p style="text-align: center">
 741     (click to enlarge)
 742   </p>
 743 </div>
 744 @end html
 745 @iftex
 746 @image{ly-examples/\IMAGE-FILE\,6in,,\IMAGE-FILE\,png}
 747 @end iftex
 748 @ifinfo
 749 @image{lilypond/ly-examples/\IMAGE-FILE\,,,\IMAGE-FILE\,png}
 750 @end ifinfo
 751 @end macro
 752
 753 @macro help{TEXT}
 754 @html
 755 <div class="help">
 756 <strong>
 757   <span style="text-decoration:blink">Help wanted:</span>
 758 </strong> \TEXT\
 759 </div>
 760 @end html
 761 @end macro
 762
 763
 764 @c LEGALESE
 765
 766 @macro logoLegalLinux
 767 Tux the Linux Penguin was created by
 768 @uref{mailto:lewing@@isc.tamu.edu, lewing@@isc.tamu.edu} with
 769 @uref{http://www.isc.tamu.edu/~lewing/gimp/, the Gnu Image
 770 Manipulation Program}.
 771
 772 @end macro
 773
 774 @macro logoLegalFreeBSD
 775 The FreeBSD logo is a registered trademark of
 776 @uref{http://www.freebsd.org/, The FreeBSD Foundation}.
 777
 778 @end macro
 779
 780 @macro logoLegalMacOSX
 781 The @qq{X image} is not a registered trademark.  It was created by
 782 @uref{http://en.wikipedia.org/wiki/User:Nihonjoe, Nihonjoe} and
 783 @uref{http://en.wikipedia.org/wiki/User:CyberSkull, CyberSkull}, and
 784 placed under the GNU Free Documentation License version 1.2 or later.
 785 We found the image on
 786 @uref{http://commons.wikimedia.org/wiki/File:Mac_OS_X_Userbox_X.png,
 787 this Wikimedia Commons page}.
 788
 789 @end macro
 790
 791 @macro logoLegalWindows
 792 The @qq{four colored rectangles image} is not a registered
 793 trademark.  It was created by
 794 @uref{http://en.wikipedia.org/wiki/User:Rohitbd, Rohitbd} and
 795 placed under the GNU Free Documentation License version 1.2.  We
 796 found the image on
 797 @uref{http://commons.wikimedia.org/wiki/Category:Microsoft_Windows_logos,
 798 this Wikimedia Commons page}.
 799
 800 @end macro
 801
 802 @end ifset