zephyr/doc
Gerard Marull-Paretas fdea3c9a44 devicetree: add DT(_INST)_FOREACH_PROP_ELEM_SEP(_VARGS)
Add a new set of helpers for expanding property entries with a
separator. These macros complement DT(_INST)FOREACH_PROP_ELEM(_VARGS) by
adding the capability to expand with a custom separator between property
entries. This allows, in some cases, to re-use existing macros (e.g.
DT_PROP_BY_IDX) without creating an auxiliary macro that just appends a
separator. Example:

```dts
n: node {
	...
	my-gpios = <&gpioa 0 GPIO_ACTIVE_HIGH>,
		   <&gpiob 1 GPIO_ACTIVE_HIGH>;
};
```

Before:

```c
 #define GPIO_DT_SPEC_BY_IDX_AND_COMMA(node_id, prop, idx) \
	GPIO_DT_SPEC_BY_IDX(node_id, prop, idx),

struct gpio_dt_spec specs[] = {
	DT_FOREACH_PROP_ELEM(DT_NODELABEL(n), my_gpios,
			     GPIO_DT_SPEC_BY_IDX_AND_COMMA)
};
```

After:

```c
struct gpio_dt_spec specs[] = {
	DT_FOREACH_PROP_ELEM_SEP(DT_NODELABEL(n), my_gpios,
				 GPIO_DT_SPEC_BY_IDX, (,))
};
```

Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
2022-10-03 10:11:18 +02:00
..
_doxygen doc: Update HTML documentation Zephyr logo 2022-06-06 00:02:55 +09:00
_extensions/zephyr doc: extend application sphinx extension to support west arguments 2022-08-12 13:56:55 +02:00
_scripts doc: gen_devicetree_rest: Fix binding doc file name resolution 2022-07-25 15:18:27 +02:00
_static doc: Update PDF documentation Zephyr logo 2022-06-06 00:02:55 +09:00
_templates
build devicetree: add DT(_INST)_FOREACH_PROP_ELEM_SEP(_VARGS) 2022-10-03 10:11:18 +02:00
connectivity doc: bluetooth: autopts: Fix internal linking 2022-09-29 12:20:14 +02:00
contribute doc: documentation: Fix incorrect doc/Makefile reference 2022-09-29 12:20:14 +02:00
develop doc: toolchains: Update custom toolchain CMake reference file names 2022-09-29 12:20:14 +02:00
hardware doc: peripherals: i2c: Fix incorrect hyperlink references 2022-09-29 12:20:14 +02:00
images
introduction
kernel doc: mailboxes: Remove memory block-related details 2022-09-28 14:24:34 +00:00
project doc: gh: Add RFC to the list of mandatory labels 2022-06-30 17:01:58 -04:00
releases doc: release: remove "Working Draft" from 3.2 release notes title 2022-09-30 11:31:32 -05:00
security doc: security: Fix outdated link 2022-09-29 12:20:14 +02:00
services doc: logging: Update section about log processing 2022-09-29 08:26:54 -05:00
templates
404.rst doc: Suggest filing GitHub issue for broken links 2022-04-28 10:26:03 +02:00
CMakeLists.txt doc: add support for linkcheck 2022-09-23 17:28:47 +00:00
conf.py doc: conf: add release version 3.2.0 2022-09-30 11:31:32 -05:00
glossary.rst
index-tex.rst doc: get rid of reference section 2022-04-07 16:35:19 +02:00
index.rst doc: get rid of reference section 2022-04-07 16:35:19 +02:00
kconfig.rst
known-warnings.txt doc: Bluetooth: Document the services APIs 2022-05-24 17:49:17 +02:00
LICENSING.rst
Makefile doc: add support for linkcheck 2022-09-23 17:28:47 +00:00
substitutions.txt
zephyr.doxyfile.in doc: fix embedding of Kconfig links in rst 2022-09-27 07:18:15 -05:00