Commit Graph

3085 Commits

Author SHA1 Message Date
Brad King
5daf7d92f8 Merge topic 'file-size'
12b471e828 file: add SIZE option

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2639
2018-11-28 09:05:16 -05:00
Craig Scott
faf4496db3 Merge topic 'doc-cmake.1'
e15cac8ee7 Help: Extend the cmake(1) manual
8b3a537c29 Help: Improve cmake(1) manual organization
f9c3f7b164 Help: Emphasize tool names in their manuals

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2662
2018-11-28 04:26:33 -05:00
Brad King
f49efe283e Merge topic 'autogen_target_docs'
0d80977af4 Autogen: Documentation updates

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2659
2018-11-27 08:51:27 -05:00
Brad King
bae71966fb Merge topic 'ctest-updates'
d9195ab081 Tests: Teach run_ctest to handle removal of CTestConfig.cmake
1ca53f5ef1 Remove unnecessary CTEST_PROJECT_NAME variables
15ac4aae0e Remove warning when no CTestConfig.cmake file exists
3125c47d27 ctest_build: Do not require unnecessary [CTEST_]PROJECT_NAME value
36bbd07a76 CDashUpload: Use the query part of the submit url as field
e1dfe8cee6 CTest: Don't require 'submit.php?' in submit location

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2640
2018-11-27 08:48:49 -05:00
Brad King
e15cac8ee7 Help: Extend the cmake(1) manual
Extend the description section to cover all capabilities that
the "cmake" tool has.  Extend the buildsystem generation section
to introduce important concepts and describe the basic workflow.

Inspired-by: Joachim Wuttke (l) <j.wuttke@fz-juelich.de>
2018-11-27 21:13:32 +11:00
Joachim Wuttke (l)
8b3a537c29 Help: Improve cmake(1) manual organization
Extend the Synposis, and provide links to manual sections.
Add sections for `cmake --open` and `cmake --help-*`.

Introduce a new section for buildsystem generation to distinguish it
from the other functionality.  Populate it with minimal placeholder text
for now.  It will be extended later.

Co-Author: Brad King <brad.king@kitware.com>
2018-11-27 21:13:32 +11:00
Wouter Klouwen
12b471e828 file: add SIZE option
This commit adds the SIZE option to file(). It returns the file size of
the given path if it exists and produces an error if not.
2018-11-27 08:50:36 +00:00
Joachim Wuttke (l)
f9c3f7b164 Help: Emphasize tool names in their manuals
Print the name of the **cmake** executable in boldface, so that it does
not appear less prominent than other shell commands (which are underlaid
with links).  Similarly the other tool manuals.
2018-11-26 10:17:44 -05:00
Sebastian Holtermann
0d80977af4 Autogen: Documentation updates
This extends the documentation for

- :prop_tgt:`AUTOGEN_ORIGIN_DEPENDS`
- :prop_tgt:`AUTOGEN_TARGET_DEPENDS`
- :variable:`CMAKE_GLOBAL_AUTOGEN_TARGET`
2018-11-26 09:57:20 +01:00
Brad King
2b427c2fad Merge topic 'FindGIF-modernize'
74cc42e937 Help: Add notes for topic 'FindGIF-modernize'
6962a41e6b FindGIF: Add test
5bc64fe6c2 FindGIF: Modernize

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2632
2018-11-21 07:41:27 -05:00
Brad King
74cc42e937 Help: Add notes for topic 'FindGIF-modernize' 2018-11-21 07:39:58 -05:00
Craig Scott
ec43aca703 Merge topic 'doc-module-doc-syntax'
8369e3e782 Help/dev: Modernize module example in the CMake Documentation Guide
664d6178d8 Help: Modernize example find module docs in cmake-developer(7)

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2621
2018-11-20 16:48:45 -05:00
Regina Pfeifer
3125c47d27 ctest_build: Do not require unnecessary [CTEST_]PROJECT_NAME value
Since commit v3.0.0-rc1~260^2~32 (ctest_build: Use "cmake --build"
to launch the native build tool, 2013-11-14) we no longer need to
use the project name in `ctest_build()`.

Fixes: #18612
2018-11-20 21:23:59 +01:00
Brad King
8369e3e782 Help/dev: Modernize module example in the CMake Documentation Guide 2018-11-20 21:03:01 +11:00
Brad King
664d6178d8 Help: Modernize example find module docs in cmake-developer(7) 2018-11-20 21:03:01 +11:00
Kyle Edwards
b5f8113ca7 Genex: Add policy to handle empty list items in $<IN_LIST:...>
The old behavior of $<IN_LIST:...> is inconsistent with that of
if(IN_LIST), in that it does not find an empty search item even if
the list contains empty items. This change adds a new policy to
correctly handle empty items and make the behavior more consistent
with if(IN_LIST).

Fixes: #18556
2018-11-19 17:02:06 -05:00
Brad King
8866f63f60 Merge topic 'macro_doc_cleanups'
b82526c654 Help: Minor grammar and typo corrections for macro command docs

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2622
2018-11-19 09:59:02 -05:00
Brad King
b7b2ce56a7 Merge topic 'findx11-imported-targets'
bced9d5e56 Tests/FindX11: add a test
a7d2ffb232 FindX11: add imported targets
40b3dba529 FindX11: require Freetype and Fontconfig for Xft
cc96249e2e FindX11: remove local variable from the advanced list
99489d9f10 FindX11: find Xext.h
b8b598061a FindX11: match variables with library names
6079a0d00f FindX11: fix some formatting in the documentation
3c54955d0d FindX11: use `list(APPEND)` for clearer code
...

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2604
2018-11-19 09:57:46 -05:00
Brad King
d9d8816f39 Merge topic 'pie-link-options'
b10f7ac534 CMP0083: fix warning message on try_compile

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2619
2018-11-19 09:57:13 -05:00
Marc Chevrier
b10f7ac534 CMP0083: fix warning message on try_compile
Fixes: #18593
2018-11-19 10:56:02 +01:00
Craig Scott
b82526c654 Help: Minor grammar and typo corrections for macro command docs
Follow-up to !2616, specifically commit 22cca9b810
2018-11-16 08:01:55 +11:00
Brad King
b324743229 Merge topic 'cpack'
a26ac919ef Help: Explain interaction of cpack(1) and CPack.

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2617
2018-11-15 13:49:58 -05:00
Joachim Wuttke (l)
a26ac919ef Help: Explain interaction of cpack(1) and CPack.
In particular, make clear that package/installer generators
are not the makefile generators of the cmake command.

