autocmake/doc/developers/updating-modules.rst
2018-06-20 17:10:31 +02:00

31 lines
983 B
ReStructuredText

Updating CMake modules
======================
To update CMake modules fetched from the web you need to run the ``update.py`` script::
$ cd cmake
$ python update.py ..
The CMake modules are not fetched or updated at configure time or build time.
In other words, if you never re-run ``update.py`` script and never modify the
CMake module files, then the CMake modules will remain forever frozen.
How to pin CMake modules to a certain version
---------------------------------------------
Sometimes you may want to avoid using the latest version of a CMake module and
rather fetch an older version, for example with the hash ``abcd123``. To
achieve this, instead of::
- my_feature:
- source: https://github.com/dev-cafe/autocmake/raw/master/modules/foo.cmake
pin the version to ``abcd123`` (you do not need to specify the full Git hash, a unique
beginning will do)::
- my_feature:
- source: https://github.com/dev-cafe/autocmake/raw/abcd123/modules/foo.cmake