Fidldoc is a command-line tool that generates HTML reference pages based on FIDL JSON IR.

Build

1. Include fidldoc in your build, e.g. fx set core.x64 --with //tools/fidl/fidldoc
2. Build with ./buildtools/ninja -C out/default tools/fidl/fidldoc:fidldoc

Run

1. Run with a single file fidldoc fuchsia-device.fidl.json
2. Run with a list of files fidldoc json/*

By default, docs will be generated in ./docs/. You can change that by specifying the --output (or -o) command-line flag. Use the --template (or -t) flag to select the output format. Currently, the two supported values are markdown and html.

Test

The tools/fidl/fidldoc:fidldoc target will automatically generate a unit test binary in the build output directory. Run the tests with ./out/default/host_x64/fidldoc_bin_test.

Alternatively, you can run the tests with fx run-host-tests fidldoc_bin_test.