summaryrefslogtreecommitdiff
path: root/api-docs/cppdocs/README.md
blob: 615518eeb82f129b06283f9f708eaad91d2216a5 (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
25
26
# 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
$ shasum -a 256 doxygen.rb
4d1294c815cf0f76c55b14c5f47c25f523bd860a7cc9b077cce9589d84678396  doxygen.rb
$ brew install ./doxygen.rb
```