From 42f88322b29251cb42a83008f2e5816510587407 Mon Sep 17 00:00:00 2001 From: hanwen Date: Sun, 24 Oct 2004 00:05:11 +0000 Subject: [PATCH] * Documentation/user/macros.itexi: use findex functions/internals objects. * scm/documentation-generate.scm (string-append): add syncodeindex * Documentation/user/tutorial.itely (A lead sheet): use \chords for tutoring chord names. * Documentation/user/lilypond.tely: remove @authors. --- ChangeLog | 18 ++++++++++-- Documentation/topdocs/NEWS.texi | 2 +- Documentation/user/invoking.itely | 12 ++++---- Documentation/user/lilypond.tely | 13 ++++++--- Documentation/user/macros.itexi | 20 ++++++------- Documentation/user/notation-appendices.itely | 13 ++++----- Documentation/user/point-and-click.itely | 8 ++++++ Documentation/user/preface.itely | 8 +++--- Documentation/user/tutorial.itely | 30 ++++++++++---------- 9 files changed, 75 insertions(+), 49 deletions(-) diff --git a/ChangeLog b/ChangeLog index ea244126a6..bbc18b4180 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,15 @@ +2004-10-24 Han-Wen Nienhuys + + * Documentation/user/macros.itexi: use findex functions/internals + objects. + + * scm/documentation-generate.scm (string-append): add syncodeindex + + * Documentation/user/tutorial.itely (A lead sheet): use \chords + for tutoring chord names. + + * Documentation/user/lilypond.tely: remove @authors. + 2004-10-23 Werner Lemberg * scm/framework-tex.scm (dump-page): Add width to \lybox call. @@ -14,6 +26,8 @@ 2004-10-23 Han-Wen Nienhuys + * VERSION (PACKAGE_NAME): release 2.3.23 + * scm/framework-tex.scm (convert-to-ps): add -E if filename contains .preview. @@ -27,7 +41,7 @@ * Documentation/user/macros.itexi: add \global to definitions for feta macros. - * po/fr.po (Module): updated po file. + * po/fr.po: updated po file. * po/de.po: updated po file. @@ -172,7 +186,7 @@ * Documentation/user/notation.itely: Minor corrections. * Documentation/user/tutorial.itely: Minor corrections. - + 2004-10-11 Jan Nieuwenhuizen * scm/framework-ps.scm (page-header): Fix Layout renaming bug. diff --git a/Documentation/topdocs/NEWS.texi b/Documentation/topdocs/NEWS.texi index 238d845fb1..43b797fa53 100644 --- a/Documentation/topdocs/NEWS.texi +++ b/Documentation/topdocs/NEWS.texi @@ -4,7 +4,7 @@ @node Top, , , @top -@unnumbered New features in 2.3 since 2.2 +@unnumbered New features in 2.4 since 2.2 @itemize @bullet @item @code{\bookpaper} and @code{\paper} have been renamed to diff --git a/Documentation/user/invoking.itely b/Documentation/user/invoking.itely index 1d0f91e29c..aea9bc682d 100644 --- a/Documentation/user/invoking.itely +++ b/Documentation/user/invoking.itely @@ -352,15 +352,15 @@ installation instructions. @item JEdit -There exists a plugin for @uref{http://www.jedit.org/,jEdit}. Refer to -the @uref{http://lily4jedit.sourceforge.net,plugin website} for more -information. +The @uref{http://www.jedit.org/,jEdit} editor has a LilyPond plugin. +This plugin includes a DVI viewer, integrated help and viewing via +GhostScript. It can be installed by doing @key{Plugins > Plugin +Manager}, and selecting @code{LilyTool} from the @key{Install} tab. @end table -For both VIM and Emacs editors, there is also a facility to jump in -the input file to the source of errors in the graphical output. See -@ref{Point and click}. +All these editors can be made to jump in the input file to the source +of a symbol in the graphical output. See @ref{Point and click}. diff --git a/Documentation/user/lilypond.tely b/Documentation/user/lilypond.tely index 26c5a43c55..23124387e4 100644 --- a/Documentation/user/lilypond.tely +++ b/Documentation/user/lilypond.tely @@ -84,13 +84,17 @@ PostScript} and @uref{../lilypond.pdf,PDF}. @end ifhtml +@syncodeindex fn cp +@syncodeindex ky cp +@syncodeindex pg cp +@syncodeindex tp cp +@syncodeindex vr cp + + @titlepage @title GNU LilyPond @subtitle The music typesetter -@author Han-Wen Nienhuys -@author Jan Nieuwenhuizen -@author J@"{u}rgen Reuter -@author Rune Zedeler +@author The LilyPond development team @@ -111,6 +115,7 @@ Copyright @copyright{} 1999--2004 by the authors \score { \context Lyrics { \override Score.RehearsalMark #'self-alignment-X = #LEFT + \override Score.RehearsalMark #'font-size = #-2 \mark #(ly:export (string-append "(For LilyPond version " (lilypond-version) ")")) s2 diff --git a/Documentation/user/macros.itexi b/Documentation/user/macros.itexi index 4cf09a6c6b..703546a688 100644 --- a/Documentation/user/macros.itexi +++ b/Documentation/user/macros.itexi @@ -75,7 +75,7 @@ @c using @ref without punctuation is OK without for formats other than info @ref{\NAME\,,,lilypond-internals}@c @c should we do this? -@cindex @code{\NAME\} +@findex \NAME\ @end macro @c what is this? -- jcn @@ -85,7 +85,7 @@ @c should we do this? @c using @ref without punctuation is OK without for formats other than info @ref{\NODENAME\,,\NAME\,lilypond-internals}@c - @cindex @code{\NAME\} + @findex \NAME\ @end macro @macro inputfileref{DIR,NAME} @@ -104,14 +104,14 @@ @c @uref{../lilypond-internals/\NAME\.html,\NAME\}@c @inforef{\NAME\,,lilypond-internals}@c @c should we do this? - @cindex @code{\NAME\} + @findex @code{\NAME\} @end macro @macro hyphenatedinternalsref{NAME,NODENAME} @c @uref{../lilypond-internals/\NODENAME\.html,\NAME\}@c @inforef{\NODENAME\,,lilypond-internals}@c @c should we do this? - @cindex @code{\NAME\} + @findex @code{\NAME\} @end macro @macro inputfileref{DIR,NAME} @@ -125,14 +125,14 @@ @c **** INFO **** @macro internalsref{NAME} @inforef{\NAME\,,lilypond/lilypond-internals}@c -@cindex \NAME\@c +@findex \NAME\@c @end macro @macro hyphenatedinternalsref{NAME,NODENAME} @c FIXME: suspicious info file name? @inforef{\NODENAME\,,lilypond-internals}@c @c should we do this? -@cindex @code{\NAME\} +@findex @code{\NAME\} @end macro @macro inputfileref{DIR,NAME} @@ -150,7 +150,7 @@ @c **** TEX **** @macro internalsref{NAME}@c -@cindex @code{\NAME\} @c +@findex \NAME\ @c @code{\NAME\}@c @end macro @@ -205,7 +205,7 @@ internals document, @internalsref{\NAME\} @macro context{NAME}@c @code{\NAME\}@c should use internalsref -@cindex \NAME\@c +@findex \NAME\@c @end macro @@ -218,6 +218,6 @@ internals document, @internalsref{\NAME\} @c --hwn @macro refcommand{WHAT} -@cindex @code{\WHAT\} -@code{\WHAT\}, +@findex \WHAT\ +@code{\WHAT\} @end macro diff --git a/Documentation/user/notation-appendices.itely b/Documentation/user/notation-appendices.itely index 11ceaa4bdb..2222741bf7 100644 --- a/Documentation/user/notation-appendices.itely +++ b/Documentation/user/notation-appendices.itely @@ -8,8 +8,6 @@ * Chord name chart:: * MIDI instruments:: * The Feta font:: -* All context properties:: -* Layout properties:: @end menu @@ -88,15 +86,16 @@ accessed directly using text markup such as @code{g^\markup @{ @lilypondfile[noindent]{parmesan16list.ly} - +@ignore @node All context properties -@appendixsec All context properties +@a ppendixsec All context properties -@include context-properties.tely +@i nclude context-properties.tely @node Layout properties -@appendixsec Layout properties +@ap pendixsec Layout properties -@include layout-properties.tely +@in clude layout-properties.tely +@end ignore diff --git a/Documentation/user/point-and-click.itely b/Documentation/user/point-and-click.itely index f099513e4b..b201ab5e0e 100644 --- a/Documentation/user/point-and-click.itely +++ b/Documentation/user/point-and-click.itely @@ -29,6 +29,7 @@ running, try @code{xdvi -version} or @code{xdvi.bin -version}. @item an editor with a client/server interface (or a lightweight GUI editor): + @cindex editor @itemize @bullet @@ -59,6 +60,13 @@ clone. It is available from @uref{http://www.vim.org}. @cindex GVim @cindex Vim + +@item jEdit. jEdit is an editor written in Java with extensive plug-in +support. The LilyPond plugin for jEdit comes with an DVI +viewer, which is preconfigured for point-and-click. + +@cindex jEdit + @end itemize @end itemize diff --git a/Documentation/user/preface.itely b/Documentation/user/preface.itely index f6c8547357..aaca1f9f49 100644 --- a/Documentation/user/preface.itely +++ b/Documentation/user/preface.itely @@ -49,13 +49,13 @@ Han-Wen and Jan Utrecht/Eindhoven, The Netherlands, July 2002. @menu -* Notes for version 3.0:: +* Notes for version 2.4:: @end menu -@node Notes for version 3.0 -@unnumberedsec Notes for version 3.0 +@node Notes for version 2.4 +@unnumberedsec Notes for version 2.4 -The most important developments in 3.0 are related. In LilyPond 3.0, +The most important developments in 2.4 are related. In LilyPond 2.4 @TeX{} is no longer strictly necessary to engrave music. This is because LilyPond can now also layout pages and determine page breaks. Another notable feature is the syntax, which has been simplified even diff --git a/Documentation/user/tutorial.itely b/Documentation/user/tutorial.itely index 327769a551..2285e684b0 100644 --- a/Documentation/user/tutorial.itely +++ b/Documentation/user/tutorial.itely @@ -654,11 +654,9 @@ notation contexts are created automatically. For more complex pieces, it is best to mark contexts explicitly. This ensures that each fragment gets its own stave. -There are several types of contexts: @code{Staff}, @code{Voice} and -@code{Score} handle melodic notation. Other contexts are also -@code{Lyrics} (for setting lyric texts) and @code{ChordNames} (for -printing chord names). - +There are several types of contexts. @code{Staff}, @code{Voice} and +@code{Score} handle melodic notation, while @code{Lyrics} sets lyric +texts and @code{ChordNames} prints chord names. In terms of syntax, prepending @code{\new} to a music expression creates a bigger music expression. In this way it resembles the minus @@ -1009,6 +1007,8 @@ discussed in @ref{Vocal music}. @cindex chords @cindex chord names +@c TODO: revise this, \chords { } is shorter and more intuitive. + In popular music, it is common to denote accompaniment with chord names. Such chords can be entered like notes, @@ -1020,21 +1020,21 @@ Such chords can be entered like notes, Now each pitch is read as the root of a chord instead of a note. This mode is switched on with @code{\chordmode} - Other chords can be created by adding modifiers after a colon. The following example shows a few common modifiers -@lilypond[quote,verbatim] +@lilypond[quote,verbatim,raggedright] \chordmode { c2 f4:m g4:maj7 gis1:dim7 } @end lilypond For lead sheets, chords are not printed on staves, but as names on a -line of themselves. Hence, we have to override the context with -@code{\new}, rendering the music expression in a @code{ChordNames} -context - -@lilypond[quote,verbatim] - \chordmode { c2 f4.:m g4.:maj7 gis8:dim7 } +line of themselves. This is achieved by using @code{\chords} instead +of @code{\chordmode}. This uses the same syntax as @code{\chordmode}, +but renders the notes in a @code{ChordNames} context, with the +following result. + +@lilypond[quote,verbatim,raggedright] + \chords { c2 f4.:m g4.:maj7 gis8:dim7 } @end lilypond @cindex lead sheet @@ -1043,7 +1043,7 @@ a lead sheet, for example, @example << - \chordmode @{ @emph{chords} @} + \chords @{ @emph{chords} @} @emph{the melody} \addlyrics @{ @emph{the text} @} >> @@ -1052,7 +1052,7 @@ a lead sheet, for example, @lilypond[quote,raggedright] << - \chordmode { r2 c:sus4 f } + \chords { r2 c:sus4 f } \relative { r4 c' \times 2/3 { f g g } \times 2/3 { g4( a2) } -- 2.39.5