• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1mark_as_advanced
2----------------
3
4Mark cmake cached variables as advanced.
5
6.. code-block:: cmake
7
8  mark_as_advanced([CLEAR|FORCE] <var1> ...)
9
10Sets the advanced/non-advanced state of the named
11cached variables.
12
13An advanced variable will not be displayed in any
14of the cmake GUIs unless the ``show advanced`` option is on.
15In script mode, the advanced/non-advanced state has no effect.
16
17If the keyword ``CLEAR`` is given
18then advanced variables are changed back to unadvanced.
19If the keyword ``FORCE`` is given
20then the variables are made advanced.
21If neither ``FORCE`` nor ``CLEAR`` is specified,
22new values will be marked as advanced, but if a
23variable already has an advanced/non-advanced state,
24it will not be changed.
25
26.. versionchanged:: 3.17
27  Variables passed to this command which are not already in the cache
28  are ignored. See policy :policy:`CMP0102`.
29