gdnative-doc

This is a documentation tool for godot-rust projects.

WARNING: very unstable at the moment.

The goal of this tool is to automate writing documentation in Rust code that will be used in gdscript.

Features

• Keep the documentation synchronized with your code.
• Generate readable and easy to change markdown
• Build table of contents automatically.
• Automatic linking to the godot documentation.
• Generate gut tests from gdscript examples.

Example

An example: process function | :------- | Input: Rust | | Output: markdown | | Output: gut | |

A more complete example can be found in the example/dijkstra-map-gd directory.

Usage

This is meant to be used as a build script: Set toml [build-dependencies] gdnative-doc = "*" In your Cargo.toml. Then you can drive the process with the Builder structure: ```rust // in build.rs use gdnative_doc::{Builder, Backend}; use std::path::PathBuf;

fn main() -> Result<(), Box> { Builder::new() .addbackend(Backend::Markdown { outputdir: PathBuf::from("doc/markdown"), }) .build()?; Ok(()) } ```

More informations can be found in the documentation.

The format of the configuration file can be found here.

You can also use the command-line tool.

Limitations

At the moment, syn is used to parse rust and search for the struct and impls. This is not optimal however and might sometime mess up link resolution. rust-analyzer libraries will probably be used in the future to avoid this.