The tectonic_bridge_core crate

[!NOTE] This crate is part of the FerroTeX project, a specialized fork of Tectonic. It is published to crates.io as jxoesneon-tectonic-bridge_core.

This crate is part of the Tectonic project. It provides a C API to core I/O services provided by the Tectonic Rust code. This API is then consumed by the various C/C++ "engines" implementing the TeX software.

• API documentation.
• Main Git repository.

If your project depends on this crate, Cargo will export for your build script an environment variable named DEP_TECTONIC_BRIDGE_CORE_INCLUDE, which will be the name of a directory containing the generated tectonic_bridge_core.h file that exposes this crate’s C API.

You will need to ensure that your Rust code actually references this crate in order for the linker to include the C API symbols. If you are not actively using its Rust API, a use statement will suffice:

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

Cargo features

This crate does not currently provide any Cargo features.

Updating the generated header

This crate exposes Rust functions to C/C++ code using a header file created by cbindgen. To update the header, run:

cbindgen --output support/tectonic_bridge_core_generated.h