Help: clarify DESTINATION and TYPE usage for install()
Corrects a few inaccuracies and tightens up wording around the new default destination and file type functionality of the
install() command. Key points:
- Updated the synopsis to remove the
DESTINATIONkeywords now that the logic around whether they are needed is less straightforward. Since
TYPEcan now be used instead of
DESTINATIONin some cases, having
DESTINATIONin the synopsis could be confusing. All forms shown in the synopsis now have consistency in only showing the first keyword and deferring all other options to the detailed sections.
TYPEmust be provided for
install(DIRECTORY). The command signatures could have been interpreted as implying you could omit both.
- If non-standard destinations are specified, they should still ideally start with one of the
GNUInstallDirsvariables, not just simply contain one.
- Prefer "project" to "you" and similar wording.