Information about C23 project added as subsection in 'Runtime Libraries and API' section.
Please make the feedback in this review. I changed the structure of the relnotes adding this subsection, it would be good to hear about it before I land this page.
Details
Details
- Reviewers
fuz - Group Reviewers
releng - Commits
- R9:6ae5bfd63815: 15.1/relnotes: C23 Language Support
Diff Detail
Diff Detail
- Repository
- R9 FreeBSD doc repository
- Lint
Lint Not Applicable - Unit
Tests Not Applicable
Event Timeline
Comment Actions
I think this is a bit too verbose. We don't need to list every single API change, as most of them are rather minor and uninteresting.
Perhaps do one paragraph just listing the new interfaces of interest. Maybe
Partial support for the C23 version of the C Programming language is now available. It will continue to evolve, with complete support anticipated for FreeBSD 16. New features include the <stdbit.h> header, the memalignment() function, updates to the <limits.h> and <stdint.h> headers including the _WIDTH macros and char8_t, as well as various other extensions.
I do not like the superfluous extra sentences you put after the features. “This provides standard-conforming APIs for applications using these functions.” is not a useful sentence and shut just be left out. You also do not need to mention that man pages are included. We always include man pages, tat's just assumed by default. Instead perhaps add links to the man pages to the release notes. Likewise, please also do not say “using C23 features” or “for C23-compliant code” or similar things. These are nonsensical as we provide the new interfaces regardless of whether you select C23 mode or not and in any case this wording makes it read like a bad AI wrote the release notes. Nobody is “affected” by these changes either. It's a new feature, not a bug fix.
Please link to the wiki page if possible.
| website/content/en/releases/15.1R/relnotes.adoc | ||
|---|---|---|
| 464 | This change is not interesting, as it makes no difference in practice. | |
| 470–474 | While this is an interesting item, it doesn't need two paragraphs. Just say that <stdint.h> and <limits.h> have been adapted to C23, which in particular includes the new _WIDTH macros. | |
| 477 | The visibility changes are not that interesting and can be omitted. Also, you already mention this further up. | |
Comment Actions
@ziaee Alexander , what do you think about linking to wiki? Relnotes are long living documents with stable content, but wiki can be changed in any moment.
Comment Actions
While the wiki will continue to evolve, it may be helpful as a pointer to the effort in case people want to know more.
LGTM with or without the wiki link.