riscv-non-isa / riscv-semihosting

https://lf-riscv.atlassian.net/browse/RVS-2673
Creative Commons Attribution Share Alike 4.0 International
28 stars 8 forks source link

Confusing/unclear text #15

Closed TommyMurphyTM1234 closed 4 months ago

TommyMurphyTM1234 commented 5 months ago

This sentence is grammatically incorrect and it's unclear what exactly it is trying to say so I cannot offer an alternative wording unfortunately:

Only the mechanism of invoke a semihosting service (aka semihosting binary interface) is architecture specific whereas all defined semihosting services [1] are architecture independent and resemble system calls of an unix-style operating system.

"Of invoking" instead of "of invoke"? "Unix" instead of "unix"? But I think that the whole sentence needs a review to be clearer.

ilg-ul commented 5 months ago

The sentence is confusing indeed, but the meaning is probably that the semihosting services themselves as defined by Arm are portable across different architectures, and only the sequence of assembly instructions used to encode a dedicated break instruction is specific to each architecture.

avpatel commented 4 months ago

The sentence is confusing indeed, but the meaning is probably that the semihosting services themselves as defined by Arm are portable across different architectures, and only the sequence of assembly instructions used to encode a dedicated break instruction is specific to each architecture.

I will reword the text based on this suggestion.