Merge pull request riscv-non-isa#114 from axel-h/patch-axel-20241123

Add CI workflow to create PDF/HTML

.github/workflows/build-doc.yml

@@ -0,0 +1,71 @@
+name: Create Document
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+  release:
+    types:
+      - created
+
+# Cancel any older workflow runs for PRs that are still in progress, so
+# pushing quickly several times does not create too much load.
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event_name == 'pull_request' && format('pr-{0}', github.event.number) || format('run-{0}', github.run_id) }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout repository
+      uses: actions/[email protected]
+      with:
+        submodules: recursive
+    - name: Run build
+      run: make docker-pull-latest build
+      env:
+        VERSION: v${{ github.event.inputs.version }}
+        REVMARK: ${{ github.event.inputs.revision_mark }}
+    - name: Upload artifacts
+      uses: actions/[email protected]
+      with:
+        name: riscv-asm-manual.zip
+        path: |
+            build/riscv-asm.pdf
+            build/riscv-asm.html
+
+  release-draft:
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Download artifacts
+        uses: actions/[email protected]
+      - name: Get timestamp
+        id: date
+        run: echo "RELEASE_DATE=$(date --utc +'%Y%m%d-%H%M%S')" >> $GITHUB_OUTPUT
+      - name: Create draft release
+        uses: softprops/[email protected]
+        with:
+          draft: true
+          name: Draft release ${{ steps.date.outputs.RELEASE_DATE }}
+          body: Snapshot (${{ github.sha }})
+          files: |
+            riscv-asm-manual.zip/riscv-asm.pdf
+            riscv-asm-manual.zip/riscv-asm.html
+
+  release:
+    if: (github.event_name == 'release' && github.event.action == 'created')
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Download artifacts
+        uses: actions/[email protected]
+      - name: Upload assets
+        uses: softprops/[email protected]
+        with:
+          files: |
+            riscv-asm-manual.zip/riscv-asm.pdf
+            riscv-asm-manual.zip/riscv-asm.html

src/preamble.adoc

@@ -1,10 +1,10 @@
 [preface]
 == Copyright and License Information
 
-The RISC-V Assembly Programmer's Manual is
-(C) 2017 Palmer Dabbelt mailto:[email protected][[email protected]],
-(C) 2017 Michael Clark mailto:[email protected][[email protected]] and,
-(C) 2017 Alex Bradbury mailto:[email protected][[email protected]].
+The RISC-V Assembly Programmer's Manual is +
+(C) 2017 Palmer Dabbelt mailto:[email protected][[email protected]], +
+(C) 2017 Michael Clark mailto:[email protected][[email protected]] and, +
+(C) 2017 Alex Bradbury mailto:[email protected][[email protected]]. +
 
 It is licensed under the Creative Commons Attribution 4.0 International License (CC-BY 4.0).