Doc: more comprehensive documentation of layout block (2560)

Doc: more comprehensive documentation of layout block (2560)

  I've essentially copied the text and examples from Urs'
  suggestions in issue 2560, just changing the wording here
  and there to match the style of the NR.  As I have not myself
  checked the stated operation of layout blocks I'd welcome
  careful consideration of this patch by those familiar with
  their workings.

[dak, 2012-07-07 20:01:43]

http://codereview.appspot.com/6354085/diff/1/Documentation/notation/spacing.i...
File Documentation/notation/spacing.itely (right):

http://codereview.appspot.com/6354085/diff/1/Documentation/notation/spacing.i...
Documentation/notation/spacing.itely:1182: to structure the layout design of
sources, and also to reset the
Trailing whitespace.

[Trevor Daniels, 2012-07-07 21:23:43]

http://codereview.appspot.com/6354085/diff/1/Documentation/notation/spacing.i...
File Documentation/notation/spacing.itely (right):

http://codereview.appspot.com/6354085/diff/1/Documentation/notation/spacing.i...
Documentation/notation/spacing.itely:1182: to structure the layout design of
sources, and also to reset the
On 2012/07/07 20:01:43, dak wrote:

> Trailing whitespace.
Thanks.  Fixed.

[Graham Percival, 2012-07-08 03:55:58]

LGTM

http://codereview.appspot.com/6354085/diff/1/Documentation/notation/spacing.i...
File Documentation/notation/spacing.itely (right):

http://codereview.appspot.com/6354085/diff/1/Documentation/notation/spacing.i...
Documentation/notation/spacing.itely:1098: If this block:
How about a "For example," at the beginning of this line?  It's slightly fluffy,
but it would help somebody doing a quick skim from thinking that there was
anything special about the following example.

[Trevor Daniels, 2012-07-08 07:36:50]

http://codereview.appspot.com/6354085/diff/1/Documentation/notation/spacing.i...
File Documentation/notation/spacing.itely (right):

http://codereview.appspot.com/6354085/diff/1/Documentation/notation/spacing.i...
Documentation/notation/spacing.itely:1098: If this block:
On 2012/07/08 03:55:58, Graham Percival wrote:

> How about a "For example," at the beginning of this line?
Done.  Thanks.

[Graham Percival, 2012-07-09 04:50:29]

I'm content to take your word for the changes, but our general custom these days
is to upload a new draft once edits are made.  I mention this mainly so that you
can check how git-cl handles this; it should be easy but it's been a while since
I've done it myself.

[Trevor Daniels, 2012-07-11 06:59:23]

Patch pushed
73255e50558a62841500aa947ff7cad28636d144