casaroli opened a new pull request, #21506: URL: https://github.com/apache/nuttx/pull/21506
depends-on: apache/nuttx/pull/21505 This branch holds the commits of #21474, #21493 and #21505, and 1 commit of its own, because the page describes what they do. **Review only the last commit.** It stays a draft until #21505 merges. Part of #21467, step 5. ## Summary A new page, `Documentation/os/libs/libc/printf.rst`, linked from the libc index. It explains how `printf` works in NuttX: - Each conversion, flag, length, width and precision, with examples and their output. - Each option and profile, and what it prints when it is off. - `?` for a conversion that is off. - What happens on an unknown conversion and on a truncated format. - The boundary of correct and wrong usage: if the compiler accepts the call, it is correct usage. - Flash and stack per profile, with measured numbers. - What is outside the guarantee. ## Impact Documentation only. No code changes. ## Testing Each example is real: the output on the page comes from a run of the same calls on NuttX, `rv-virt:nsh` under QEMU, with the Full profile, and with all options off for the table of what a feature prints when it is off. The size tables come from the builds of #21505. `sphinx-build -M html . _build -W --keep-going` with Sphinx 6.2.1 from the Pipfile: no warning from this page. The one warning of the run is `plantuml command cannot be run` in another page: this host has no `plantuml`. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
