CG 4.3.6 says:
"Always put �...@item’ 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 "^...@item\s*.\+" |
  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




_______________________________________________
lilypond-devel mailing list
[email protected]
http://lists.gnu.org/mailman/listinfo/lilypond-devel

Reply via email to