Adding an API reference for the supported languages. General docs cleanup, including a new `tutorial` section that supports all of the supported languages. Added samples for each supported language to mirror the new tutorial page. Cleaned up all the links by making them `@ref` style links, instead of referencing the names of the generated `.html` files. Removed all generated files that were unnecessarily committed. Also fixed the C# tests (two were failing due to a missing file). Bug: b/25801305 Tested: Tested all samples on Ubuntu, Mac, and Android. Docs were generated using doxygen and viewed on Chrome. Change-Id: I2acaba6e332a15ae2deff5f26a4a25da7bd2c954
1.1 KiB
Prerequisites
To generate the docs for FlatBuffers from the source files, you will first need to install two programs.
-
You will need to install
doxygen. See Download Doxygen. -
You will need to install
doxypypyto 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.