[cmake-developers] Patches for some clang warnings

Eric Noulard eric.noulard at gmail.com
Tue Sep 24 08:32:38 EDT 2013


2013/9/24 Brad King <brad.king at kitware.com>:
> Hi Eric,
>
> On 09/19/2013 03:53 PM, Brad King wrote:
>> On 09/19/2013 03:34 PM, Sean McBride wrote:
>>> Thanks.  Here are two more patches.
>
> Sean's -Wdocumentation build produces these warnings:
>
> .../Source/CPack/cmCPackGenerator.h:163:38: warning: empty paragraph passed to '@param' command [-Wdocumentation]
>    * @param[in] initialPackageFileName
>      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^
> .../Source/CPack/cmCPackGenerator.h:164:36: warning: empty paragraph passed to '@param' command [-Wdocumentation]
>    * @param[in] groupOrComponentName
>      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^
> .../Source/CPack/cmCPackGenerator.h:165:27: warning: empty paragraph passed to '@param' command [-Wdocumentation]
>    * @param[in] isGroupName
>      ~~~~~~~~~~~~~~~~~~~~~^
> .../Source/CPack/cmCPackGenerator.h:175:10: warning: empty paragraph passed to '@pre' command [-Wdocumentation]
>    * @pre @ref toplevel has been filled-in
>      ~~~~^
>
> Can you please fill in the docs for these?

Yep.
Just done and merged to next:

Fetching upstream next
Merge topic 'fixDocumentationComment' into next

e507bf2 CPack: Fix clang -Wdocumentation warnings


-- 
Erk
L'élection n'est pas la démocratie -- http://www.le-message.org



More information about the cmake-developers mailing list