VC++ build, Warning XDC0017 : Unrecognized XDCMake option: /validate

1. Add XML Documentation (http://msdn2.microsoft.com/en-us/library/ms177226.aspx) comments to your Visual C++ source code.
2. Enable the Process Documentation Comments switch (http://msdn2.microsoft.com/en-us/library/ms173501.aspx) (/doc)
3. Select “Yes /validate” for Validate IntelliSense on the XML Document Generator (http://msdn2.microsoft.com/en-us/library/ms235515.aspx) Tool Property Page.

Result

You get a warning during the build:
Generating XML documentation…
warning XDC0017 : Unrecognized XDCMake option: /validate
XDCMAKE /old output_filename [options]
(and a list of valid options…)

Cause

The XDCMake tool had, at one time, a /validate option in its old command line interface.  It was decided, due to weaknesses in its implementation, that its usefulness was limited, and the feature was removed.  The compiler is guaranteed to generate good XML documentation, and there is little need (or none at all) to add a validation step to the build.  However, due to an oversight, this option was not removed from the IDE and its corresponding documentation. Consequently, selecting “Yes” for this option in the IDE causes “/validate” to be added to the XDCMake command line, and the tool generates the warning.

Resolution

Do not use this option.  Leave it at the default setting (“No”), or pay no heed to the warnings if you leave it on “Yes”.

More Information

MIcrosoft has no plans to re-implement the /validate switch, and the IDE option will be removed in a future release of the Visual C++ project engine.
The XDCMake command line (http://msdn2.microsoft.com/en-us/library/ms177247.aspx), when used outside of Visual Studio, also supports a different set of options than the “/old” interface supported in Visual Studio 2005 and 2008.

DISCLAIMER

MICROSOFT AND/OR ITS SUPPLIERS MAKE NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY, RELIABILITY OR ACCURACY OF THE INFORMATION CONTAINED IN THE DOCUMENTS AND RELATED GRAPHICS PUBLISHED ON THIS WEBSITE (THE “MATERIALS”) FOR ANY PURPOSE. THE MATERIALS MAY INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS AND MAY BE REVISED AT ANY TIME WITHOUT NOTICE.

TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, MICROSOFT AND/OR ITS SUPPLIERS DISCLAIM AND EXCLUDE ALL REPRESENTATIONS, WARRANTIES, AND CONDITIONS WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO REPRESENTATIONS, WARRANTIES, OR CONDITIONS OF TITLE, NON INFRINGEMENT, SATISFACTORY CONDITION OR QUALITY, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THE MATERIALS.


APPLIES TO
Microsoft Visual Studio 2005 Professional Edition
Microsoft Visual Studio 2005 Team Suite
Microsoft Visual Studio 2008 Professional Edition
Microsoft Visual Studio Team System 2008 Team Suite

——————————————–

Microsoft Knowledge Base Article

This article contents is Microsoft Copyrighted material.
Microsoft Corporation. All rights reserved. Terms of Use | Trademarks


You can follow any responses to this entry through the RSS 2.0 feed. You can leave a response, or trackback from your own site.

AddThis Social Bookmark Button

Leave a Reply

*
To prove that you're not a bot, enter this code
Anti-Spam Image