On Fri, Nov 19, 2010 at 08:55:26AM -0800, Mark Polesky wrote:
> CG 4.3.6 says:
> "Always put �...@item’ on its own line, and separate
> consecutive items with a blank line."
>
> In fact, we literally have thousands of cases:
>
> $ git grep -c "^...@item\s*.\+" |
> sed -n 's/.*://p' |
> awk '{total+=$0}END{print total}'
> 5103
GDP only covered about 30% of the docs, and didn't strictly
enforce the doc policy even within those areas, that's not a good
reason to change the policy.
> Personally, I don't mind this, so I'm questioning this
> particular policy, especially since the texinfo manual
> is rather flexible with the recommendations:
That's a better reason.
Ok, how about saying that you can have
@itemize
@item foo
@item bar
@end itemize
as long as each item is less than a line. If there's multiple
lines involved, then do the full
@itemize
@item foo
far
@item bar
boo
@end itemize
or
@itemize
@item
foo far
@item
bar boo
@end itemize
That sound ok?
Cheers,
- Graham
_______________________________________________
lilypond-devel mailing list
[email protected]
http://lists.gnu.org/mailman/listinfo/lilypond-devel
