Conversion of LaTeX spec to asciidoc.

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "docs-resources"]
+	path = docs-resources
+	url = [email protected]:riscv/docs-resources.git

Makefile

@@ -0,0 +1,69 @@
+# Makefile for RISC-V ISA Manuals
+#
+# This work is licensed under the Creative Commons Attribution-ShareAlike 4.0
+# International License. To view a copy of this license, visit
+# http://creativecommons.org/licenses/by-sa/4.0/ or send a letter to
+# Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.
+#
+# SPDX-License-Identifier: CC-BY-SA-4.0
+#
+# Description:
+# 
+# This Makefile is designed to automate the process of building and packaging 
+# the documentation for RISC-V ISA Manuals. It supports multiple build targets 
+# for generating documentation in various formats (PDF, HTML).
+
+# Build Targets
+TARGETS := aia aia-html
+
+# Declare phony targets
+.PHONY: all $(TARGETS) clean
+
+# Default target builds all
+all: $(TARGETS)
+
+#ifneq ($(SKIP_DOCKER),true)
+#	DOCKER_CMD := docker run --rm -v ${PWD}:/build -w /build \
+#	riscvintl/riscv-docs-base-container-image:latest \
+#	/bin/sh -c
+#	DOCKER_QUOTE := "
+#endif
+
+# Asciidoctor options
+ASCIIDOCTOR_OPTS := -a --compress \
+					--attribute=mathematical-format=svg \
+                    --failure-level=ERROR \
+                    --require=asciidoctor-diagram \
+                    --require=asciidoctor-mathematical \
+                    --trace
+
+# Source directory
+SRCDIR := src
+
+
+# AIA Specification AsciiDoc Build 
+aia: riscv-interrupts.pdf
+
+riscv-interrupts.pdf: $(SRCDIR)/riscv-interrupts.adoc $(SRCDIR)/*.adoc
+	@echo "Building AIA Specification"
+	rm -f [email protected]
+	asciidoctor-pdf $(ASCIIDOCTOR_OPTS) [email protected] $<
+	mv [email protected] $@
+
+# AIA Specification HTML build
+aia-html: riscv-interrupts.html
+
+riscv-interrupts.html: $(SRCDIR)/riscv-interrupts.adoc
+	@echo "Building AIA HTML Specification"
+	asciidoctor $(ASCIIDOCTOR_OPTS) --out-file=$@ $<
+
+clean:
+	@if [ -f riscv-interrupts.pdf ]; then \
+		echo "Removing riscv-interrupts.pdf"; \
+		rm -f riscv-interrupts.pdf; \
+	fi
+	@if [ -f riscv-interrupts.html ]; then \
+		echo "Removing riscv-interrupts.html"; \
+		rm -f riscv-interrupts.html; \
+	fi
+	done

build/.gitignore

@@ -0,0 +1,11 @@
+*.aux
+*.bbl
+*.blg
+*.log
+*.out
+*.pdf
+*.toc
+*.tmp
+*stem*
+../src/docs-resources/images/stem*
+../doc/build/*

dependencies/Gemfile

@@ -0,0 +1,14 @@
+source 'https://rubygems.org'
+gem 'asciidoctor'
+gem 'asciidoctor-bibtex'
+gem 'asciidoctor-diagram'
+gem 'asciidoctor-mathematical'
+gem 'asciidoctor-pdf'
+gem 'citeproc-ruby'
+gem 'coderay'
+gem 'csl-styles'
+gem 'json'
+gem 'pygments.rb'
+gem 'rghost'
+gem 'rouge'
+gem 'ruby_dev'

dependencies/README.md

@@ -0,0 +1,3 @@
+Dependencies for the build environment for various package managers.  Used in
+`.github/workflows/`.
+

dependencies/apt_packages.txt

@@ -0,0 +1,22 @@
+bison
+build-essential
+cmake
+curl
+flex
+fonts-lyx
+git
+graphviz
+# For wavedrom
+default-jre
+libcairo2-dev
+libffi-dev
+libgdk-pixbuf2.0-dev
+libglib2.0-dev
+libpango1.0-dev
+libxml2-dev
+make
+pkg-config
+ruby
+ruby-dev
+libwebp-dev
+libzstd-dev

dependencies/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "local",
+  "version": "0.0.1",
+  "dependencies": {
+    "wavedrom-cli": "^2.6.8",
+    "bytefield-svg": "^1.8.0"
+  }
+}