lilypond-devel
[Top][All Lists]
Advanced

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

Re: questioning doc policy for @item


From: Trevor Daniels
Subject: Re: questioning doc policy for @item
Date: Sat, 20 Nov 2010 08:38:04 -0000


Trevor Daniels wrote Saturday, November 20, 2010 8:29 AM

Graham Percival Saturday, November 20, 2010 12:44 AM


On Fri, Nov 19, 2010 at 08:55:26AM -0800, Mark Polesky wrote:
CG 4.3.6 says:
"Always put address@hidden on its own line, and separate
consecutive items with a blank line."

In fact, we literally have thousands of cases:

$ git grep -c "address@hidden" |
  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.

+1.  In the GDP'd parts of the NR there are only 7 exceptions.
(and in vocal none :)

Further, many if not all of the exceptions will be within @multitable,
where it is sensible to have @item foo.

Trevor





reply via email to

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