exceptions chapter is confusing
Nobody has claimed this yet.
Assessment
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 35/100
- Issue type
- Documentation
- Clarity
- Mostly clear
- Activity status
- Stale
- Tech stack
- rust
- Domain
- documentation, embedded-iot
Research direction
Start with the exceptions chapter at https://rust-embedded.github.io/book/start/exceptions.html#exceptions and read the quoted passages in context. Clarify the distinction between hardware exceptions, interrupts, compilation errors, and the safety of static mut variables in exception handlers. Done means the chapter's flow and conclusion are understandable to readers coming from a software background.
Written by the indexing model from the issue text.
Description
https://rust-embedded.github.io/book/start/exceptions.html#exceptions
Exceptions, and interrupts, are a hardware mechanism -> thus exceptions are a hardware mechanism. When coming from a software background exception are only known as language construct. This can use some more clarification. Also the explanation of interrupts as well.
Following the previous example, the statement SysTick(); would result in a compilation error.
This behavior is pretty much intended and it's required to provide a feature: static mut variables declared inside exception handlers are safe to use.
How can it be safe when you get a compilation error? Explain safe.
Yet I just told that exception handlers can safely use static mut variables.
don't know about that, as far as i know you get a compilation error. Don't understand the flow of the text and it's conclusion here
- Dominant language
- No language data
- Stars
- 1.3k
- Forks
- 223
- PR merge metrics
- No merged PRs in 30d
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from rust-embedded/book
-
Difficulty 1/5 Under an hour Newbie friendliness 75/100
rust-embedded/book#414 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 62/100
rust-embedded/book#370 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
rust-embedded/book#345 · 2 reactions ·
-
Difficulty 1/5 Under an hour Newbie friendliness 68/100
rust-embedded/book#208 ·
-
Difficulty 1/5 1-3 hours Newbie friendliness 65/100
rust-embedded/book#147 ·
All issues in rust-embedded/book
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
bancolombia/sentinel#22 ·
-
test md OpenCI
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
-
optimization optimization:agents-md-curator
Difficulty 2/5 1-3 hours Newbie friendliness 86/100
githubnext/gh-aw-cao#13143 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 94/100
objectionary/hone-maven-plugin#1061 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
redhat-developer/rhdh-plugins#4887 · 2 comments ·