cve2/doc
2025-03-14 17:01:09 +01:00
..
01_specification Removing requirement to encode supervisor mode in AHB as supervisor mode is not supported 2023-09-27 15:46:31 +02:00
02_user Modification debug interface output halted status (#288) 2025-03-14 17:01:09 +01:00
03_reference Modification debug interface output halted status (#288) 2025-03-14 17:01:09 +01:00
_static/css Replacing the config.py with one from CV32E40P to adjust style from lowRISC to OpenHW Group 2023-08-16 09:13:15 +02:00
images Adding OpenHW group logo to documentation 2023-09-06 10:39:22 +02:00
.gitignore Convert documentation to restructured text 2018-11-13 16:21:47 +01:00
conf.py Adding OpenHW group logo to documentation 2023-09-06 10:39:22 +02:00
index.rst Removing outdated documentation that is missleading in the context of CV32E20 2023-09-06 10:56:15 +02:00
make.bat Adjust documentation for ibex 2019-04-26 15:09:00 +01:00
Makefile Adjust documentation for ibex 2019-04-26 15:09:00 +01:00
Readme.md Adding readme file to document setup for Sphinx doc generation 2023-08-15 15:13:33 +02:00
requirements.txt HotFix: need the latest version of Sphinx 2024-01-30 10:26:13 -05:00

CVE2 Documentation

The documentation of CVE2 is written in reStructuredText and compiled to HTML using Sphinx. For more information, check https://www.sphinx-doc.org/en/master/usage/restructuredtext/index.html.

Prerequisites

To build the documentation, certain prequisites need to be fulfilled. This section outlines the necessary steps on Linux. Tested on Ubuntu 20.04.

Sphinx is based on Python and requires at least version 3.8. Additionally, make is required and can be installed through build-essential.

sudo apt update
sudo apt install python3
sudo apt install build-essential

Please verify your Python version using

python3 --version

The recommended way of installing Sphinx is via pip using

pip install -U sphinx

Sphinx requires certain packages to build this documentation. These are summarized in doc/requirements.txt. They can automatically be installed using

cd doc
pip install -r requirements.txt

Building the documentation

To build the documentation, switch to the doc folder if not already done. Build is invoked via the make command. Typically, an HTML should be build.

cd doc
make html

Simply type only make to view other available targets.