The tectonic_bridge_graphite2 crate

This crate is part of the Tectonic project. It exposes the C API of the graphite2 “smart font” system within the Rust/Cargo build framework, with no Rust bindings. This is why it is not named graphite2-sys.

• API documentation.
• Main Git repository.

The intention is that eventually this crate will provide the option of “vendoring” the graphite2 library, so that the Tectonic C code can use the library without it needing to be installed on the system. However, this has not yet been implemented.

If your project depends on this crate, Cargo will export for your build script an environment variable named DEP_GRAPHITE2_INCLUDE, which will be the name of a directory containing the graphite2 directory which in turn contains the graphite2 C headers.

You will need to ensure that your Rust code actually references this crate in order for the linker to include linked libraries. A use statement will suffice:

#[allow(unused_imports)]
#[allow(clippy::single_component_path_imports)]
use tectonic_bridge_graphite2;

Cargo features

At the moment this crate does not provide any Cargo features. It is intended that eventually it will, to allow control over whether the graphite2 library is vendored or not.