This docs/ hierarchy houses code and raw files to build the on-line documentation (using Sphinx) and manual pages using (using Pandoc)

This on-line documentation is available at https://openroad.readthedocs.io/en/latest/.

• Python 3.x
• Pip
• virtualenv
• doxygen

• To install pandoc, refer to this link. apt-get should just work for Ubuntu.
• To install sphinx requirements, create a virtual environment (e.g. conda/virtualenv) and then run pip install -r requirements.txt.

You may install Doxygen from this link. Most methods of installation are fine, just ensure that doxygen is in $PATH. This is needed for Doxygen compilation.

To install Python packages:

virtualenv .venv
source .venv/bin/activate
pip install -r requirements.txt

### Build instructions for Pandoc manpages

The `-j16` command is optional for speeding up the manpage compilation process by using multiple jobs
based on the number of cores in your system.

make clean

# Note this step is important as it regenerates the documentation using latest sources.
make preprocess && make all -j16

You will be prompted to enter the RELATIVE path to cat folders which is optional.

man openroad

make html

make checklinks