Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Inconsistency between AsciiDoc version and LaTeX version of unpriv spec #1035

Closed
ZenithalHourlyRate opened this issue May 5, 2023 · 9 comments

Comments

@ZenithalHourlyRate
Copy link
Contributor

It seems that the main branch switched to a AsciiDoc version of unpriv spec and it is released. However, after some rough inspection (when writing this) of the new release I found that some changes of the LaTeX version were not in the AsciiDoc version, for example,

f5f9c27
db7a4a0

are not in https://github.com/riscv/riscv-isa-manual/blob/63aeaada9b2fee7ca15e5c6b6a28f3b710fb7e58/src/naming.adoc

Are there any measures taken to ensure that the AsciiDoc version contains all the changes of the LaTeX version? Or should we "backport" these commits one by one?

@wmat
Copy link
Collaborator

wmat commented May 5, 2023

Yes, prior to releasing the asciidoc version, a line by line comparison was done between the asciidoc version and the latex version. It would seem that this change may have slipped in after that comparison was completed. I'm happy to make these changes to the asciidoc version, or would you prefer to issue a pull request?

@gfavor
Copy link
Collaborator

gfavor commented May 5, 2023 via email

@ZenithalHourlyRate
Copy link
Contributor Author

would you prefer to issue a pull request?

#1036. Seems that a lot of changes were not applied.

@gfavor
Copy link
Collaborator

gfavor commented May 5, 2023 via email

@wmat
Copy link
Collaborator

wmat commented May 5, 2023

Greg, I had been monitoring the LaTeX master branch for changes and manually applying them to the asciidoc branch prior to switching over. Note that the master latex branch was renamed to the latex branch on which the last commit was April 18th. Any new changes to LaTeX after that date should only be to content in the Privileged spec.

I'm not sure how the change was missed, as I'd normally see the commit by Andrew in my inbox. I do not have a commit email for these changes for some reason. Going forward I'll monitor GitHub daily instead of relying on email notifications.

@gfavor
Copy link
Collaborator

gfavor commented May 5, 2023 via email

@ZenithalHourlyRate
Copy link
Contributor Author

Is there a belief that #1036 covers all the missing changes?

No. I only checked naming.tex/adoc.

@wmat
Copy link
Collaborator

wmat commented May 5, 2023

Closing with merge of #1036 . Will audit LaTeX commits for any other missed commits.

@wmat wmat closed this as completed May 5, 2023
@aswaterman
Copy link
Member

Following up on what @gfavor wrote, this won't happen again going forward, since all future work will happen exclusively on the AsciiDoc source. But I agree, @wmat, that a manual auditing of the last few months' commits is advisable.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

4 participants