Skip to content

Documentation: Tweak text about Zero Latency Interrupts#15122

Merged
xiaoxiang781216 merged 1 commit into
apache:masterfrom
hartmannathan:doc-zero-latency-interrupt
Dec 10, 2024
Merged

Documentation: Tweak text about Zero Latency Interrupts#15122
xiaoxiang781216 merged 1 commit into
apache:masterfrom
hartmannathan:doc-zero-latency-interrupt

Conversation

@hartmannathan

Copy link
Copy Markdown
Contributor

This is a follow-up to 366c8a5 (PR #15102).

Note: Please adhere to Contributing Guidelines.

Summary

This is a follow-up to PR #15102, which is itself a follow-up to several PRs: PR #15073, PR #15086. Previously, there were two alternative implementations for enabling and disabling interrupts on ARM Cortex M3/M4 (armv7m, armv8m) architectures: PRIMASK or BASEPRI. BASEPRI is better than PRIMASK in that it is a superset of PRIMASK functionality. Previously there was a Kconfig option, CONFIG_ARMV7M_USEBASEPRI, to choose which implementation was used, and conditional logic in the code. This Kconfig and alternative PRIMASK implementation were removed and BASEPRI is always used now.

This follow-up tweaks some of the Documentation about Zero Latency Interrupts to improve clarity.

Impact

Improved documentation. No functional changes in the OS.

Testing

Proofreading. :-)

This is a follow-up to 366c8a5 (PR-15102).

* Documentation/guides/zerolatencyinterrupts.rst
  (Title): Make title case consistent.
  (Getting Back into the Game, Maskable Nested Interrupts): Clarify discussion
   about priorities.
  (Cortex-M3/4 Implementation): The first half of a sentence was deleted in
   366c8a5 because the Kconfig that was described there no longer exists:
   CONFIG_ARMV7M_USEBASEPRI. Write a new beginning for this sentence that
   matches current implementation.
  (Disabling the High Priority Interrupt): Change "cannot" to "must not be
   allowed to" to improve clarity.
  (Configuring High Priority Interrupts): Change "to NVIC" to "in NVIC" to
   improve clarity.
@github-actions github-actions Bot added Area: Documentation Improvements or additions to documentation Size: S The size of the change in this PR is small labels Dec 10, 2024
@nuttxpr

nuttxpr commented Dec 10, 2024

Copy link
Copy Markdown

[Experimental Bot, please feedback here]

Yes, this PR appears to meet the NuttX requirements. The summary clearly explains the purpose, the impact section is comprehensive, and while there's no executable test code, the nature of the change (documentation update) justifies the "proofreading" approach to testing. The cross-referencing to prior PRs is also helpful.

@xiaoxiang781216 xiaoxiang781216 merged commit 5607eec into apache:master Dec 10, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Area: Documentation Improvements or additions to documentation Size: S The size of the change in this PR is small

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants