AnotherFoxGuy/autocmake
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

update about page

Browse Source
This commit is contained in:
Radovan Bast 2015-07-27 17:23:37 +02:00
parent 812ed9341e
commit e8905bd6e8
1 changed files with 16 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
doc/general/about.rst
View File

@ -3,25 +3,27 @@
About Autocmake About Autocmake
=============== ===============
You typically want to use CMake when you get tired of manually editing Building libraries and executables from sources can be a complex task. Several
Makefiles. Autocmake is for people who are tired of editing CMake files solutions exist to this problem: GNU Makefiles is the traditional approach.
directly. Autocmake assembles CMake modules, generates ``CMakeLists.txt`` as Today, CMake is one of the trendier alternatives. Autocmake is a script which
well as ``setup.py``, which serves as a front-end to ``CMakeLists.txt``. All composes well tested CMake building blocks into a CMake project. Autocmake
this is done based on a lightweight ``autocmake.cfg`` file:: assembles CMake modules, generates ``CMakeLists.txt`` as well as ``setup.py``,
which serves as a front-end to ``CMakeLists.txt``. All this is done based on a
lightweight ``autocmake.cfg`` file::
update.py --self python update.py --self
| | | |
| fetches Autocmake | | fetches Autocmake |
| infrastructure | | infrastructure |
v Developer maintaining v Developer maintaining
autocmake.cfg Autocmake autocmake.cfg Autocmake
| | | |
| update.py | | python update.py .. |
| | | |
v v v v
CMakeLists.txt (and setup.py front-end) CMakeLists.txt (and setup.py front-end)
| | | |
| setup.py | | python setup.py |
| which invokes CMake | | which invokes CMake |
v User of the code v User of the code
Makefile (or something else) | Makefile (or something else) |
@ -49,11 +51,12 @@ scientific projects which typically have very similar requirements:
Our other motivation for Autocmake was to make it easier for developers who do Our other motivation for Autocmake was to make it easier for developers who do
not know CMake to generate a CMake infrastructure within minutes by providing not know CMake to generate a CMake infrastructure within minutes by providing
a higher-level entry point. a higher-level entry point to CMake.
Autocmake is a chance to provide a well documented and tested set of CMake Autocmake is a chance to provide a well documented and tested set of CMake
plug-ins. With this we wish to give also users of codes the opportunity to plug-ins. With this we wish to give also users of codes the opportunity to
introduce the occasional tweak without the need to read CMake documentation. introduce the occasional tweak without the need to dive deep into CMake
documentation.
Explicit is better than implicit Explicit is better than implicit
@ -67,4 +70,6 @@ Convention over configuration
----------------------------- -----------------------------
Our guideline is to follow good established conventions in order to allow users Our guideline is to follow good established conventions in order to allow users
and developers to recognize the configuration when moving to a new project. and developers to recognize the configuration when experimenting with
an Autocmake-powered project.
another.