[Top][All Lists]
[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
- questioning doc policy for @item,
Mark Polesky <=
- Re: questioning doc policy for @item, Mark Polesky, 2010/11/19
- Re: questioning doc policy for @item, Valentin Villenave, 2010/11/19
- Re: questioning doc policy for @item, Graham Percival, 2010/11/19
- Re: questioning doc policy for @item, Graham Percival, 2010/11/20
- Re: questioning doc policy for @item, Trevor Daniels, 2010/11/20