Re: Doc: writing music events to a .notes file. (issue4438054)

[percival . music . ca]

Reviewers: Reinhold, J_lowe,

Message:
thanks, updated.


http://codereview.appspot.com/4438054/diff/1/Documentation/notation/input.itely
File Documentation/notation/input.itely (right):

http://codereview.appspot.com/4438054/diff/1/Documentation/notation/input.itely#newcode2329
Documentation/notation/input.itely:2329: Displaying a music expression
in LilyPond notation can be
On 2011/04/19 11:36:41, J_lowe wrote:
> is the word 'notation' redundant?

I don't think so -- the point is that you'll see a music expression in
that particular format, rather than seeing the music expression written
in scheme.  What's the format?  "lilypond notation".

(note that this part is just a copy&paste, not any new material that I
wrote)

I'm certainly open to fixing it if this part is unclear, though.  Hmm...
what about "LilyPond input notation" ?

http://codereview.appspot.com/4438054/diff/1/Documentation/notation/input.itely#newcode2358
Documentation/notation/input.itely:2358: See @rextend{Displaying music
expressions}.
On 2011/04/19 11:36:41, J_lowe wrote:
> Would this be better as an @seealso? I am guessing there is some more
'stuff' to
> go in here else is there a need for an @node just for this?

Dunno.  One option would be to move the material from scheme-tutorial
into this particular spot, but then that section would just be a ref as
well.

I figure that if we're going to have a node that's just a ref, it might
as well be here, since the actual material is very scheme-heavy.

http://codereview.appspot.com/4438054/diff/1/Documentation/notation/input.itely#newcode2374
Documentation/notation/input.itely:2374: be jumbled together in the same
file.  The output looks like this:
On 2011/04/19 11:36:41, J_lowe wrote:
> is 'jumble' appropriate for non-English Speakers - suggest 'mixed'. :)

done.  :)

http://codereview.appspot.com/4438054/diff/1/Documentation/notation/input.itely#newcode2386
Documentation/notation/input.itely:2386: The syntax is a tab-delimited
line, with at two fixed fields on
On 2011/04/19 11:36:41, J_lowe wrote:
> missing word I think
> ...with at *least* two fixed fields... (?)

Thanks, I removed the "at".  "... with two fixed fields on each
line...".

http://codereview.appspot.com/4438054/diff/1/Documentation/notation/input.itely#newcode2394
Documentation/notation/input.itely:2394: python.  This can be very
useful for researchers wishing to
On 2011/04/19 11:36:41, J_lowe wrote:
> too many 'This.. This...' run on the sentence thus:

> ...such as python, and can be ...

thanks, done.

Description:
Doc: writing music events to a .notes file.

Please review this at http://codereview.appspot.com/4438054/

Affected files:
  M Documentation/notation/input.itely