Complete the debuginfo wrappers

docs/src/lib/metadata.md

@@ -37,6 +37,16 @@ push!(::NamedMDNode, ::MDNode)
 DINode
 ```
 
+### Builder
+
+```@docs
+DIBuilder
+DIBuilder(::LLVM.Module)
+dispose(::DIBuilder)
+LLVM.finalize!(::DIBuilder)
+LLVM.finalize_subprogram!
+```
+
 ### Location information
 
 ```@docs
@@ -73,36 +83,198 @@ DIFile
 directory
 filename
 source
+LLVM.file!
+```
+
+### Lexical Block
+
+```@docs
+LLVM.DILexicalBlock
+LLVM.DILexicalBlockFile
+LLVM.lexical_block!
+LLVM.lexical_block_file!
+```
+
+### Module
+
+```@docs
+LLVM.DIModule
+LLVM.dimodule!
+```
+
+### Namespace
+
+```@docs
+LLVM.DINamespace
+LLVM.namespace!
 ```
 
 ### Type
 
 ```@docs
 DIType
+LLVM.DIBasicType
+LLVM.DIDerivedType
+LLVM.DICompositeType
+LLVM.DISubroutineType
 name(::DIType)
 Base.sizeof(::DIType)
 offset(::DIType)
 line(::DIType)
 flags(::DIType)
+LLVM.align
+LLVM.DIEnumerator
+LLVM.DISubrange
+```
+
+Built-in factories for primitive types:
+
+```@docs
+LLVM.basic_type!
+LLVM.unspecified_type!
+LLVM.nullptr_type!
+```
+
+Derived types (pointers, qualifiers, members, inheritance, ...):
+
+```@docs
+LLVM.pointer_type!
+LLVM.reference_type!
+LLVM.lvalue_reference_type!
+LLVM.rvalue_reference_type!
+LLVM.typedef_type!
+LLVM.qualified_type!
+LLVM.const_type!
+LLVM.volatile_type!
+LLVM.artificial_type!
+LLVM.object_pointer_type!
+LLVM.member_type!
+LLVM.bitfield_member_type!
+LLVM.static_member_type!
+LLVM.member_pointer_type!
+LLVM.inheritance!
+```
+
+Composite types:
+
+```@docs
+LLVM.struct_type!
+LLVM.union_type!
+LLVM.class_type!
+LLVM.array_type!
+LLVM.vector_type!
+LLVM.enumerator!
+LLVM.enumeration_type!
+LLVM.forward_decl!
+LLVM.replaceable_composite_type!
+LLVM.get_or_create_subrange!
+```
+
+Subroutine types:
+
+```@docs
+LLVM.subroutine_type!
+```
+
+Array-node helpers:
+
+```@docs
+LLVM.get_or_create_array!
+LLVM.get_or_create_type_array!
+```
+
+Objective-C:
+
+```@docs
+DIObjCProperty
+LLVM.objc_ivar!
+LLVM.objc_property!
 ```
 
 ### Subprogram
 
 ```@docs
 DISubProgram
 line(::DISubProgram)
+LLVM.subprogram!(::DIBuilder, ::DIScope, ::AbstractString, ::DIFile, ::Integer, ::LLVM.DISubroutineType)
+```
+
+### Variables
+
+Factories for local variables and parameters:
+
+```@docs
+LLVM.auto_variable!
+LLVM.parameter_variable!
+```
+
+### Expressions
+
+```@docs
+LLVM.DIExpression
+LLVM.DIGlobalVariableExpression
+LLVM.expression!
+LLVM.constant_value_expression!
+LLVM.variable
+LLVM.expression
+LLVM.global_variable_expression!
+LLVM.temp_global_variable_fwd_decl!
+```
+
+### Imported entities
+
+```@docs
+LLVM.DIImportedEntity
+LLVM.imported_module_from_namespace!
+LLVM.imported_module_from_alias!
+LLVM.imported_module_from_module!
+LLVM.imported_declaration!
+```
+
+### Macros
+
+```@docs
+LLVM.DIMacro
+LLVM.DIMacroFile
+LLVM.macro!
+LLVM.temp_macro_file!
+```
+
+### Instruction-level insertion
+
+The `declare_*!` / `value_*!` methods return an `Instruction` on LLVM ≤ 18
+(legacy `llvm.dbg.*` intrinsics) and a `LLVM.DbgRecord` on LLVM ≥ 19
+(the new `#dbg_*` record format).
+
+```@docs
+LLVM.declare_before!
+LLVM.declare_at_end!
+LLVM.value_before!
+LLVM.value_at_end!
+LLVM.debuglocation(::Instruction)
+LLVM.debuglocation!(::Instruction, ::DILocation)
 ```
 
 ### Compile Unit
 
 ```@docs
 DICompileUnit
+LLVM.compile_unit!
+```
+
+### Mutation helpers
+
+```@docs
+LLVM.temporary_mdnode
+LLVM.dispose_temporary
+LLVM.replace_uses!(::LLVM.Metadata, ::LLVM.Metadata)
 ```
 
 ### Other
 
 ```@docs
 DEBUG_METADATA_VERSION
+LLVM.debug_metadata_version
 strip_debuginfo!
 subprogram(::LLVM.Function)
 subprogram!