From: Trevor Daniels <t.daniels@treda.co.uk>
Date: Sun, 21 Nov 2010 09:34:21 +0000 (+0000)
Subject: Doc: CG 4.3.6 Syntax survey: Elaborate @itemize guidance
X-Git-Tag: release/2.13.41-1~19
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=bf4298556820ead4deff2d667c362c2d7d045e67;p=lilypond.git

Doc: CG 4.3.6 Syntax survey: Elaborate @itemize guidance

 - actually elaborate @enumerate, since @itemize simply
   refers to this
---

diff --git a/Documentation/contributor/doc-work.itexi b/Documentation/contributor/doc-work.itexi
index a42d029b15..0162670763 100644
--- a/Documentation/contributor/doc-work.itexi
+++ b/Documentation/contributor/doc-work.itexi
@@ -756,16 +756,33 @@ Don't capitalize the first word.
 @itemize
 @item
 @code{@@enumerate} --- Create an ordered list (with numbers).
-Always put @samp{@@item} on its own line, and separate consecutive
-items with a blank line:
+Always put @samp{@@item} on its own line.  As an exception, if all
+the items in the list are short enough to fit on single lines, placing
+them on the @samp{@@item} lines is also permissible.  @samp{@@item}
+and @samp{@@end@tie{}enumerate} should always be preceded by a blank
+line.
 
 @example
 @@enumerate
+
 @@item
-Foo
+A long multi-line item like this one must begin
+on a line of its own and all the other items in
+the list must do so too.
 
 @@item
-Bar
+Even short ones
+
+@@end enumerate
+@end example
+
+@example
+@@enumerate
+
+@@item Short item
+
+@@item Short item
+
 @@end enumerate
 @end example