doxygen: Improve API docs of GetRealDependency

Use list instead of sequence of sentences in one paragraph.
This commit is contained in:
Yury G. Kudryashov 2012-02-25 13:16:07 +04:00
parent 80072d4ebf
commit 54ab11c0d2

View File

@ -160,15 +160,18 @@ public:
void AppendFeatureOptions(std::string& flags, const char* lang, void AppendFeatureOptions(std::string& flags, const char* lang,
const char* feature); const char* feature);
/** Translate a dependency as given in CMake code to the name to /** \brief Get absolute path to dependency \a name
appear in a generated build file. If the given name is that of *
a utility target, returns false. If the given name is that of * Translate a dependency as given in CMake code to the name to
a CMake target it will be transformed to the real output * appear in a generated build file.
location of that target for the given configuration. If the * - If \a name is a utility target, returns false.
given name is the full path to a file it will be returned. * - If \a name is a CMake target, it will be transformed to the real output
Otherwise the name is treated as a relative path with respect to * location of that target for the given configuration.
the source directory of this generator. This should only be * - If \a name is the full path to a file, it will be returned.
used for dependencies of custom commands. */ * - Otherwise \a name is treated as a relative path with respect to
* the source directory of this generator. This should only be
* used for dependencies of custom commands.
*/
bool GetRealDependency(const char* name, const char* config, bool GetRealDependency(const char* name, const char* config,
std::string& dep); std::string& dep);