install_programs.rst 1.2 KB

12345678910111213141516171819202122232425262728293031323334
  1. install_programs
  2. ----------------
  3. Deprecated. Use the :command:`install(PROGRAMS)` command instead.
  4. This command has been superceded by the :command:`install` command. It is
  5. provided for compatibility with older CMake code. The ``FILES`` form is
  6. directly replaced by the ``PROGRAMS`` form of the :command:`install`
  7. command. The regexp form can be expressed more clearly using the ``GLOB``
  8. form of the :command:`file` command.
  9. ::
  10. install_programs(<dir> file1 file2 [file3 ...])
  11. install_programs(<dir> FILES file1 [file2 ...])
  12. Create rules to install the listed programs into the given directory.
  13. Use the ``FILES`` argument to guarantee that the file list version of the
  14. command will be used even when there is only one argument.
  15. ::
  16. install_programs(<dir> regexp)
  17. In the second form any program in the current source directory that
  18. matches the regular expression will be installed.
  19. This command is intended to install programs that are not built by
  20. cmake, such as shell scripts. See the ``TARGETS`` form of the
  21. :command:`install` command to create installation rules for targets built
  22. by cmake.
  23. The directory ``<dir>`` is relative to the installation prefix, which is
  24. stored in the variable :variable:`CMAKE_INSTALL_PREFIX`.