RISC-V International

Page tree
Skip to end of metadata
Go to start of metadata

Overview

Send an email to help@riscv.org to volunteer.

Found an issue? Please email help@riscv.org and elisa@riscv.org.

Latest Asciidoc PDF: https://github.com/riscv/riscv-isa-manual/blob/convert2adoc/src/riscv-isa-unpr-conv-review.pdf

Latest Latex PDF: https://github.com/riscv/riscv-isa-manual/releases  (see: Latest Release PDF)

Known Issues

ALERT: Currently the chapter number differ, starting with Chapter 15 in the AsciiDoc version, from the LaTeX version, due to new chapters for Zfh and Zfinx, in non-final state.

We need to pay attention to the diagrams and larger tables to ensure their accuracy for the following reasons:

  • Some of the larger tables didn’t convert cleanly. The data is there but is sometimes not lining up properly, perhaps because Pandoc inserted one or more extra cells that caused one or more misalignments. Some tables might benefit from being broken into a series of tables.
  • All wavedrom diagrams must be checked for accuracy

In addition, a check of the following elements for which the conversion was less reliable than for text (we're indicating the reasons that checking is needed in case this helps):

  • Latexmath expressions; for some expressions, Pandoc inserted extraneous, non-printing characters (most have now been removed), but the fact that this happened  indicate an additional error.
  • Missing bibliographic entries; there are instances where Pandoc removed some bibliographic entries without leaving any trace.
  • Internal cross references; no LaTeX cross references converted cleanly.
  • Non-normaltive text block formatting; Pandoc did not convert this formatting. Most non-normative text formatting is now in admonition blocks, but some might have been missed.

Conversion took place without any freezes with respect to updates. While many chapters were stable and an effort was made to capture updates, please do a check on the history of the chapter on which you are working.

In the later chapters (14-15, and parts of 16) there are some diagrams that for now are indicated by recognizable artifacts of the conversion from LaTeX in the asciidoc. If anyone knows the history behind the fact that these don't appear to be in the opcodes repo please let us know. It seems that we need to generate the Wavedrom scripts for these, and help will be appreciated.

Unpriv Spec Chapters Review

This table documents the status of each of the unprivileged specification chapters and the community member currently assigned to the review

Chapter #Name hintPage CountReviewerProjected completion dateLink to git PR or discussionStatusDiagrams
CoverCover1N/A



TOCTOC4N/A



ColophonPreamble1Vedvyas Shanbhogue
https://github.com/riscv/riscv-isa-manual/pull/749donen/a
PrefacePreface8Vedvyas Shanbhogue
https://github.com/riscv/riscv-isa-manual/pull/749donen/a
1Introduction10Andrew Waterman10/8 https://github.com/riscv/riscv-isa-manual/pull/750 and https://github.com/riscv/riscv-isa-manual/commit/364c03e71fd206c030d1ffb13b50f91ffd910be4text done
2RV32I15Andrew Waterman10/8 https://github.com/riscv/riscv-isa-manual/pull/750 and https://github.com/riscv/riscv-isa-manual/commit/364c03e71fd206c030d1ffb13b50f91ffd910be4text done
3Zfencei3Aaron Durbin9/30noneDone
4Zhintpause1Aaron Durbin9/30https://github.com/riscv/riscv-isa-manual/pull/746DoneDone
5RV32e1Richard Van10/1
Done
6RV64I3Richard Van10/1
Text done
7RV128I1Richard Van10/1
Text done
8M2Richard Van10/1
Text done
9A6Richard Van10/7
reviewed
10Zicsr3Richard Van10/7
reviewed
11Counters4Allen Baum10/1N/Atext done
12F10Vedvyas Shanbhogue10/12https://github.com/riscv/riscv-isa-manual/pull/751Done https://github.com/riscv/riscv-isa-manual/pull/751
13D5




14Q5




15RVWMO5Dan Lustig10/6https://github.com/riscv/riscv-isa-manual/pull/753Done.
16C13Andrew Waterman10/8


17B1Stephano10/8
Done.
18J1Stephano10/8
Done.
19P1Stephano10/8
Done.
20V1Stephano10/8
Done.
21Zam1Stephano10/8
Done.
22Ztso1Stephano10/8
Done.
23RV32/64G14Vedvyas Shanbhogue10/18https://github.com/riscv/riscv-isa-manual/pull/755DoneDone
24Extending6Vedvyas Shanbhogue10/15https://github.com/riscv/riscv-isa-manual/pull/754DoneDone
25Naming4Alan Baum10/8


26History6




Appendix AA31Dan Lustig(optional)


Appendix BB
Dan Lustig(optional)


index

(procedure in example.pdf)

index2N/A



bibliobiblio2N/A



backback1N/A



Glossary

(separate repo)

Glossary8N/A



Wavedrom Diagrams

The following table is for review of Wavedrom scripts in src/images/wavedrom and fixes to the diagrams. For details about Wavedrom integration with Asciidoctor along with the file structure that we are using, please see section 2.3.2 in the example.pdf.

NOTE: While the Wavedrom diagrams themselves are generated from javascript, the javascript code for each diagram exists in AsciiDoc files. Each diagram file is referenced from within a specification chapter. With apologies, we have not established diagram naming conventions. If you have suggestions about diagram names, please email those suggestions to help@risv-org.

diagram filenameedited or added (Y/N)

Reviewed

(Y/N)

Wavedrom Diagram EditorWavedrom Diagram Reviewerfound in chapter(s)chapter reviewerLink to edits

atomic-mem.adoc

YYHenry (VRULL)Henry (VRULL)AtmoicRichard Vanhttps://github.com/riscv/riscv-isa-manual/pull/775
c-cb-format-ls.adocYYElisaElisaC extAndrew Watermanhttps://github.com/riscv/riscv-isa-manual/commit/7224171878f7ceb2adcfbd5cc07c19f531e280a1
c-cj-format-ls.adocYYElisaElisaC ext

Andrew

Waterman

https://github.com/riscv/riscv-isa-manual/commit/f6bfb73aa06f41fd26bd7cd4f8e46d699d2f833d
c-cj-format-ls.adocYYElisaElisaC ext

Andrew

Waterman

https://github.com/riscv/riscv-isa-manual/commit/f6bfb73aa06f41fd26bd7cd4f8e46d699d2f833d
c-cr-register.adocYYElisaElisaC extAndrew Watermanhttps://github.com/riscv/riscv-isa-manual/commit/7224171878f7ceb2adcfbd5cc07c19f531e280a1
c-integer-const-gen.adocYYElisaElisaC extAndrew Watermanhttps://github.com/riscv/riscv-isa-manual/commit/7224171878f7ceb2adcfbd5cc07c19f531e280a1
c-integer-reg-immed.adocYYElisaElisaC extAndrew Watermanhttps://github.com/riscv/riscv-isa-manual/commit/7224171878f7ceb2adcfbd5cc07c19f531e280a1

c-sp-load-store.adoc

YYElisaElisaC ext

Andrew

Waterman

https://github.com/riscv/riscv-isa-manual/commit/f6bfb73aa06f41fd26bd7cd4f8e46d699d2f833d
c-sp-load-store-css.adocYYElisaElisaC ext

Andrew

Waterman

https://github.com/riscv/riscv-isa-manual/commit/f6bfb73aa06f41fd26bd7cd4f8e46d699d2f833d

counters-diag.adoc

YYAllen BaumAllen Baum11, CountersAllen Baumhttps://github.com/riscv/riscv-isa-manual/commit/a4954af2fd406e6f7fb9a1925d5b870c6bb155ec

cr-register.adoc








csr-instr.adoc

YYElisaElisaZiCSRRichard Vanhttps://github.com/riscv/riscv-isa-manual/commit/4f7e910f4d3bfb3008bbf9f017c61159ed09dfa6

ct-conditional.adoc








ct-unconditional.adoc








d-xwwx.adoc








division-op.adoc








double-fl-class.adoc



Henry (VRULL)Henry (VRULL)Double

double-fl-compare.adoc



Henry (VRULL)Henry (VRULL)Double

double-fl-compute.adoc



Henry (VRULL)Henry (VRULL)Double

double-fl-convert-mv.adoc



Henry (VRULL)Henry (VRULL)Double

double-ls.adoc



Henry (VRULL)Henry (VRULL)Double

env_call-breakpoint.adoc








fcvt-sd-ds.adoc








float-csr.adoc

YYved-rvosved-rvosf-st-extved-rvos https://github.com/riscv/riscv-isa-manual/pull/751

fnmaddsub.adoc








fsjgnjnx-d.adoc








half-ls.adoc








hint-nopv_rv32i.adoc








hint-nopv_rv64i.adoc








immediate.adoc








immediate_variants.adoc








instruction_formats.adoc








int-comp-lui-aiupc.adoc








int-comp-slli-srli-srai.adoc








int_reg-reg.adoc








integer_computational.adoc








load-reserve-st-conditional.adoc








load_store.adoc








m-st-ext-for-int-mult.adoc








mem_order.adoc








nop-v.adoc








nop.adoc








nopv_rv32i.adoc








quad-cnvrt-intch-xqqx.adoc








quad-cnvrt-mv.adoc








quad-cnvt-interchange.adoc








quad-compute.adoc








quad-float-clssfy.adoc








quad-float-compare.adoc








quad-ls.adoc








reg-based-ldnstr.adocY
Elisa
C-st-extAndrew Waterman

rv64_lui-auipc.adoc








rv64i-addiw.adoc








rv64i-base-int.adoc








rv64i_int-reg-reg.adoc








sp-base-ls-2.adoc








sp-load-store.adoc

YYved-rivosved-rivosf-st-extved-rivos https://github.com/riscv/riscv-isa-manual/pull/751

spfloat-classify.adoc

YYved-rivosved-rivosf-st-extved-rivos https://github.com/riscv/riscv-isa-manual/pull/751

spfloat-cn-cmp.adoc

YYved-rivosved-rivosf-st-extved-rivos https://github.com/riscv/riscv-isa-manual/pull/751

spfloat-comp.adoc

YYved-rivosved-rivosf-st-extved-rivos https://github.com/riscv/riscv-isa-manual/pull/751

spfloat-mv.adoc

YYved-rivosved-rivosf-st-extved-rivos https://github.com/riscv/riscv-isa-manual/pull/751

spfloat.adoc

YYved-rivosved-rivosf-st-extved-rivos https://github.com/riscv/riscv-isa-manual/pull/751

zifencei-fetch.adoc








zifencei-ff.adoc








zihintpause-hint.adoc








  • No labels