diff --git documentation/content/en/books/porters-handbook/uses/chapter.adoc documentation/content/en/books/porters-handbook/uses/chapter.adoc index a99e81bc51..3783e0260a 100644 --- documentation/content/en/books/porters-handbook/uses/chapter.adoc +++ documentation/content/en/books/porters-handbook/uses/chapter.adoc @@ -194,16 +194,26 @@ Prevents the port from installing [.filename]#charset.alias#. This must be insta [[uses-cmake]] == `cmake` -Possible arguments: (none), `insource`, `noninja`, `run` +Possible arguments: (none), `insource`, `noninja`, `run`, `testing` -Uses CMake for configuring and building. +Use CMake for configuring the port and generating a build system. -By default an out-of-source build is performed, leaving the sources in `WRKSRC` free from build artifacts. With the `insource` argument, an in-source build will be performed instead. Setting it should be the exception when a regular out-of-source build does not work. +By default an out-of-source build is performed, leaving the sources in +`WRKSRC` free from build artifacts. With the `insource` argument, an +in-source build will be performed instead. Setting it should be the +exception when a regular out-of-source build does not work. -By default Ninja is used for the build. In some cases this does not work correctly. With the `noninja` argument, the build will fallback to using regular `make` for builds. It should only be used if a Ninja-based build does not work. +By default Ninja (package:devel/ninja[]) is used for the build. +In some cases this does not work correctly. With the `noninja` argument, +the build will use regular `make` for builds. +It should only be used if a Ninja-based build does not work. With the `run` argument, a run dependency is registered in addition to a build dependency. +With the `testing` argument, a test-target is added that uses CTest. +When running tests the port will be re-configured for testing and +re-built. + For more information see <>. [[uses-compiler]]