|
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 AMOn 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}' 5103GDP 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
[Prev in Thread] | Current Thread | [Next in Thread] |