From: Graham Percival Date: Thu, 11 Feb 2010 00:48:23 +0000 (+0000) Subject: Doc: resolve various FIXMEs. X-Git-Tag: release/2.13.13-1~8 X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=efdc514b7a7357d67c6e0f3927c38b70d645f9c7;p=lilypond.git Doc: resolve various FIXMEs. Downgrading a FIXME to a TODO is still a "resolution". Of a sort. --- diff --git a/Documentation/essay/literature.itely b/Documentation/essay/literature.itely index 2ebc7a300d..79238d0f59 100644 --- a/Documentation/essay/literature.itely +++ b/Documentation/essay/literature.itely @@ -13,7 +13,7 @@ @node Literature list @chapter Literature list -FIXME: blah +Here are lists of references used in LilyPond. @menu * Short literature list:: diff --git a/Documentation/included/compile.itexi b/Documentation/included/compile.itexi index 9a47a9e358..c124b84d2f 100644 --- a/Documentation/included/compile.itexi +++ b/Documentation/included/compile.itexi @@ -315,10 +315,9 @@ make help @noindent from every directory in the build tree. Most targets for -documentation maintenance are available from @file{Documentation/}; -@c FIXME: xref to CG -for more information, see the Contributor's Guide, section -@emph{Documentation work}. +documentation maintenance are available from +@file{Documentation/}. For more information, see +@rcontrib{Documentation work}. The makefile variable @code{QUIET_BUILD} may be set to @code{1} for a less verbose build output, just like for building the programs. diff --git a/Documentation/included/generating-output.itexi b/Documentation/included/generating-output.itexi index 5b725ecf39..240d7749b8 100644 --- a/Documentation/included/generating-output.itexi +++ b/Documentation/included/generating-output.itexi @@ -1,5 +1,6 @@ @c -*- coding: utf-8; mode: texinfo; -*- -@c This file is part of FIXME +@c This file is part of web/download.itexi and +@c learning/tutorial.itely @c This is about "compiling" a lilypond file @c (Learning 1 Tutorial), **not** compiling the diff --git a/Documentation/included/helpus.itexi b/Documentation/included/helpus.itexi index b850e9066d..8386924feb 100644 --- a/Documentation/included/helpus.itexi +++ b/Documentation/included/helpus.itexi @@ -1,5 +1,6 @@ @c -*- coding: utf-8; mode: texinfo; -*- -@c This file is part of FIXME +@c This file is part of web/community.itexi and +@c contributor/introduction.itely @macro helpusNeed @subheading We need you! diff --git a/Documentation/notation/changing-defaults.itely b/Documentation/notation/changing-defaults.itely index 94899d1e0e..10b26405b6 100644 --- a/Documentation/notation/changing-defaults.itely +++ b/Documentation/notation/changing-defaults.itely @@ -2979,7 +2979,7 @@ The locations of the end-points of the spanner are computed on-the-fly for every graphic object, but it is possible to override these: -@c FIXME Complete +@c TODO Complete @lilypond[relative=2,ragged-right,verbatim,fragment] e2 \glissando f \once \override Glissando #'(bound-details right Y) = #-2 @@ -3411,7 +3411,7 @@ e @node Vertical grouping of grobs @subsection Vertical grouping of grobs -@c FIXME Expand this section +@c TODO Expand this section The VerticalAlignment and VerticalAxisGroup grobs work together. VerticalAxisGroup groups together different grobs like Staff, Lyrics, diff --git a/Documentation/notation/spacing.itely b/Documentation/notation/spacing.itely index 2003bff181..9a5a7bea28 100644 --- a/Documentation/notation/spacing.itely +++ b/Documentation/notation/spacing.itely @@ -554,7 +554,7 @@ increased by one. Default: @code{##f}. @ignore -FIXME: this variable is used, but I don't know what it does. -pm +TODO: this variable is used, but I don't know what it does. -pm @item blank-after-score-page-force @funindex blank-after-score-page-force diff --git a/Documentation/notation/vocal.itely b/Documentation/notation/vocal.itely index 44f4b8c8aa..34c3f764ef 100644 --- a/Documentation/notation/vocal.itely +++ b/Documentation/notation/vocal.itely @@ -156,7 +156,7 @@ Notation Reference: @cindex spaces, in lyrics @cindex quotes, in lyrics -@c FIXME: this section is to be rewritten. +@c TODO: this section is to be rewritten. Since LilyPond input files are text, there is at least one issue to consider when working with vocal music: song texts must be interpreted as text, not notes. For example, the @@ -301,7 +301,7 @@ Internals Reference: @rinternals{LyricSpace}. -@c FIXME: this title has to be changed (possible confusion with LM) -vv +@c TODO: this title has to be changed (possible confusion with LM) -vv @node Setting simple songs @unnumberedsubsubsec Setting simple songs @@ -395,7 +395,7 @@ The final input would resemble @end example @ignore -@c FIXME +@c TODO http://code.google.com/p/lilypond/issues/detail?id=329 The problem cannot be reproduced. The following has no sense, because the issue seems to be fixed. @@ -441,7 +441,7 @@ Internals Reference: @funindex \addlyrics @funindex \lyricsto -@c FIXME: this stuff is to be rewritten. -vv +@c TODO: this stuff is to be rewritten. -vv Aligning of text with melodies can be made automatically, but if you specify the durations of the syllables it can also be made manually. @@ -646,7 +646,7 @@ single syllable; such vocalises are called melismas, or melismata. You can define melismata entirely in the lyrics, by entering @code{_} for every extra note that has to be added to the melisma. -@c FIXME: clarify: __ is used to crate a lyric extender, +@c TODO: clarify: __ is used to crate a lyric extender, @c _ is used to add a note to a melisma, so both __ and _ are needed. @c verbose! --FV @@ -803,7 +803,7 @@ TBC @node Specific uses of lyrics @subsection Specific uses of lyrics -@c FIXME This whole section is to be reorganized. -vv +@c TODO This whole section is to be reorganized. -vv Often, different stanzas of one song are put to one melody in slightly differing ways. Such variations can still be captured with @@ -1214,7 +1214,7 @@ This is achieved with Here, @code{alternative} is the name of the @code{Voice} context containing the triplet. -@c FIXME: make this easier to understand -vv +@c TODO: make this easier to understand -vv This command must be one syllable too early, before @q{Ty} in this case. In other words, changing the associatedVoice happens one step later than expected. This is for technical reasons, and it is not a diff --git a/Documentation/usage/external.itely b/Documentation/usage/external.itely index 3f70d971bb..49fd542f8f 100644 --- a/Documentation/usage/external.itely +++ b/Documentation/usage/external.itely @@ -13,8 +13,7 @@ @node External programs @chapter External programs -FIXME: blah blah - +LilyPond can interact with other programs in various ways. @menu * Point and click:: @@ -579,7 +578,11 @@ lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png myfile.ly @node Independent includes @section Independent @code{include}s -FIXME: blah blah +Some people have written large (and useful!) code that can be +shared between projects. This code might eventually make its way +into LilyPond itself, but until that happens, you must download +and @code{\include} them manually. + @menu * MIDI articulation:: @@ -589,6 +592,6 @@ FIXME: blah blah @node MIDI articulation @subsection MIDI articulation -stub for info about Dr. Peter Chubb's @file{articulate.ly} +TODO stub for info about Dr. Peter Chubb's @file{articulate.ly}