JuliaInterop / Clang.jl

C binding generator and Julia interface to libclang
https://juliainterop.github.io/Clang.jl/
MIT License
220 stars 68 forks source link

allow documentation `callback`s #386

Closed t-bltg closed 1 year ago

t-bltg commented 1 year ago

Provide a way to give a documentation callback, when parsed c documentation is absent, implementation is tbd:


options = load_options(joinpath(@__DIR__, "generator.toml"))

options["general"]["callback_documentation"] = node -> String["This is the docstring generated for $(node.id)"]

For https://github.com/JuliaParallel/MPI.jl/pull/652.

t-bltg commented 1 year ago

@gnimuc, I've added specific tests for the configuration we use in MPI.jl.

Those also cover the previous PR: https://github.com/JuliaInterop/Clang.jl/pull/385.

CI script was also refreshed and simplified.

Gnimuc commented 1 year ago

I will do a squash merge if there are no additional changes.

t-bltg commented 1 year ago

I'm done, pending CI does not fail. Also, a version bump to 0.16.3 would be appreciated for our Project.toml (sorry for having to bump twice recently).

t-bltg commented 1 year ago

Thanks all for the valuable comments ;)