lilypond-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

questioning doc policy for @item


From: Mark Polesky
Subject: questioning doc policy for @item
Date: Fri, 19 Nov 2010 08:55:26 -0800 (PST)

CG 4.3.6 says:
"Always put address@hidden on its own line, and separate
consecutive items with a blank line."

Yet we have a lot of cases of things this:

@itemize
@item foo
@item bar
@item baz
@end itemize

In fact, we literally have thousands of cases:

$ git grep -c "address@hidden" |
  sed -n 's/.*://p' |
  awk '{total+=$0}END{print total}'
5103

Personally, I don't mind this, so I'm questioning this
particular policy, especially since the texinfo manual
is rather flexible with the recommendations:

* "It is ok to have text following the @item."
* "Usually, you should put a blank line before an @item.
  This puts a blank line in the Info file.  (TeX inserts the
  proper interline whitespace in either case.)  Except when
  the entries are very brief, these blank lines make the
  list look better."
- http://www.gnu.org/software/texinfo/manual/texinfo/html_node/itemize.html

Any opinions on this?
- Mark






reply via email to

[Prev in Thread] Current Thread [Next in Thread]