CPack External generator docs hard to follow for staging feature
In the documentation for the new CPack External generator, the discussion of the staging feature is not all that easy to follow. In particular, in the description of the CPACK_EXTERNAL_ENABLE_STAGING
variable, it mentions the variables CPACK_TOPLEVEL_DIRECTORY
and CPACK_TEMPORARY_DIRECTORY
but these two variables are not described anywhere else in the CMake or CPack docs. The text is ambiguous about whether projects should be able to expect to read or set these.
It would be natural for people to think they can change the staging directory (that was my initial expectation), but this does not seem to be possible (not easily from the CMakeLists.txt anyway). I think the docs currently do not provide enough guidance for this particular aspect of the generator. In particular, more clarity is needed around whether projects can read or modify the mentioned variables. An example or two might also help highlight how the staging feature can be used, and in particular how an external process would find out where the staged files are located.