[llvm-commits] [PATCH] Enable -Wdocumentation for LLVM and Clang

[Dmitri Gribenko]

Hello,

These patches enable -Wdocumentation
-Wno-documentation-deprecated-sync for LLVM and Clang.  Please review.

Nakamura-san has cleaned up the last documentation warnings, so
enabling these flags now does not introduce new warnings during build.

Build time difference is 4.4% .. 5.8% (95% confidence interval).

Measurements are for configure-based Release+Asserts
LLVM+Clang+compiler-rt build on a quad-core Linux desktop with SSD.

Dmitri

=== Raw data and calculations ===

Normal build:
12m24s = 744 s
12m16s = 736 s
12m25s = 745 s

mean: 741.8 s
std dev: 5.0
95% confidence interval: 736.1 s to 747.5 s

With -Wdocumentation:
12m58s = 778s
12m59s = 779
13m0s  = 780s

mean: 779.0 s
std dev: 1
95% confidence interval: 779.1 s to 780.1 s

Single core build time difference: 130.4 s .. 172.0 s

-- 
main(i,j){for(i=2;;i++){for(j=2;j<i;j++){if(!(i%j)){j=0;break;}}if
(j){printf("%d\n",i);}}} /*Dmitri Gribenko <gribozavr at gmail.com>*/
-------------- next part --------------
A non-text attachment was scrubbed...
Name: pass-Wdocumentation-autotools-v1.patch
Type: application/octet-stream
Size: 10657 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/llvm-commits/attachments/20121224/891d608f/attachment.obj>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: pass-Wdocumentation-cmake-v1.patch
Type: application/octet-stream
Size: 1648 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/llvm-commits/attachments/20121224/891d608f/attachment-0001.obj>