Merge pull request riscv#1841 from RISC-V-Certification-Steering-Committee/main

Changes to support building priv & unpriv as adoc "parts" in a larger adoc "book"

Author: wmat

src/colophon.adoc

@@ -1,6 +1,12 @@
 [colophon]
-= Preface
-
+== Preface
+// Had to make the above a level 1 heading (two equals signs) to avoid error when building
+// the ISA manual as a book with other "parts". This is opposite to what the adoc says to do
+// but otherwise asciidoctor creates the error messsage:
+//
+// asciidoctor: ERROR: ext/riscv-isa-manual/src/colophon.adoc: line 2: invalid part, must have at least one section (e.g., chapter, appendix, etc.)
+//
+// See asciidoctor doc which seems wrong: https://docs.asciidoctor.org/asciidoc/latest/sections/colophon/
 
 This document describes the RISC-V unprivileged architecture.
 

src/priv-preface.adoc

@@ -1,5 +1,12 @@
 [colophon]
-= Preface
+== Preface
+// Had to make the above a level 1 heading (two equals signs) to avoid error when building
+// the ISA manual as a book with other "parts". This is opposite to what the adoc says to do
+// but otherwise asciidoctor creates the error messsage:
+//
+// asciidoctor: ERROR: ext/riscv-isa-manual/src/priv-preface.adoc: line 2: invalid part, must have at least one section (e.g., chapter, appendix, etc.)
+//
+// See asciidoctor doc which seems wrong: https://docs.asciidoctor.org/asciidoc/latest/sections/colophon/
 
 [.big]*_Preface to Version 20241101_*
 

src/riscv-privileged.adoc

@@ -1,4 +1,4 @@
-[[risc-v-isa]]
+[[manual:priv,RISC-V ISA Manual Volume II: Privileged Architecture]]
 = The RISC-V Instruction Set Manual: Volume II: Privileged Architecture
 include::../docs-resources/global-config.adoc[]
 :description: Volume II - Privileged Architecture

src/riscv-unprivileged.adoc

@@ -1,4 +1,4 @@
-[[risc-v-isa]]
+[[manual:unpriv,RISC-V ISA Manual Volume I: Unprivileged Architecture]]
 = The RISC-V Instruction Set Manual Volume I: Unprivileged Architecture
 include::../docs-resources/global-config.adoc[]
 :description: Unprivileged Architecture