diff options
| author | Stephen Kelly <steveire@gmail.com> | 2014-02-18 15:08:44 (GMT) |
|---|---|---|
| committer | Stephen Kelly <steveire@gmail.com> | 2014-02-18 15:08:44 (GMT) |
| commit | 0c54b775a4aaec799fbbfc89cbec07222bb806b3 (patch) | |
| tree | b113420bd8d843373b3ef957f8e48f004c586ced /Help | |
| parent | 586d2ce8a7eaa76b1048226fb1e26fe52071ee8b (diff) | |
| download | CMake-0c54b775a4aaec799fbbfc89cbec07222bb806b3.zip CMake-0c54b775a4aaec799fbbfc89cbec07222bb806b3.tar.gz CMake-0c54b775a4aaec799fbbfc89cbec07222bb806b3.tar.bz2 | |
Help: Document the purpose of usage requirements clearly.
People will be tempted to put things there for convenience, thereby
causing conflicts similar to
http://thread.gmane.org/gmane.comp.compilers.clang.devel/35162/focus=35169
where it is conceivable that the LLVM developers could put a flag on
a target for convenience, which would cause conflicts for some downstreams.
Diffstat (limited to 'Help')
| -rw-r--r-- | Help/manual/cmake-buildsystem.7.rst | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/Help/manual/cmake-buildsystem.7.rst b/Help/manual/cmake-buildsystem.7.rst index 03eb163..d252473 100644 --- a/Help/manual/cmake-buildsystem.7.rst +++ b/Help/manual/cmake-buildsystem.7.rst @@ -112,6 +112,12 @@ Each command may be invoked with multiple uses of each keyword: INTERFACE USING_ARCHIVE_LIB ) +Note that usage requirements are not designed as a way to make downstreams +use particular :prop_tgt:`COMPILE_OPTIONS` or +:prop_tgt:`COMPILE_DEFINITIONS` etc for convenience only. The contents of +the properties must be **requirements**, not merely recommendations or +convenience. + Target Properties ----------------- |