rust-embedded/rust-raspberrypi-OS-tutorials

Invalid links in 11_exceptions_part1_groundwork/README.md

Tartasprint opened this issue · 2 comments

In the README.MD of chapter 11 there are some references to the "Arm Architecture Reference Manual for A-profile architecture":

I recommend to read pages 1874-1876 of the [ARMv8 Architecture Reference Manual][ARMv8_Manual] to

an `asynchronous` exception. Details in Chapter D1.10.1 of the [ARMv8 Architecture Reference
Manual][ARMv8_Manual].

with the [ARMv8_Manual] referring to:

[ARMv8_Manual]: https://developer.arm.com/docs/ddi0487/latest/arm-architecture-reference-manual-armv8-for-armv8-a-architecture-profile

The problem is that this link refers to the latest version of the manual, but the text is referring to another version. I went through various versions of the ARM manual but couldn't find the one being referred to.

In older versions (such as E.a) section D1.10.1 is "Preferred exception return address" which should be similar to page 5357 in the current latest version of the document.

I couldn't find what the mentioned pages 1874-1876 were referring to.

I suggest picking a version of the manual and write the references to it with a more permanent link than using "latest" version, to avoid such problems.

While I'm there, I thank Andre Richter and everyone else who has contributed to these fantastic tutorials ! 🥳

Jzow commented

Hi @Tartasprint I checked question about a-profile_architecture_reference_manual.pdf you mentioned.

My simple understanding of the question you raised is that we need to specify the page number in the document corresponding to a specific version of the manual to solve the problem of not finding the corresponding page when updating the new version of the ARM PDF manual.

Hi, yes that is what I meant, thanks for the fix !