zephyr/doc
Théo Battrel 909ad8170c Bluetooth: Host: Deprecate auto name in AD
Deprecate the advertiser options `BT_LE_ADV_OPT_USE_NAME` and
`BT_LE_ADV_OPT_FORCE_NAME_IN_AD`.

Reasons:

- It is out of place in the advertiser options, as it acts on
  advertising data and not configuration
- The behavior is not clear. All of these are trick questions:
  - where does the data for the name go?
  - do I have to allocate memory for this?
  - does it work the same in legacy vs extended advertising?
- The trade-off between UX improvement and extra complexity in the host
  is debatable. Hundreds of lines in the stack to avoid making the user
  type out less than ten.

Also deprecate the following macros that uses those options:

- `BT_LE_ADV_CONN_NAME`
- `BT_LE_ADV_CONN_NAME_AD`
- `BT_LE_ADV_NCONN_NAME`
- `BT_LE_EXT_ADV_CONN_NAME`
- `BT_LE_EXT_ADV_SCAN_NAME`
- `BT_LE_EXT_ADV_NCONN_NAME`
- `BT_LE_EXT_ADV_CODED_NCONN_NAME`

Update the migration guide and the release note for Zephyr 3.7 to
describe those changes.

Signed-off-by: Théo Battrel <theo.battrel@nordicsemi.no>
2024-04-23 12:42:24 +02:00
..
_doxygen include/zephyr: Add 'version' and 'since' tag to groups 2024-03-19 13:13:45 +01:00
_extensions/zephyr doc: _extensions: support snippets option 2024-03-26 11:14:46 -05:00
_scripts doc: scripts: redirects: fix redirect for arduino_uno_r4_minima 2024-04-11 15:51:33 -04:00
_static doc: Make search engine configurable 2023-12-15 04:34:48 -05:00
_templates doc: Make search engine configurable 2023-12-15 04:34:48 -05:00
build doc: develop: application: Fix missed HWMv2 changes 2024-04-18 08:06:49 -07:00
connectivity Bluetooth: Shell: Remove usage of auto name in AD 2024-04-23 12:42:24 +02:00
contribute doc: guidelines: add a note about ascii and emojis 2024-04-05 11:54:39 +02:00
develop doc: develop: application: Fix missed HWMv2 changes 2024-04-18 08:06:49 -07:00
hardware doc: Add Xtensa HiFi documentation 2024-04-22 15:21:15 -04:00
images doc: remove unused images 2021-07-19 20:06:00 -04:00
introduction bluetooth: mesh: Doc fix Bluetooth mesh to Mesh 2023-12-01 10:56:18 +00:00
kernel arch: rename arch_start_cpu() to arch_cpu_start() 2024-03-25 09:58:35 +00:00
project doc: fix typo in multiple directories (build, hardware, kernel, project) 2024-01-26 13:16:18 +01:00
releases Bluetooth: Host: Deprecate auto name in AD 2024-04-23 12:42:24 +02:00
safety docs: safety: Add safety documentation 2023-06-22 06:01:39 -04:00
security doc: security: CVE-2024-3077 left embargo 2024-04-04 12:22:57 -04:00
services doc: posix: mark ftruncate as supported 2024-04-22 04:33:16 -07:00
templates doc: Update sample.tmpl with new directive 2023-09-06 12:11:28 +02:00
404.rst doc: Suggest filing GitHub issue for broken links 2022-04-28 10:26:03 +02:00
CMakeLists.txt doc: enable Sphinx tracebacks 2023-07-12 09:13:49 -04:00
conf.py doc: generate sitemap.xml 2024-04-03 12:34:04 +03:00
glossary.rst doc: add board terminology section to board porting guide 2024-03-20 13:00:55 +01:00
index-tex.rst doc: pdf: Add Glossary of Terms to PDF output 2023-11-13 12:17:51 -05:00
index.rst docs: safety: Add safety documentation 2023-06-22 06:01:39 -04:00
kconfig.rst doc: use new kconfig extension 2022-03-02 09:28:37 +01:00
known-warnings.txt doc: Revert "doc: Add more known-warnings" 2023-09-15 15:05:23 +02:00
LICENSING.rst docs: licensing: update list of 3rd party code licensed under GPL 2024-02-23 18:27:32 +01:00
Makefile doc: align pseudo-Makefile with latest CMake changes 2023-07-13 14:27:56 +02:00
requirements.txt doc: generate sitemap.xml 2024-04-03 12:34:04 +03:00
substitutions.txt doc: New developer getting started guide 2019-11-13 14:05:47 -06:00
zephyr.doxyfile.in Bluetooth: Rename BT_BREDR to BT_CLASSIC 2024-03-07 11:26:45 +02:00