aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/README.md
diff options
context:
space:
mode:
authorEgor Tensin <Egor.Tensin@gmail.com>2021-04-18 20:08:03 +0300
committerEgor Tensin <Egor.Tensin@gmail.com>2021-04-18 20:08:03 +0300
commit426c3f344aadb100215bca6d0d86a3016986579f (patch)
treee70615da5c53ffac4417bd601cb175c03b9e9a8b /README.md
parenttools: bring back the .py extension (diff)
downloadcmake-common-426c3f344aadb100215bca6d0d86a3016986579f.tar.gz
cmake-common-426c3f344aadb100215bca6d0d86a3016986579f.zip
README: update
Diffstat (limited to 'README.md')
-rw-r--r--README.md28
1 files changed, 24 insertions, 4 deletions
diff --git a/README.md b/README.md
index a407c47..aa7cdde 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,24 @@ Various utilities to help develop C++/CMake projects.
Installation
------------
- pip install cmake-common
+* Via PyPI:
+
+ pip install cmake-common
+
+* As a submodule:
+
+ git submodule add https://github.com/egor-tensin/cmake-common.git
+
+ All the scripts provided by the PyPI package are thin wrappers around the
+ `project` package modules:
+
+ | Script | Module
+ | -------------- | ------
+ | boost-download | `python3 -m project.boost.download`
+ | boost-build | `python3 -m project.boost.build`
+ | cmake-build | `python3 -m project.cmake.build`
+ | ci-boost | `python3 -m project.ci.boost`
+ | ci-cmake | `python3 -m project.ci.cmake`
Toolchains
----------
@@ -34,8 +51,11 @@ limited to:
1. Both GNU `make` and MinGW `mingw32-make`.
2. Boost 1.69.0 or higher only.
-All of those are verified continuously by the "Boost (toolsets)" and "Examples
-(toolsets)" workflows.
+All of those are verified continuously by the [Boost (toolsets)] and [Examples
+(toolsets)] workflows.
+
+[Boost (toolsets)]: https://github.com/egor-tensin/cmake-common/actions/workflows/boost_toolsets.yml
+[Examples (toolsets)]: https://github.com/egor-tensin/cmake-common/actions/workflows/example_toolsets.yml
Usage
-----
@@ -88,7 +108,7 @@ They work by calling the generic scripts from above, auto-filling some
parameters from environment variables.
| | Travis | AppVeyor | GitHub Actions
-| ----------------- | ------------------------------------ | ------------------------------------------ | ------------------------------------
+| ----------------- | ------------------------------------ | ------------------------------------------ | --------------
| `--toolset` | `$TOOLSET` | `%TOOLSET%` | `$TOOLSET`
| `--platform` | `$PLATFORM` | `%PLATFORM%` | `$PLATFORM`
| `--configuration` | `$CONFIGURATION` | `%CONFIGURATION%` | `$CONFIGURATION`