Doc: NR 3.2.1: clarify titles and \header blocks (2652)

Doc: NR 3.2.1: clarify titles and \header blocks (2652)

 - drop use of "title blocks"
 - make headings consistent
 - explain the two titling areas
 - explain the four positions for \header blocks and their
   hierarchy
 - clarify text in several places

[Graham Percival, 2012-08-27 09:00:23]

LGTM

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

http://codereview.appspot.com/6474066/diff/1/Documentation/notation/input.ite...
Documentation/notation/input.itely:368: A @code{\header} block.  This sets the
global, i.e. book, header
could this be (i.e. book) instead?  I think this is a parenthetical remark
rather than a commatical or comedical one.

http://codereview.appspot.com/6474066/diff/1/Documentation/notation/input.ite...
Documentation/notation/input.itely:554: @ref{Default layout of bookpart and
score titles}).  Both Bookpart
why the capitals for Bookpart, Score, and Titling ?  If you want to distinguish
them, wouldn't @code{bookpart} make more sense?

[Trevor Daniels, 2012-08-27 09:53:08]

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

http://codereview.appspot.com/6474066/diff/1/Documentation/notation/input.ite...
Documentation/notation/input.itely:368: A @code{\header} block.  This sets the
global, i.e. book, header
On 2012/08/27 09:00:23, Graham Percival wrote:

> could this be (i.e. book) instead?

Actually, on looking at this paragraph again, I think it
needs further changes.  It should refer to a top-of-file
\header block, not a book \header block.   I'll redraft
it (and use parentheses :).

http://codereview.appspot.com/6474066/diff/1/Documentation/notation/input.ite...
Documentation/notation/input.itely:554: @ref{Default layout of bookpart and
score titles}).  Both Bookpart
On 2012/08/27 09:00:23, Graham Percival wrote:

> why the capitals for Bookpart, Score, and Titling

I used capitals for Bookpart Titles and Score Titles
to refer to the definitions in the first paragraph.
But I see this sentence is confusing, so I'll reword
it as "Both Bookpart Titles and Score Titles ...".

[Graham Percival, 2012-08-29 09:55:04]

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

http://codereview.appspot.com/6474066/diff/5001/Documentation/notation/input....
Documentation/notation/input.itely:368: A @code{\header} block.  This sets the
global, (i.e. the top of
The combination of a parenthetical comment and a commatical comment seems quite
comedic.  Could I convince you to remove the commas?

[Trevor Daniels, 2012-08-29 10:56:28]

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

http://codereview.appspot.com/6474066/diff/5001/Documentation/notation/input....
Documentation/notation/input.itely:368: A @code{\header} block.  This sets the
global, (i.e. the top of
On 2012/08/29 09:55:04, Graham Percival wrote:

> Could I convince you to remove the commas?

Easily!  I've removed them already.  I'll not bother
posting another patch-set though.

Trevor

[Trevor Daniels, 2012-08-31 08:34:31]

Pushed to staging as
d3b8117dc5f12634c7a093955d3b32f66ce26b5e
Closing