autocmake/doc/customizing-modules.rst
2015-06-04 12:13:44 +02:00

41 lines
1.3 KiB
ReStructuredText

Customizing CMake modules
=========================
The ``update.py`` script assembles modules listed in ``autocmake.cfg`` and
places them inside ``modules/``. You have at least four options to customize
CMake modules:
Directly inside the generated modules directory
-----------------------------------------------
The CMake modules can be customized directly inside ``modules/`` but this is
the least elegant solution since the customizations may be overwritten by the
``update.py`` script (use version control).
Adapt local copies of CMake modules
-----------------------------------
A better solution is to download the CMake modules that you wish you customize
to a separate directory and source the customized CMake modules in
``autocmake.cfg``. Alternatively you can serve your custom
modules from your own http server.
Create own CMake modules
------------------------
Of course you can also create own modules and source them in ``autocmake.cfg``.
Contribute customizations to the "standard library"
---------------------------------------------------
If you think that your customization will be useful for other users as well,
you may consider contributing the changes directly to
https://github.com/scisoft/autocmake/. We very much encourage such
contributions. But we also very much strive for generality and portability.