summaryrefslogtreecommitdiff
path: root/api-docs/cppdocs/README.md
blob: 564128399f122281a5207262092ff7c52603000e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# CPP Docs

We currently use `doxygen` for our C++ documentation generation.

> Note: Using anything newer than doxygen 1.9.4 will cause minor issues with the website whenever the selected theme conflicts with the OS/browser light/dark mode selection.

Generating documentation with Doxygen couldn't be simpler. Just install it and run:

```
$ doxygen
```

From this directory. The output will be stored in `html/`

## Installing doxygen

The theme for our documentation works best with doxygen 1.9.0 - 1.9.4

### macOS (Homebrew)

```
wget https://raw.githubusercontent.com/Homebrew/homebrew-core/41828ee36b96e35b63b2a4c8cfc2df2c3728944a/Formula/doxygen.rb`
brew install ./doxygen.rb
```