zephyr/doc
Marcin Niestroj 2d3365200c settings: file: drop CONFIG_SETTINGS_FILE_DIR
There is already CONFIG_SETTINGS_FILE_PATH, which is set to full file path,
while CONFIG_SETTINGS_FILE_DIR is required to be set to its parent
directory. This is redundant, as parent directory path can be easily found
out either during runtime or optionally during buildtime by CMake.

CONFIG_SETTINGS_FILE_DIR was actually introduced recently after Zephyr 3.2
release as a replacement of deprecated CONFIG_SETTINGS_FS_DIR. This means,
that there is no need to deprecate it for 3.3 release and dropping it
should be fine. Adjust 3.3 release notes accordingly, so that
CONFIG_SETTINGS_FILE_PATH will be used directly.

This patch stops using deprecated CONFIG_SETTINGS_FS_DIR. There is actually
no value in respecting it, as setting anything other than parent directory
of CONFIG_SETTINGS_FS_FILE makes no sense.

There is actually one use of CONFIG_SETTINGS_FILE_DIR in file backend
tests, to derive directory for files containing tested settings.
CONFIG_SETTINGS_FILE_PATH is not used there, so it makes little sense to
derive directory name from it. Instead, just use hardcoded "/settings"
subdirectory, as this was the default value of CONFIG_SETTINGS_FILE_DIR.

Deriving parent directory can be done either in runtime or in
buildtime (e.g. using some helper CMake function). Doing it in runtime
however allows to create directory recursively (which this patch actually
implements), e.g. for some more nested FS tree structure. Additionally it
will simplify migration of settings configuration from Kconfig to
device-tree (yet to be developed feature).

Signed-off-by: Marcin Niestroj <m.niestroj@emb.dev>
2022-12-14 14:11:03 +01:00
..
_doxygen device: move independent groups to groups.dox 2022-10-17 10:13:37 +02:00
_extensions/zephyr doc: extensions: kconfig: allow to copy link to results 2022-11-21 15:51:40 +01:00
_scripts doc: gen_devicetree_rest: Fix binding doc file name resolution 2022-07-25 15:18:27 +02:00
_static readme: Add support for light/dark modes in the logo 2022-11-18 08:58:59 +01:00
_templates
build doc: clarify where relative devicetree files are found 2022-11-24 15:22:21 +01:00
connectivity Bluetooth: Mesh: Warn log mode incompatibility with friendship 2022-12-09 11:18:18 +01:00
contribute doc: treewide change requirements 2022-11-02 14:33:56 +01:00
develop math: Introduce a DSP basicmath subsystem with a cmsis backend 2022-12-02 20:15:55 +01:00
hardware cache: Add documentation 2022-12-13 16:31:42 +00:00
images
introduction
kernel drivers: pcie: reintroduce support for I/O BARs 2022-11-01 15:22:31 -04:00
project doc: release process: drop the comment about changing the release name 2022-10-24 11:17:00 -04:00
releases settings: file: drop CONFIG_SETTINGS_FILE_DIR 2022-12-14 14:11:03 +01:00
security doc: vulnerabilities: Add information about CVE-2022-2741 2022-11-01 12:01:00 +01:00
services doc/dfu: Add MCUboot API chapter to documentation 2022-12-10 09:46:35 +01: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: extensions: add custom role 'module_file' 2022-11-11 11:02:03 +01: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 math: Introduce a DSP basicmath subsystem with a cmsis backend 2022-12-02 20:15:55 +01:00