1
0
mirror of https://github.com/Kitware/CMake.git synced 2025-06-24 13:13:18 +08:00

1155 Commits

Author SHA1 Message Date
Brad King
3e5a047f1a Help: Drop compile features section from cmake-developer(7) manual
We no longer add granular compile features.  Only language standard
meta features like `cxx_std_##`` need to be added, and these can
be done by following existing patterns.
2018-11-14 14:29:13 -05:00
Joachim Wuttke (l)
df780bcc01 Help: Move deprecated modules to appropriate section.
Move deprecated or obsolete modules to the section
"Deprectated Modules" of cmake-modules(7):

- MacroAddFileDependencies (Text says: Using the macro
  MACRO_ADD_FILE_DEPENDENCIES() is discouraged.)
- UsePkgConfig (Text calls it "obsolete")
- Use_wxWindows (was already listed in deprecation section)
2018-11-13 13:06:30 +01:00
Brad King
db984477e4 Merge topic 'deprecate-ParseArguments'
ff800a768c Help: move CMakeParseArguments to deprecated section

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2595
2018-11-12 16:28:30 -05:00
Craig Scott
ddb967cca1 Merge topic 'pie-link-options'
c4b4d8b3a6 POSITION_INDEPENDENT_CODE: Manage link flags for executables
724a0346f7 POSITION_INDEPENDENT_CODE: Fix erroneous '-fPIE' flag for Sun Studio
023188ffb4 INTERFACE_POSITION_INDEPENDENT_CODE: add generator expressions support

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2465
2018-11-12 15:43:07 -05:00
Joachim Wuttke (h)
ff800a768c Help: move CMakeParseArguments to deprecated section 2018-11-11 23:14:37 +01:00
Marc Chevrier
c4b4d8b3a6 POSITION_INDEPENDENT_CODE: Manage link flags for executables
Fixes: #14983, #16561
2018-11-11 17:34:09 +01:00
Sebastian Holtermann
2ef8fe2222 Autogen: Add documentation for CMAKE_GLOBAL_AUTOGEN/RCC_TARGET 2018-11-11 14:29:38 +01:00
Joachim Wuttke (l)
860338491e Help: Describe $CACHE and $ENV as operators
This resolves issue #18514

Also add a cross-reference to if(DEFINED ENV{var}).
2018-11-08 20:33:13 +01:00
Joachim Wuttke (l)
8ba2a8d4a4 Help: short/long variable reference in if command
Explain that the short form of variable references
in the if command does not apply to ENV and CACHE vars.
2018-11-08 20:27:49 +01:00
Joachim Wuttke (h)
85498fccd8 Help: Provide backreferences.
Short intro to pages cmake-variables.7 and cmake-env-variables.7,
with backlinks to cmake-language.7.
2018-11-08 20:27:49 +01:00
Joachim Wuttke (h)
e24ef96942 Help: New section on Environment Variables in cmake-language.7 2018-11-08 20:27:49 +01:00
Joachim Wuttke (h)
e4554149c4 Help: Remove over-precise clause.
Section "Variables References" said that environment and cache
variables are "evaluated in the same contexts as a normal variable
reference". The reader has to guess what "contexts" means in
this context. Probably "inside a Quoted Argument or an Unquoted
Argument", exactly as for ordinary variable references.
But this is exactly what the reader would tacitly assume anyway.
Therefore I think the removed clause was unnecessary, and possibly
more confusing than helpful.
2018-11-08 20:27:49 +01:00
Brad King
bb8da283ce Merge topic 'genex'
86c07b9165 Help: Say early on that generator expressions can be nested.
ab1d7df757 Help: add section on debugging generator expressions.
e0f0f80f02 Help: Explain conversion rules of $<BOOL:string>.
2b2b41f038 Help: Code example for case-insensitive comparison
e045fb202d Help: Terminate explanations with a dot.
3fa0a03b7e Help: Expand placeholders in string comparisons.
fb423b3c49 Help: sort conditional expressions below string-valued ones.
867c9c9c0d Help: Add deprecation date of $<CONFIGURATION>
...

Acked-by: Kitware Robot <kwrobot@kitware.com>
Acked-by: Alex Turbov <i.zaufi@gmail.com>
Merge-request: !2564
2018-11-07 07:27:27 -05:00
Brad King
389002de96 Merge topic 'FindSQLite3-module'
fe40570608 FindSQLite3: Add module to find SQLite3

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2557
2018-11-07 07:26:46 -05:00
Chuck Atkins
fe40570608 FindSQLite3: Add module to find SQLite3 2018-11-06 15:05:04 -05:00
Brad King
c46dfb2139 Merge topic 'xref2'
2a98a0af46 Help: Link to cmake.org "Get Involved" page from cmake-developer(7)

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2537
2018-11-06 15:02:08 -05:00
Joachim Wuttke (h)
2a98a0af46 Help: Link to cmake.org "Get Involved" page from cmake-developer(7) 2018-11-06 14:24:43 -05:00
Brad King
7bed050755 Merge topic 'autogen_origin_depends'
47f9c15c60 Autogen: Update <ORIGIN>_autogen target documentation
336893d9eb Autogen: Separate AUTOGEN_TARGET_DEPENDS tests into own tests suite
846043dd35 Autogen: Rename MocDepends test to AutogenOriginDependsOn
b71a9598a4 Autogen: Add test for AUTOGEN_ORIGIN_DEPENDS=OFF
f74c406501 Autogen: Add (CMAKE_)AUTOGEN_ORIGIN_DEPENDS release notes
0669de5d36 Autogen: Add (CMAKE_)AUTOGEN_ORIGIN_DEPENDS documentation
b5e895b5d4 Autogen: Add (CMAKE_)AUTOGEN_ORIGIN_DEPENDS support

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2518
2018-11-06 11:38:23 -05:00
Joachim Wuttke (o)
86c07b9165 Help: Say early on that generator expressions can be nested. 2018-11-06 12:55:25 +01:00
Joachim Wuttke (h)
ab1d7df757 Help: add section on debugging generator expressions.
This resolves #18550.
2018-11-06 12:55:25 +01:00
Joachim Wuttke (h)
e0f0f80f02 Help: Explain conversion rules of $<BOOL:string>.
This resolves #18549.
2018-11-06 12:55:24 +01:00
Joachim Wuttke (h)
2b2b41f038 Help: Code example for case-insensitive comparison 2018-11-06 12:55:24 +01:00
Joachim Wuttke (h)
e045fb202d Help: Terminate explanations with a dot. 2018-11-06 12:55:24 +01:00
Joachim Wuttke (h)
3fa0a03b7e Help: Expand placeholders in string comparisons.
And point out that STREQUAL is case sensitive.
2018-11-06 12:55:24 +01:00
Joachim Wuttke (h)
fb423b3c49 Help: sort conditional expressions below string-valued ones.
Makes things yet clearer and simpler.
Also correct remnant of "informational expression".
2018-11-06 12:55:24 +01:00
Joachim Wuttke (h)
867c9c9c0d Help: Add deprecation date of $<CONFIGURATION> 2018-11-06 12:55:24 +01:00
Joachim Wuttke (h)
a85e5e6f4d Help: Add note on omitted <..> notation in cmake-generator-expressions(7) 2018-11-06 12:55:24 +01:00
Joachim Wuttke (h)
ff1db47728 Help: Revise documentation of string-valued generator expressions
* Consolidate examples
* Sort, and insert subsection headers
2018-11-06 12:55:24 +01:00
Joachim Wuttke (h)
fe8acf7c05 Help: 3 subtypes of boolean generator expressions.
Main classification by return type,
subclassification by dependences
2018-11-06 12:55:23 +01:00
Joachim Wuttke (h)
9891adf74b Help: Cross-link conditional and boolean expressions.
Rename Logical -> Boolean Generator Expressions.
It's the return type that helps us to sort the expression zoo.
2018-11-06 12:55:23 +01:00
Joachim Wuttke (h)
20b6561e78 Help: new section on conditional generator expressions
Before, the closely related signatures
  $<condition:true_value>
  $<IF:condition,true_value,false_value>
were explained in two different sections.  The former section
was badly explained, with '0' and '1' in place of the formal
parameter 'condition'.
2018-11-06 12:55:23 +01:00
Joachim Wuttke (h)
873e59c0c4 Help: rm unmotivated "This means that"
That generator expressions enable conditional things
has not been said before.

Amended for nicer source format.
2018-11-06 12:55:23 +01:00
Joachim Wuttke (h)
b2a798fe32 Help: expand "ver", "pol", ...
No need to save a few characters on formal parameters.

Use this occasion to correct $<PLATFORM_ID:comp>:
the parameter is a platform_id, not a compiler_id.
2018-11-06 12:55:23 +01:00
Joachim Wuttke (h)
db749f404c Help: expand "..." and "?" in logical generator expressions
Expand "..." and "?", which could be mistaken as metacharacters
(and in the explanations of AND and OR actually were meant as
metacharacters).
2018-11-06 12:55:23 +01:00
Sebastian Holtermann
47f9c15c60 Autogen: Update <ORIGIN>_autogen target documentation 2018-11-05 14:03:01 +01:00
Craig Scott
aa78b61bbc Merge topic 'cpack-gen-docs-link'
c12eefa8fd Help: Fix generators link in cpack(1) manual

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2562
2018-11-04 20:01:08 -05:00
Craig Scott
c12eefa8fd Help: Fix generators link in cpack(1) manual
Minor rewording around the updated link and extra blank line
added to improve readability and remove a potential
ambiguity around the same area.

Fixes: #18545
2018-11-04 08:50:22 +11:00
Sebastian Holtermann
0669de5d36 Autogen: Add (CMAKE_)AUTOGEN_ORIGIN_DEPENDS documentation 2018-11-03 12:14:40 +01:00
Kyle Edwards
213433858f Help: Clarify usage of TARGET_PROPERTY generator expression
When using $<TARGET_PROPERTY:prop>, the value of prop comes from
the consuming target rather than the current target. Add a note to
clarify this.
2018-10-26 14:43:17 -04:00
Brad King
6166384e3e Merge topic 'relative-rpath'
95bd6317bc RPATH: Record support for $ORIGIN on various *BSD
c9b8c79271 RPATH: Record support for $ORIGIN on Haiku and Solaris
6114d85a7d RPATH: Add option for using $ORIGIN in build tree

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2456
2018-10-26 09:31:00 -04:00
Peter Wu
6114d85a7d RPATH: Add option for using $ORIGIN in build tree
This makes binaries independent of the build directory by not embedding
the build directory via RPATH.  The tests are partially based on the
existing RuntimePath test, but with the check moved into a POST_BUILD
command such that it can be skipped when the platform lacks support.

Fixes: #18413
2018-10-26 09:25:51 -04:00
Joachim Wuttke (o)
14edbe7e7b Help: Syntax highlighting for long strings in cmake-language.7 2018-10-25 14:00:34 +02:00
Joachim Wuttke (o)
4f4d5a9b3a Help: Apply syntax highlighting to cmake-generator-expressions.7 2018-10-25 13:55:30 +02:00
Joachim Wuttke (o)
dc1bb33578 Help: Add version number to deprecation note
In section "Deprecated Commands" in manual/cmake-commands.7,
indicate that those commands are deprecated since 3.0.
2018-10-25 11:05:06 +02:00
Brad King
d120ccd193 Merge topic 'find_fontconfig'
84e7920b3a FindFontconfig: Add module to find Fontconfig

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2487
2018-10-19 09:59:27 -04:00
Craig Scott
7053dd301c Merge topic 'help-syntax-highlighting'
93f3f65516 Help: Revise docs of modules AddFileDependencies..CheckFunctionExists
fc7ee1ca45 Help: Override pygments CMakeLexer to support <..> and [..]
74b3eacdc7 Help: Use appropriate list types in FindPkgConfig

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2468
2018-10-19 06:31:55 -04:00
Joachim Wuttke (o)
fc7ee1ca45 Help: Override pygments CMakeLexer to support <..> and [..]
* The code snippets in the docs consist of CMake code mixed
  with syntax definition punctuation like < > [ ] ... Therefore
  a pure CMake lexer is inadequate. Here it is replaced by a
  CMake syntax definition parser.
* Fixed syntax definition snippets in FindPkgConfig.cmake to
  make best use of syntax highlighting. This source file is the
  hardest to support because it contains comparison operators
  <= = >=, which need special attention to avoid confusion
  with the placeholder indicators <...>.
* Fixed syntax in execute_process.rst (there were unbalanced
  brackets).
* Disabled syntax highlighting for long string examples in
  cmake-language.7.rst.
* No highlighting of removed syntax in CMP0049
* To inspect the outcome of this patch, see e.g. the pages
  * manual/cmake-buildsystem.7.html
  * module/ExternalProject.html
  * module/FindPkgConfig.html
  which are particularly rich in complex code snippets.
2018-10-19 07:25:34 +11:00
Frederik Gladhorn
84e7920b3a FindFontconfig: Add module to find Fontconfig
This module is inspired by one from KDE's KWin.
2018-10-18 20:32:09 +02:00
Brad King
5b47557c82 Merge topic 'revert-server-iface-sources'
284a38e42f cmake-server: Revert "Support codemodel filegroups for INTERFACE_SOURCES"

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2495
2018-10-18 07:31:18 -04:00
Brad King
284a38e42f cmake-server: Revert "Support codemodel filegroups for INTERFACE_SOURCES"
Revert commit v3.13.0-rc1~144^2 (cmake-server: Support codemodel
filegroups for INTERFACE_SOURCES, 2018-08-10).  The changes activate
code paths not meant to be used with interface libraries.  Another
approach will be needed to expose this information later.

This revert has to be done by hand because the code in question has been
changed somewhat since the changes were made, and was also factored out
to another source file.

Fixes: #18463
2018-10-17 14:02:39 -04:00