From 2b482e39a90fa1929e0fa4006861f4264f28adb2 Mon Sep 17 00:00:00 2001 From: Daniel Mensinger Date: Sat, 21 Aug 2021 16:27:56 +0200 Subject: docs: Add the YAML Reference manual --- docs/yaml/functions/executable.yaml | 46 +++++++++++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 docs/yaml/functions/executable.yaml (limited to 'docs/yaml/functions/executable.yaml') diff --git a/docs/yaml/functions/executable.yaml b/docs/yaml/functions/executable.yaml new file mode 100644 index 000000000..2e57bd4fb --- /dev/null +++ b/docs/yaml/functions/executable.yaml @@ -0,0 +1,46 @@ +name: executable +returns: exe +description: | + Creates a new executable. The first argument specifies its name and + the remaining positional arguments define the input files to use. + + The lists for the kwargs (such as `sources`, `objects`, and `dependencies`) are + always flattened, which means you can freely nest and add lists while + creating the final list. + + The returned object also has methods that are documented in [[@exe]]. + +warnings: + - The `link_language` kwarg was broken until 0.55.0 + +posargs_inherit: _build_target_base +varargs_inherit: _build_target_base +kwargs_inherit: _build_target_base + +kwargs: + export_dynamic: + type: bool + since: 0.45.0 + description: | + when set to true causes the target's symbols to be + dynamically exported, allowing modules built using the + [[shared_module]] function to refer to functions, + variables and other symbols defined in the executable itself. Implies + the `implib` argument. + + implib: + type: bool + since: 0.42.0 + description: | + When set to true, an import library is generated for the + executable (the name of the import library is based on *exe_name*). + Alternatively, when set to a string, that gives the base name for + the import library. The import library is used when the returned + build target object appears in `link_with:` elsewhere. Only has any + effect on platforms where that is meaningful (e.g. Windows). Implies + the `export_dynamic` argument. + + pie: + type: bool + since: 0.49.0 + description: Build a position-independent executable. -- cgit v1.2.3