osrm-backend/docs/source/README_TO_GENERATE_DOCS.md
Siarhei Fedartsou 0f6aab9da6 Squashed 'third_party/flatbuffers/' content from commit 595bf0007
git-subtree-dir: third_party/flatbuffers
git-subtree-split: 595bf0007ab1929570c7671f091313c8fc20644e
2024-06-22 13:33:34 +02:00

1.0 KiB

Prerequisites

To generate the docs for FlatBuffers from the source files, you will first need to install two programs.

  1. You will need to install doxygen. See Download Doxygen.

  2. You will need to install doxypypy to format python comments appropriately. Install it from here.

Note: You will need both doxygen and doxypypy to be in your PATH environment variable.

After you have both of those files installed and in your path, you need to set up the py_filter to invoke doxypypy from doxygen.

Follow the steps here.

Generating Docs

Run the following commands to generate the docs:

cd flatbuffers/docs/source doxygen

The output is placed in flatbuffers/docs/html.

Note: The Go API Reference code must be generated ahead of time. For instructions on how to regenerated this file, please read the comments in GoApi.md.