xahaud/docs/README.md

Building documentation

Install Dependencies

Windows

Install these dependencies:

1. Install Doxygen

MacOS

1. Install doxygen:

• Use homebrew to install: brew install doxygen. The executable will be installed in /usr/local/bin which is already in your path.
• Alternatively, install from here: doxygen. You'll then need to make doxygen available to your command line. You can do this by adding a symbolic link from /usr/local/bin to the doxygen executable. For example, $ ln -s /Applications/Doxygen.app/Contents/Resources/doxygen /usr/local/bin/doxygen

Linux

1. Install doxygen using your package manager OR from source using the links above.

[Optional] Install Plantuml (all platforms)

Doxygen supports the optional use of plantuml to generate diagrams from @startuml sections. We don't currently rely on this functionality for docs, so it's largely optional. Requirements:

1. Download/install a functioning java runtime, if you don't already have one.
2. Download plantuml from here. Set a system environment variable named DOXYGEN_PLANTUML_JAR_PATH to the absolute path of the plantuml.jar file you downloaded.

Configure

You should set these environment variables:

• DOXYGEN_OUTPUT_DIRECTORY
• DOXYGEN_PLANTUML_JAR_PATH

Build

From the rippled root folder:

doxygen docs/Doxyfile

The output will be wherever you chose for DOXYGEN_OUTPUT_DIRECTORY.

Docker

(applicable to all platforms)

Instead of installing the doxygen tools locally, you can use the provided Dockerfile to create an ubuntu based image for running the tools:

1. Install Docker
2. Build Docker image. From the rippled root folder:

sudo docker build -t rippled-docs docs/

Then to run the image, from the rippled root folder:

sudo docker run -v $PWD:/opt/rippled --rm rippled-docs

The output will be in html.