message: Update docs 2
diff: @@ -256,7 +256,7 @@ using ``${variable}`` syntax. The following built-in variables are expanded:
  **DEPRECATED**. Expands to the constant string "``ProjectName``"
  .. note::
  - This was deprecated as CMake does not consider there two be *one*
  + This was deprecated as CMake does not consider there to be *one*
  project name to use. The concept of a single project does not work in
  CMake, and this made this feature problematic and buggy. Alternatives
  include ``${workspaceRootFolderName}``.
  @@ -264,10 +264,24 @@ using ``${variable}`` syntax. The following built-in variables are expanded:
  ``${userHome}``
  The full path to the current user's home directory
  -``${variant_identifier}``
  - *Replace* ``variant_identifier`` *with your variant identifier.*
  +``${<variant_identifier>}``
  + *Replace* ``<variant_identifier>`` *with your variant identifier, eg. *``${mybuildtype}``.
  Expands to the currently active choice of the given variant identifier.
  + .. note::
  + This is the *short* form for variant substitution.
  + It will only be available, if the replacement key is not already taken.
  + In that case, use the *variant* form below.
  +
  +``${variant_<variant_identifier>}``
  + *Replace* ``<variant_identifier>`` *with your variant identifier, eg. *``${variant_mybuildtype}``.
  + Expands to the currently active choice of the given variant identifier.
  +
  + .. note::
  + This is the *variant* form for variant substitution.
  + *It will always be available!*
  + Behaviour is *undefined* if the user defines a variant with the ``variant_`` prefix.
  +
  Environment Variables
  *********************
  