From bf4298556820ead4deff2d667c362c2d7d045e67 Mon Sep 17 00:00:00 2001 From: Trevor Daniels Date: Sun, 21 Nov 2010 09:34:21 +0000 Subject: [PATCH] Doc: CG 4.3.6 Syntax survey: Elaborate @itemize guidance - actually elaborate @enumerate, since @itemize simply refers to this --- Documentation/contributor/doc-work.itexi | 25 ++++++++++++++++++++---- 1 file changed, 21 insertions(+), 4 deletions(-) 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 -- 2.39.2