Thanks a lot Werner! You caught quite a few things I should have dealt with more rigorously.
https://codereview.appspot.com/357930043/diff/20001/Documentation/notation/text.itely File Documentation/notation/text.itely (right): https://codereview.appspot.com/357930043/diff/20001/Documentation/notation/text.itely#newcode50 Documentation/notation/text.itely:50: @cindex Text objects On 2019/01/21 06:18:35, lemzwerg wrote:
Any specific reason why you use uppercase? Wouldn't
@cindex text objects
be sufficient?
Done. https://codereview.appspot.com/357930043/diff/20001/Documentation/notation/text.itely#newcode51 Documentation/notation/text.itely:51: @cindex Markup objects On 2019/01/21 06:18:35, lemzwerg wrote:
BTW, I think you should also add
@cindex objects, markup
for completeness.
Done. https://codereview.appspot.com/357930043/diff/20001/Documentation/notation/text.itely#newcode63 Documentation/notation/text.itely:63: On 2019/01/21 06:18:35, lemzwerg wrote:
Grammatical nitpick: If you have a list of items, either do
Yes. I hesitated between the two, since I’m already using semi-colons before "see also" (I was reluctant to add another just afterwards). On the other hand, since the introductory sentence ends with a colon, all that follows is clearly part of the same sentence. Oh well.
* Frob nicate.
Didn’t know that one, thanks :-) https://codereview.appspot.com/357930043/diff/20001/Documentation/notation/text.itely#newcode82 Documentation/notation/text.itely:82: in any definition inside the @code{\header} block (e.g. On 2019/01/21 06:18:35, lemzwerg wrote:
Mid-sentence abbreviations that end with a full dot should have a
trailing '@:'
to get correct whitespace. In this case, however, I would write
'e.g.,' Done. https://codereview.appspot.com/357930043/diff/20001/Documentation/notation/text.itely#newcode83 Documentation/notation/text.itely:83: @var{title}, @var{subtitle}, @var{composer}), or in some On 2019/01/21 06:18:35, lemzwerg wrote:
s/@var/@code/
Those header block elements are not variable
Hm… You’re right. But they’re not really properties either (not in the sense of music-props or context-props. I’m gonna write "specific elements defined inside the @code{\paper} block". https://codereview.appspot.com/357930043/diff/20001/Documentation/notation/text.itely#newcode85 Documentation/notation/text.itely:85: @var{evenHeaderMarkup} for page numbers. This is explained in On 2019/01/21 06:18:35, lemzwerg wrote:
Ditto.
Right; I ought to remember that @var is not for variables. https://codereview.appspot.com/357930043/diff/20001/Documentation/notation/text.itely#newcode89 Documentation/notation/text.itely:89: @noindent On 2019/01/21 06:18:35, lemzwerg wrote:
I don't see a necessity for '@noindent'. You actually start a new
paragraph,
don't you?
I guess you could see it that way (and it actually makes more sense). In my view, I was prolonging the list (and ditto below) by mentioning _other_ places where \markup may be used. But you’re right, splitting into new paragraphs is cleaner. https://codereview.appspot.com/357930043/diff/20001/Documentation/notation/text.itely#newcode119 Documentation/notation/text.itely:119: @noindent On 2019/01/21 06:18:35, lemzwerg wrote:
Ditto.
Done. https://codereview.appspot.com/357930043/diff/20001/Documentation/notation/text.itely#newcode122 Documentation/notation/text.itely:122: @var{text} property if it has one, or its @var{stencil} property. Some of On 2019/01/21 06:18:35, lemzwerg wrote:
s/@var/@code/
Done. https://codereview.appspot.com/357930043/diff/20001/Documentation/notation/text.itely#newcode148 Documentation/notation/text.itely:148: \once \override NoteHead.text = \markup \lower #0.5 "NoteHead" On 2019/01/21 06:18:35, lemzwerg wrote:
Please check the PDF output; I guess that some lines in your example
are too
wide.
Done. https://codereview.appspot.com/357930043/diff/20001/Documentation/notation/text.itely#newcode641 Documentation/notation/text.itely:641: Extentind LilyPond: On 2019/01/21 06:18:35, lemzwerg wrote:
s/Extentind/Extending/
Oh, dear. https://codereview.appspot.com/357930043/ _______________________________________________ lilypond-devel mailing list lilypond-devel@gnu.org https://lists.gnu.org/mailman/listinfo/lilypond-devel