View | Details | Raw Unified | Return to bug 254677
Collapse All | Expand All

(-)documentation/content/en/books/porters-handbook/uses/_index.adoc (-4 / +12 lines)
Lines 194-209 Prevents the port from installing [.filename]#charset.alias#. This must be insta Link Here
194
[[uses-cmake]]
194
[[uses-cmake]]
195
== `cmake`
195
== `cmake`
196
196
197
Possible arguments: (none), `insource`, `noninja`, `run`
197
Possible arguments: (none), `insource`, `noninja`, `run`, `testing`
198
198
199
Uses CMake for configuring and building.
199
Use CMake for configuring the port and generating a build system.
200
200
201
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.
201
By default an out-of-source build is performed, leaving the sources in `WRKSRC` free from build artifacts. 
202
With the `insource` argument, an in-source build will be performed instead. 
203
This argument should be an exception, used only when a regular out-of-source build does not work.
202
204
203
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.
205
By default Ninja (package:devel/ninja[]) is used for the build. 
206
In some cases this does not work correctly. 
207
With the `noninja` argument, the build will use regular `make` for builds. 
208
This argument should only be used if a Ninja-based build does not work.
204
209
205
With the `run` argument, a run dependency is registered in addition to a build dependency.
210
With the `run` argument, a run dependency is registered in addition to a build dependency.
206
211
212
With the `testing` argument, a test-target is added that uses CTest.
213
When running tests the port will be re-configured for testing and re-built.
214
207
For more information see crossref:special[using-cmake,Using `cmake`].
215
For more information see crossref:special[using-cmake,Using `cmake`].
208
216
209
[[uses-compiler]]
217
[[uses-compiler]]

Return to bug 254677