Also insert sections in CPack doc, and capitalize section titles.
2018-11-15 16:50:52 +01:00
Brad King
59fc717c25 Merge topic 'deprecate-findqt'
0f5c1b404b find_package(): Add policy to remove the FindQt module

Acked-by: Kitware Robot <kwrobot@kitware.com>
Acked-by: noo mook <noomook2519@gmail.com>
Merge-request: !2554
2018-11-15 10:39:55 -05:00
Brad King
b3d1d6d895 Merge topic 'doc-developer-to-source-guide'
a82282a08c Help/dev: Factor out a CMake Documentation Guide for developing the docs
bfbc5241e9 Help: Fix policy markup example in cmake-developer(7)
3e5a047f1a Help: Drop compile features section from cmake-developer(7) manual
06cc050c1f Help/dev: Drop 'size_t' preference from source code guide

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2615
2018-11-15 08:36:52 -05:00
Brad King
bd2c17d614 Merge topic 'macro3'
22cca9b810 Help: describe differences between macro and function.
b90ae70a3b Help: in macro vs function example, use lowercase names.

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2616
2018-11-15 08:36:02 -05:00
Joachim Wuttke (l)
22cca9b810 Help: describe differences between macro and function. 2018-11-14 21:56:23 +01:00
Kyle Edwards
0f5c1b404b find_package(): Add policy to remove the FindQt module
Removing FindQt.cmake gives Qt upstream a path forward to export its
own QtConfig.cmake files which can be found by find_package()
without having to explicitly specify CONFIG. Projects that still
want to use Qt3/4 can call find_package(Qt[34]), include(FindQt),
or add FindQt.cmake to their CMAKE_MODULE_PATH.
2018-11-14 15:05:06 -05:00
Brad King
a82282a08c Help/dev: Factor out a CMake Documentation Guide for developing the docs
Remove this content from the `cmake-developer(7)` manual because it
is relevant only to developers working on CMake itself.  Move it to
a guide in the developer documentation.
2018-11-14 14:38:13 -05:00
Joachim Wuttke (l)
b90ae70a3b Help: in macro vs function example, use lowercase names.
Follow our own advise not to change cases.

Omit the leading underscore.
2018-11-14 20:33:12 +01:00
Brad King
bfbc5241e9 Help: Fix policy markup example in cmake-developer(7) 2018-11-14 14:29:13 -05:00
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
Brad King
06cc050c1f Help/dev: Drop 'size_t' preference from source code guide
We now use `std::size_t` in several places and it is fully supported by
C++11 compilers.  Drop the recommendation to prefer plain `size_t`.
2018-11-14 14:28:57 -05:00
Joachim Wuttke (o)
254a849864 Help: Spell out MFC
And shorten text that was hard to understand and redundant.
2018-11-14 17:50:45 +01:00
Joachim Wuttke (o)
b173c641c4 Help: Add links to variables 2018-11-14 17:50:45 +01:00
Brad King
64bc4bda74 Merge topic 'deprecate-modules2'
df780bcc01 Help: Move deprecated modules to appropriate section.

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2603
2018-11-13 14:25:58 -05:00
Joachim Wuttke (l)
abb5945bd0 Help: Document that function invocation is case-insensitive 2018-11-13 13:47:26 -05:00
Joachim Wuttke (l)
357cdee3a1 Help: Document that macro invocation is case-insensitive 2018-11-13 13:47:24 -05:00
Brad King
3603b3964b Merge topic 'macro'
dcf11cbcdc Help: Mention endmacro argument as legacy only.

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2606
2018-11-13 13:40:55 -05:00
Brad King
fb93f7f230 Merge topic 'env2'
26a70449cc Help: Describe environment variables as such.

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2609
2018-11-13 10:46:07 -05:00
Brad King
71e77972c1 Merge topic 'if_support_checking_if_cache_var_defined'
1222f02e34 If: Support the 'DEFINED CACHE{}' syntax

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2561
2018-11-13 10:29:36 -05:00
Ben Boeckel
a7d2ffb232 FindX11: add imported targets
These imported targets are fine-grained and recommended over the global
`X11_LIBRARIES` and `X11_INCLUDE_DIR` variables.
2018-11-13 10:22:00 -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
Joachim Wuttke (l)
dcf11cbcdc Help: Mention endmacro argument as legacy only.
Same change as previously done for function, if, while, ...
2018-11-13 12:14:55 +01:00
Joachim Wuttke (l)
26a70449cc Help: Describe environment variables as such.
In each environment variable doc page, insert an opening
paragraph (ENV_VAR.txt) to say that this is an environment
variable, and provide a link to the cmake-language section
on environment variables.
2018-11-13 09:29:36 +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
Ben Boeckel
99489d9f10 FindX11: find Xext.h 2018-11-12 16:10:13 -05:00
Ben Boeckel
b8b598061a FindX11: match variables with library names
This deprecates various variables, but provides them for backwards
compatibility.
2018-11-12 16:09:36 -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