Updated formatting of documentation plus a little reorganization.
[cmake.git] / Source / cmGetTargetPropertyCommand.h
blob9b171965676412215efc28d2350b13e35c5dda56
1 /*=========================================================================
3 Program: CMake - Cross-Platform Makefile Generator
4 Module: $RCSfile: cmGetTargetPropertyCommand.h,v $
5 Language: C++
6 Date: $Date: 2009-01-05 14:53:22 $
7 Version: $Revision: 1.13 $
9 Copyright (c) 2002 Kitware, Inc., Insight Consortium. All rights reserved.
10 See Copyright.txt or http://www.cmake.org/HTML/Copyright.html for details.
12 This software is distributed WITHOUT ANY WARRANTY; without even
13 the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
14 PURPOSE. See the above copyright notices for more information.
16 =========================================================================*/
17 #ifndef cmGetTargetPropertyCommand_h
18 #define cmGetTargetPropertyCommand_h
20 #include "cmCommand.h"
22 class cmGetTargetPropertyCommand : public cmCommand
24 public:
25 virtual cmCommand* Clone()
27 return new cmGetTargetPropertyCommand;
30 /**
31 * This is called when the command is first encountered in
32 * the input file.
34 virtual bool InitialPass(std::vector<std::string> const& args,
35 cmExecutionStatus &status);
37 /**
38 * The name of the command as specified in CMakeList.txt.
40 virtual const char* GetName() { return "get_target_property";}
42 /**
43 * Succinct documentation.
45 virtual const char* GetTerseDocumentation()
47 return "Get a property from a target.";
50 /**
51 * Longer documentation.
53 virtual const char* GetFullDocumentation()
55 return
56 " get_target_property(VAR target property)\n"
57 "Get a property from a target. The value of the property is "
58 "stored in the variable VAR. If the property is not found, VAR "
59 "will be set to \"NOTFOUND\". Use set_target_properties to set "
60 "property values. Properties are usually used to control how "
61 "a target is built, but some query the target instead. "
62 "This command can get properties for any target so far created. "
63 "The targets do not need to be in the current CMakeLists.txt file.";
66 cmTypeMacro(cmGetTargetPropertyCommand, cmCommand);
71 #endif