search

ARM-software / abi-aa

Application Binary Interface for the Arm® Architecture
Other
878 stars 173 forks source link

Missing page "Semihosting for AArch32 and AArch64" #226

Open harrisonmutai-arm opened 9 months ago

harrisonmutai-arm commented 9 months ago

References to the semihosting documentation appear to be broken:

https://developer.arm.com/documentation/100863/latest

This redirects to the GitHub release page, from this page. u-boot points to this page as well.

stuij commented 9 months ago

This was by design. The semihosting doc is part of the released documents. See the Semihosting doc link under Miscellaneous material, as it's better I think to link to the latest released documentation, instead of to the latest release from head.

There's an idea to make a latest branch that will always point to the latest release of the documentation. Then we could do links to individual documents, although in that scheme it might not be obvious for someone that clicked the link where the pdf document is, and it might not be obvious at all to someone that they're in fact on the latest branch.

stuij commented 9 months ago

to be clear: the latest releases of the ABI and related documentation are now exclusively hosted on Github. I'm not sure where those links to developer.arm.com are coming from, but I did a grep through the ABI documentation, and I didn't find a reference in there at least.

harrisonmutai-arm commented 7 months ago

Apologies @stuij, I've only just seen your response!

See the Semihosting doc link under Miscellaneous material, as it's better I think to link to the latest released documentation, instead of to the latest release from head.

This make sense to me. Although the issue I raised relates more to links from developer.arm.com [1]. My general expectation would be that the links here would redirect to a render of the page rather than the source. Perhaps this isn't the right place to raise issues relating to developer.arm.com? image

[1] https://developer.arm.com/documentation/100961/1122/Programming-Reference/Semihosting?lang=en

stuij commented 6 months ago

Yes, we who deal with the docs here are unrelated to the developer.arm.com maintainers. Best to take this up with them directly, but I do know that a number of people would prefer or at least would like the option to use the PDF version. If you link straight to the web version, it'll be non-obvious to them where to find it. At least this way you have the option at the expense of extra clicking.