Skip to content

docs(pact-ffi): publish pactffi_string_delete in the crate docs - #552

Merged
JP-Ellis merged 1 commit into
masterfrom
fix/ffi-string-delete-docs
Sep 21, 2026
Merged

JP-Ellis merged 1 commit into
masterfrom
fix/ffi-string-delete-docs

Conversation

@JP-Ellis

@JP-Ellis JP-Ellis commented Sep 17, 2026 •

Copy link
Copy Markdown
Member

pactffi_string_delete is defined in the private util::string module, so rustdoc omits it: there is no fn.pactffi_string_delete.html on docs.rs even though every FFI function returning a heap string tells callers to free it with this function. Every exported FFI function should have accessible documentation.

This re-exports it from the crate root so it is documented at pact_ffi/fn.pactffi_string_delete.html, alongside the other exported functions. The util module itself stays pub(crate). Verified locally with cargo doc -p pact_ffi --no-deps.

`pactffi_string_delete` is defined in the private `util::string` module,
so rustdoc omits it even though every FFI function returning a string
directs callers to it. Every exported FFI function should have
accessible documentation, so re-export it from the crate root and
docs.rs renders it alongside the rest.

Assisted-by: Claude Code:claude-opus-5[1m]
Signed-off-by: JP-Ellis <josh@jpellis.me>
@JP-Ellis
JP-Ellis force-pushed the fix/ffi-string-delete-docs branch from 2a314e8 to bf36b47 Compare September 17, 2026 10:17
@JP-Ellis
JP-Ellis merged commit d787965 into master Sep 21, 2026
25 checks passed
@JP-Ellis
JP-Ellis deleted the fix/ffi-string-delete-docs branch September 21, 2026 06:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant