NAME = documentation
LANGS = $(shell $(PYTHON) $(top-src-dir)/python/langdefs.py)
-MANUALS_SUBDIRS = application contributor learning notation
+MANUALS_SUBDIRS = application contributor essay learning notation
SUBDIRS = $(MANUALS_SUBDIRS) snippets bibliography pictures misc po $(LANGS)
STEPMAKE_TEMPLATES = documentation texinfo tex omf
LOCALSTEPMAKE_TEMPLATES = lilypond ly
@end ifnottex
@menu
+* Music engraving::
+* Literature list::
* GNU Free Documentation License:: License of this document.
* LilyPond index::
@end menu
@contents
-@c Insert the essay text here
+@include essay/engraving.itely
+@include essay/literature.itely
@include fdl.itexi
--- /dev/null
+depth = ../..
+
+LOCALSTEPMAKE_TEMPLATES = ly
+
+include $(depth)/make/stepmake.make
--- /dev/null
+@c -*- coding: utf-8; 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 \version "2.12.0"
+
+@node Music engraving
+@chapter Music engraving
+
+insert essay here.
+
+TODO: add extra chapter for computer aesthetics?
+
--- /dev/null
+@c -*- coding: utf-8; 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 \version "2.12.0"
+
+@node Literature list
+@chapter Literature list
+
+If you need to know more about music notation, here are some
+interesting titles to read.
+
+
+
+@table @cite
+@item Ignatzek 1995
+Klaus Ignatzek, Die Jazzmethode für Klavier. Schott's Söhne
+1995. Mainz, Germany ISBN 3-7957-5140-3.
+
+A tutorial introduction to playing Jazz on the piano. One of the first
+chapters contains an overview of chords in common use for Jazz music.
+
+@item Gerou 1996
+
+Tom Gerou and Linda Lusk, Essential Dictionary of Music
+Notation. Alfred Publishing, Van Nuys CA ISBN 0-88284-768-6.
+
+A concise, alphabetically ordered list of typesetting and music
+(notation) issues, covering most of the normal cases.
+
+@item Read 1968
+Gardner Read, Music Notation: A Manual of Modern Practice.
+Taplinger Publishing, New York (2nd edition).
+
+A standard work on music notation.
+
+@item Ross 1987
+Ted Ross, Teach yourself the art of music engraving and processing.
+Hansen House, Miami, Florida 1987.
+
+This book is about music engraving, i.e., professional typesetting.
+It contains directions on stamping, use of pens and notational
+conventions. The sections on reproduction technicalities and history
+are also interesting.
+
+@item Schirmer 2001
+The G.Schirmer/AMP Manual of Style and Usage. G.Schirmer/AMP, NY, 2001.
+(This book can be ordered from the rental department.)
+
+This manual specifically focuses on preparing print for publication by
+Schirmer. It discusses many details that are not in other, normal
+notation books. It also gives a good idea of what is necessary to bring
+printouts to publication quality.
+
+@item Stone 1980
+
+Kurt Stone, Music Notation in the Twentieth Century.
+Norton, New York 1980.
+
+This book describes music notation for modern serious music, but
+starts out with a thorough overview of existing traditional notation
+practices.
+
+@end table
+
+The source archive includes a more elaborate Bib@TeX{} bibliography of
+over 100 entries in
+@ifhtml
+@ifset bigpage
+@uref{../bibliography/index.html, the bibliography}.
+@end ifset
+@ifclear bigpage
+@uref{../../bibliography/index.html, the bibliography}.
+@end ifclear
+@end ifhtml
+@ifnothtml
+@file{Documentation/@/bibliography/}.
+@end ifnothtml
+
@c @rglos
@c @rlearning
@c @ruser
+@c @ressay
@c @rprogram
@c @rlsr
@c @rinternals
@ref{\TEXT\,,\DISPLAY\,notation-big-page,Notation Reference}
@end macro
+@macro ressay{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,essay-big-page,Essay}
+@end macro
+
+@macro ressaynamed{TEXT,DISPLAY}
+@vindex \TEXT\
+@ref{\TEXT\,,\DISPLAY\,essay-big-page,Essay}
+@end macro
+
@macro rprogram{TEXT}
@vindex \TEXT\
@ref{\TEXT\,,,application-big-page,Application Usage}
@ref{\TEXT\,,\DISPLAY\,notation,Notation Reference}
@end macro
+@macro ressay{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,essay,Essay}
+@end macro
+
+@macro ressaynamed{TEXT,DISPLAY}
+@vindex \TEXT\
+@ref{\TEXT\,,\DISPLAY\,essay,Essay}
+@end macro
+
@macro rprogram{TEXT}
@vindex \TEXT\
@ref{\TEXT\,,,application,Application Usage}
@ref{\TEXT\,,\DISPLAY\,lilypond-notation,Notation Reference}
@end macro
+@macro ressay{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-essay,Essay}
+@end macro
+
+@macro ressaynamed{TEXT,DISPLAY}
+@vindex \TEXT\
+@ref{\TEXT\,,\DISPLAY\,lilypond-essay,Essay}
+@end macro
+
@macro rprogram{TEXT}
@vindex \TEXT\
@ref{\TEXT\,,,lilypond-application,Application Usage}
@ref{\TEXT\,,\DISPLAY\,notation,Notation Reference}
@end macro
+@macro ressay{TEXT}
+@lilyvindex{\TEXT\}
+@ref{\TEXT\,,,essay,Essay}
+@end macro
+
+@macro ressaynamed{TEXT,DISPLAY}
+@lilyvindex{\TEXT\}
+@ref{\TEXT\,,\DISPLAY\,essay,Essay}
+@end macro
+
@macro rprogram{TEXT}
@lilyvindex{\TEXT\}
@ref{\TEXT\,,,application,Application Usage}
Appendices
-* Literature list:: Reference works about music notation.
* Notation manual tables:: Tables and charts.
* Cheat sheet:: Summary of LilyPond syntax.
* LilyPond grammar:: Syntax diagram for LilyPond parser.
* LilyPond index::
@end menu
@end ifnottex
+@c * Literature list:: Reference works about music notation.
@contents
@include notation/programming-interface.itely
-@include notation/literature.itely
+@c @include notation/literature.itely
@include notation/notation-appendices.itely
@include notation/cheatsheet.itely
@cindex chords, jazz
The basic chord name layout is a system for Jazz music, proposed
-by Klaus Ignatzek (see @ref{Literature list}). The chord naming
+by Klaus Ignatzek (see @ressay{Literature list}). The chord naming
system can be modified as described below. An alternate jazz
chord system has been developed using these modifications.
The Ignatzek and alternate
+++ /dev/null
-@c -*- coding: utf-8; 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 \version "2.12.0"
-
-@node Literature list
-@appendix Literature list
-
-If you need to know more about music notation, here are some
-interesting titles to read.
-
-
-
-@table @cite
-@item Ignatzek 1995
-Klaus Ignatzek, Die Jazzmethode für Klavier. Schott's Söhne
-1995. Mainz, Germany ISBN 3-7957-5140-3.
-
-A tutorial introduction to playing Jazz on the piano. One of the first
-chapters contains an overview of chords in common use for Jazz music.
-
-@item Gerou 1996
-
-Tom Gerou and Linda Lusk, Essential Dictionary of Music
-Notation. Alfred Publishing, Van Nuys CA ISBN 0-88284-768-6.
-
-A concise, alphabetically ordered list of typesetting and music
-(notation) issues, covering most of the normal cases.
-
-@item Read 1968
-Gardner Read, Music Notation: A Manual of Modern Practice.
-Taplinger Publishing, New York (2nd edition).
-
-A standard work on music notation.
-
-@item Ross 1987
-Ted Ross, Teach yourself the art of music engraving and processing.
-Hansen House, Miami, Florida 1987.
-
-This book is about music engraving, i.e., professional typesetting.
-It contains directions on stamping, use of pens and notational
-conventions. The sections on reproduction technicalities and history
-are also interesting.
-
-@item Schirmer 2001
-The G.Schirmer/AMP Manual of Style and Usage. G.Schirmer/AMP, NY, 2001.
-(This book can be ordered from the rental department.)
-
-This manual specifically focuses on preparing print for publication by
-Schirmer. It discusses many details that are not in other, normal
-notation books. It also gives a good idea of what is necessary to bring
-printouts to publication quality.
-
-@item Stone 1980
-
-Kurt Stone, Music Notation in the Twentieth Century.
-Norton, New York 1980.
-
-This book describes music notation for modern serious music, but
-starts out with a thorough overview of existing traditional notation
-practices.
-
-@end table
-
-The source archive includes a more elaborate Bib@TeX{} bibliography of
-over 100 entries in
-@ifhtml
-@ifset bigpage
-@uref{../bibliography/index.html, the bibliography}.
-@end ifset
-@ifclear bigpage
-@uref{../../bibliography/index.html, the bibliography}.
-@end ifclear
-@end ifhtml
-@ifnothtml
-@file{Documentation/@/bibliography/}.
-@end ifnothtml
-