Microsoft Knowledge Base Article
This article contents is Microsoft Copyrighted material.
©2005-©2007 Microsoft Corporation. All rights reserved.
Terms
of Use |
Trademarks
Article ID: 948860 - Last Review: February 7, 2008 - Revision: 1.2
VC++ build, Warning XDC0017 : Unrecognized XDCMake option: /validate
Source: Microsoft Support
RAPID PUBLISHING ARTICLES PROVIDE INFORMATION DIRECTLY FROM WITHIN THE MICROSOFT SUPPORT ORGANIZATION. THE INFORMATION CONTAINED HEREIN IS CREATED IN RESPONSE TO EMERGING OR UNIQUE TOPICS, OR IS INTENDED SUPPLEMENT OTHER KNOWLEDGE BASE INFORMATION.
- Add XML Documentation
(http://msdn2.microsoft.com/en-us/library/ms177226.aspx)
comments to your Visual C++ source code.
- Enable the Process Documentation Comments switch
(http://msdn2.microsoft.com/en-us/library/ms173501.aspx)
 (/doc)
- Select "Yes /validate" for Validate IntelliSense on the XML Document Generator
(http://msdn2.microsoft.com/en-us/library/ms235515.aspx)
Tool Property Page.
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...)
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.
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".
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.
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
| kbnomt kbrapidpub KB948860 |
Community Feedback System
Very often, it takes hours to solve a problem. Very often, you've looked high
and low, and have tried a lot of solutions. When you finally found it, chances
are, it was because someone else helped you. Here's your chance to give back.
Use our community feedback tool to let others know what worked for you and what
didn't.
Please also understand that the community feedback system is not warranted to be
correct, it's simply a system that we've built to let people try and help each
other. If something in a feedback response doesn't make sense to you, or you're
not comfortable making changes that the feedback talks about (like registry
edits), please consult a professional.
Thank you for using kbAlertz.com Feedback System.
-- Scott Cate