summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorOliver Reiche <oliver.reiche@huawei.com>2023-08-18 18:45:32 +0200
committerOliver Reiche <oliver.reiche@huawei.com>2023-08-22 14:50:35 +0200
commit307c96681e6626286804c45273082dff94127878 (patch)
treea7186dce6766d4904cb76a880432d909fe722370 /README.md
parent4df77c2cfc163e6ec2ae8a3512e633496cf7de28 (diff)
downloadrules-cc-307c96681e6626286804c45273082dff94127878.tar.gz
Update documentation
Diffstat (limited to 'README.md')
-rw-r--r--README.md14
1 files changed, 14 insertions, 0 deletions
diff --git a/README.md b/README.md
index 7a55bc1..1c8c25b 100644
--- a/README.md
+++ b/README.md
@@ -113,6 +113,20 @@ A prebuilt C++ library
| `"deps"` | Any other libraries this library depends upon. |
| `"pkg-config"` | Pkg-config file for optional infer of public cflags and ldflags. If multiple files are specified (e.g., one depends on the other), the first one is used as entry. Note that if this field is non-empty the tool `"pkg-config"` must be available in `"PATH"`, which is taken from `["CC", "defaults"]` or the `"ENV"` variable. |
+### Rule `["CC/pkgconfig", "system_library"]`
+
+A system library via pkg-config
+
+| Field | Description |
+| ----- | ----------- |
+| `"name"` | The pkg-config name of the library. |
+| `"args"` | Additional pkg-config arguments (e.g., `"--define-prefix"` or `"--static"`), appended to the config variable `"PKG_CONFIG_ARGS"`. |
+| `"stage"` | The stage of the internally created flag files. |
+
+| Config variable | Description |
+| --------------- | ----------- |
+| `"PKG_CONFIG_ARGS"` | Additional pkg-config arguments (e.g., `"--define-prefix"` or `"--static"`). |
+
### Rule `["CC", "install-with-deps"]`
Install target's artifacts with transitive dependencies. Depending on the target, artifacts and dependencies will be installed to subdirectories `"bin"`, `"include"`, and `"lib"`. For library targets, a pkg-config file is generated and provided in `"lib/pkgconfig"`.