Avoid method ambiguities in TypedefMutualRef's

Project.toml

@@ -1,6 +1,6 @@
 name = "Clang"
 uuid = "40e3b903-d033-50b4-a0cc-940c62c95e31"
-version = "0.17.7"
+version = "0.17.8"
 
 [deps]
 CEnum = "fa961155-64e5-5f13-b03f-caf6b980ea82"

docs/make.jl

@@ -4,12 +4,13 @@ using Documenter
 
 makedocs(;
     modules=[Clang, Clang.LibClang],
-    repo="https://github.com/JuliaInterop/Clang.jl/blob/{commit}{path}#L{line}",
+    repo=Remotes.GitHub("JuliaInterop", "Clang.jl"),
     sitename="Clang.jl",
     format=Documenter.HTML(;
         prettyurls=get(ENV, "CI", "false") == "true",
         canonical="https://JuliaInterop.github.io/Clang.jl",
         assets=String[],
+        size_threshold=700000
     ),
     pages=[
         "Introduction" => "index.md",
@@ -18,6 +19,7 @@ makedocs(;
         "LibClang Wrapper API Reference" => "libclang.md",
         "Clang API Reference" => "api.md",
     ],
+    warnonly=:missing_docs
 )
 
 deploydocs(; repo="github.com/JuliaInterop/Clang.jl.git")

gen/generator.jl

@@ -41,6 +41,16 @@ function rewrite!(dag::ExprDAG)
     end
 end
 
+function get_docs(node::ExprNode)
+    whitelist = [:CXRewriter, :clang_disposeCXTUResourceUsage]
+
+    if node.id in whitelist
+        String["*Documentation not found in headers.*"]
+    else
+        String[]
+    end
+end
+
 import Pkg
 import BinaryBuilderBase: PkgSpec, Prefix, temp_prefix, setup_dependencies, cleanup_dependencies, destdir
 
@@ -61,6 +71,7 @@ for (llvm_version, julia_version) in (#=(v"12.0.1", v"1.7"),=#
         artifact_paths = setup_dependencies(prefix, dependencies, platform; verbose=true)
 
         let options = deepcopy(options)
+            options["general"]["callback_documentation"] = get_docs
             output_file_path = joinpath(libdir, string(llvm_version.major), options["general"]["output_file_path"])
             isdir(dirname(output_file_path)) || mkpath(dirname(output_file_path))
             options["general"]["output_file_path"] = output_file_path

gen/generator.toml

@@ -129,6 +129,15 @@ auto_mutability_includelist = []
 # note: by default, Clang only parses doxygen comment, pass `-fparse-all-comments` to Clang in order to parse non-doxygen comments.
 extract_c_comment_style = "doxygen"
 
+# Pass a function to explicitly generate documentation. It will be called like
+# `callback_documentation(node::ExprNode)` if `extract_c_comment_style` is not
+# set, or if it is set and no docs were found automatically.
+#
+# Do *not* set this in the TOML file, it should be set in the generator script
+# to a function that takes in an ExprNode and returns a String[] (string
+# vector).
+# callback_documentation = ""
+
 # if set to true, single line comment will be printed as """comment""" instead of """\ncomment\n"""
 fold_single_line_comment = false
 

lib/13/LibClang.jl

@@ -1696,6 +1696,11 @@ function clang_getCXTUResourceUsage(TU)
     @ccall libclang.clang_getCXTUResourceUsage(TU::CXTranslationUnit)::CXTUResourceUsage
 end
 
+"""
+    clang_disposeCXTUResourceUsage(usage)
+
+*Documentation not found in headers.*
+"""
 function clang_disposeCXTUResourceUsage(usage)
     @ccall libclang.clang_disposeCXTUResourceUsage(usage::CXTUResourceUsage)::Cvoid
 end
@@ -6836,6 +6841,9 @@ function clang_uninstall_llvm_fatal_error_handler()
     @ccall libclang.clang_uninstall_llvm_fatal_error_handler()::Cvoid
 end
 
+"""
+*Documentation not found in headers.*
+"""
 const CXRewriter = Ptr{Cvoid}
 
 """

lib/14/LibClang.jl

@@ -1696,6 +1696,11 @@ function clang_getCXTUResourceUsage(TU)
     @ccall libclang.clang_getCXTUResourceUsage(TU::CXTranslationUnit)::CXTUResourceUsage
 end
 
+"""
+    clang_disposeCXTUResourceUsage(usage)
+
+*Documentation not found in headers.*
+"""
 function clang_disposeCXTUResourceUsage(usage)
     @ccall libclang.clang_disposeCXTUResourceUsage(usage::CXTUResourceUsage)::Cvoid
 end
@@ -6842,6 +6847,9 @@ function clang_uninstall_llvm_fatal_error_handler()
     @ccall libclang.clang_uninstall_llvm_fatal_error_handler()::Cvoid
 end
 
+"""
+*Documentation not found in headers.*
+"""
 const CXRewriter = Ptr{Cvoid}
 
 """