Hello all,
I am reading through a book on CMake at the moment, and it occurred to me while perusing the documentation that it is rather difficult to quickly find which variables may be set by any given command. Since I am often times interested in inspecting or testing such variables to assess the outcome of the command’s execution, it would be very helpful if I could quickly access this information. To give an example, the find_package command sets the _FOUND variable to indicate whether the package requested was found. The documentation of this command has several sections that list out variables that it sets, but this particular variable, which is one of the most important, is located in a paragraph of the “Basic Signature” section and isn’t clearly set apart from the rest of the text. The problem with this way of organizing the information is that, if you don’t know what you’re looking for, you may have to read quite a bit of information that is not immediately relevant to find it. Would it be possible to (perhaps automatically) generate a table for each command documenting which variables may be set by the command and what values they may contain and under what conditions.
Andrew Puleo