Skip to content

Conversation

mathieuchopstm
Copy link
Contributor

(draft until #96962 is merged)

Update documentation related to platform hooks:

  • make sure the hook functions' documentation is actually visible - currently, the dummy no-op macros are seen instead (c.f. https://docs.zephyrproject.org/latest/doxygen/html/hooks_8h.html)
  • update architecture porting documentation to include a section about hooks that must be implemented in arch-specific code
    • this should reflect current practices and expectations

The hooks' signature was not visible to Doxygen due to preprocessor
conditionals - instead, the dummy no-op implementation was seen instead.

Update #ifdef guard to make the hooks' signature and the associated
documentation visible to Doxygen such that it appears in docs.

Also fix a tiny typo on soc_reset_hook()'s documentation comment.

Signed-off-by: Mathieu Choplain <[email protected]>
Document the expected early boot sequence and when platform hooks should be
called by the arch-specific coode, and under what conditions.

Signed-off-by: Mathieu Choplain <[email protected]>
Copy link

sonarqubecloud bot commented Oct 7, 2025

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant