6502/llvm-6502
1
0
Fork 0
mirror of https://github.com/c64scene-ar/llvm-6502.git synced 2025-07-27 12:26:08 +00:00
Code Issues Projects Releases Wiki Activity

Revert "Clean up the comments in DIBuilder.h to adhere to the coding standards"

Browse Source 
This reverts commit 241965. (I accidentally committed too much).

git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@241968 91177308-0d34-0410-b5e6-96231b3b80d8
This commit is contained in:
Adrian Prantl
2015-07-10 23:31:05 +00:00
parent aefc592dd3
commit e493b99669
1 changed files with 315 additions and 325 deletions
Download Patch File Download Diff File Expand all files Collapse all files

640
include/llvm/IR/DIBuilder.h
View File

@@ -47,7 +47,7 @@ namespace llvm {
SmallVector<Metadata *, 4> AllGVs; SmallVector<Metadata *, 4> AllGVs;
SmallVector<TrackingMDNodeRef, 4> AllImportedModules; SmallVector<TrackingMDNodeRef, 4> AllImportedModules;
/// Track nodes that may be unresolved. /// \brief Track nodes that may be unresolved.
SmallVector<TrackingMDNodeRef, 4> UnresolvedNodes; SmallVector<TrackingMDNodeRef, 4> UnresolvedNodes;
bool AllowUnresolvedNodes; bool AllowUnresolvedNodes;
@@ -57,52 +57,49 @@ namespace llvm {
DIBuilder(const DIBuilder &) = delete; DIBuilder(const DIBuilder &) = delete;
void operator=(const DIBuilder &) = delete; void operator=(const DIBuilder &) = delete;
/// Create a temporary. /// \brief Create a temporary.
/// ///
/// Create an \a temporary node and track it in \a UnresolvedNodes. /// Create an \a temporary node and track it in \a UnresolvedNodes.
void trackIfUnresolved(MDNode *N); void trackIfUnresolved(MDNode *N);
public: public:
/// Construct a builder for a module. /// \brief Construct a builder for a module.
/// ///
/// If \c AllowUnresolved, collect unresolved nodes attached to the module /// If \c AllowUnresolved, collect unresolved nodes attached to the module
/// in order to resolve cycles during \a finalize(). /// in order to resolve cycles during \a finalize().
explicit DIBuilder(Module &M, bool AllowUnresolved = true); explicit DIBuilder(Module &M, bool AllowUnresolved = true);
enum DebugEmissionKind { FullDebug=1, LineTablesOnly }; enum DebugEmissionKind { FullDebug=1, LineTablesOnly };
/// Construct any deferred debug info descriptors. /// finalize - Construct any deferred debug info descriptors.
void finalize(); void finalize();
/// A CompileUnit provides an anchor for all debugging /// createCompileUnit - A CompileUnit provides an anchor for all debugging
/// information generated during this instance of compilation. /// information generated during this instance of compilation.
/// \param Lang Source programming language, eg. dwarf::DW_LANG_C99 /// @param Lang Source programming language, eg. dwarf::DW_LANG_C99
/// \param File File name /// @param File File name
/// \param Dir Directory /// @param Dir Directory
/// \param Producer Identify the producer of debugging information /// @param Producer Identify the producer of debugging information and code.
/// and code. Usually this is a compiler /// Usually this is a compiler version string.
/// version string. /// @param isOptimized A boolean flag which indicates whether optimization
/// \param isOptimized A boolean flag which indicates whether optimization /// is ON or not.
/// is enabled or not. /// @param Flags This string lists command line options. This string is
/// \param Flags This string lists command line options. This /// directly embedded in debug info output which may be used
/// string is directly embedded in debug info /// by a tool analyzing generated debugging information.
/// output which may be used by a tool /// @param RV This indicates runtime version for languages like
/// analyzing generated debugging information. /// Objective-C.
/// \param RV This indicates runtime version for languages like /// @param SplitName The name of the file that we'll split debug info out
/// Objective-C. /// into.
/// \param SplitName The name of the file that we'll split debug info /// @param Kind The kind of debug information to generate.
/// out into. /// @param DWOId The DWOId if this is a split skeleton compile unit.
/// \param Kind The kind of debug information to generate. /// @param EmitDebugInfo A boolean flag which indicates whether debug
/// \param DWOId The DWOId if this is a split skeleton compile unit. /// information should be written to the final
/// \param EmitDebugInfo A boolean flag which indicates whether /// output or not. When this is false, debug
/// debug information should be written to /// information annotations will be present in
/// the final output or not. When this is /// the IL but they are not written to the final
/// false, debug information annotations will /// assembly or object file. This supports tracking
/// be present in the IL but they are not /// source location information in the back end
/// written to the final assembly or object /// without actually changing the output (e.g.,
/// file. This supports tracking source /// when using optimization remarks).
/// location information in the back end
/// without actually changing the output
/// (e.g., when using optimization remarks).
DICompileUnit * DICompileUnit *
createCompileUnit(unsigned Lang, StringRef File, StringRef Dir, createCompileUnit(unsigned Lang, StringRef File, StringRef Dir,
StringRef Producer, bool isOptimized, StringRef Flags, StringRef Producer, bool isOptimized, StringRef Flags,
@@ -110,155 +107,155 @@ namespace llvm {
DebugEmissionKind Kind = FullDebug, uint64_t DWOId = 0, DebugEmissionKind Kind = FullDebug, uint64_t DWOId = 0,
bool EmitDebugInfo = true); bool EmitDebugInfo = true);
/// Create a file descriptor to hold debugging information /// createFile - Create a file descriptor to hold debugging information
/// for a file. /// for a file.
DIFile *createFile(StringRef Filename, StringRef Directory); DIFile *createFile(StringRef Filename, StringRef Directory);
/// Create a single enumerator value. /// createEnumerator - Create a single enumerator value.
DIEnumerator *createEnumerator(StringRef Name, int64_t Val); DIEnumerator *createEnumerator(StringRef Name, int64_t Val);
/// Create a DWARF unspecified type. /// \brief Create a DWARF unspecified type.
DIBasicType *createUnspecifiedType(StringRef Name); DIBasicType *createUnspecifiedType(StringRef Name);
/// Create C++11 nullptr type. /// \brief Create C++11 nullptr type.
DIBasicType *createNullPtrType(); DIBasicType *createNullPtrType();
/// Create debugging information entry for a basic /// createBasicType - Create debugging information entry for a basic
/// type. /// type.
/// \param Name Type name. /// @param Name Type name.
/// \param SizeInBits Size of the type. /// @param SizeInBits Size of the type.
/// \param AlignInBits Type alignment. /// @param AlignInBits Type alignment.
/// \param Encoding DWARF encoding code, e.g. dwarf::DW_ATE_float. /// @param Encoding DWARF encoding code, e.g. dwarf::DW_ATE_float.
DIBasicType *createBasicType(StringRef Name, uint64_t SizeInBits, DIBasicType *createBasicType(StringRef Name, uint64_t SizeInBits,
uint64_t AlignInBits, unsigned Encoding); uint64_t AlignInBits, unsigned Encoding);
/// Create debugging information entry for a qualified /// createQualifiedType - Create debugging information entry for a qualified
/// type, e.g. 'const int'. /// type, e.g. 'const int'.
/// \param Tag Tag identifing type, e.g. dwarf::TAG_volatile_type /// @param Tag Tag identifing type, e.g. dwarf::TAG_volatile_type
/// \param FromTy Base Type. /// @param FromTy Base Type.
DIDerivedType *createQualifiedType(unsigned Tag, DIType *FromTy); DIDerivedType *createQualifiedType(unsigned Tag, DIType *FromTy);
/// Create debugging information entry for a pointer. /// createPointerType - Create debugging information entry for a pointer.
/// \param PointeeTy Type pointed by this pointer. /// @param PointeeTy Type pointed by this pointer.
/// \param SizeInBits Size. /// @param SizeInBits Size.
/// \param AlignInBits Alignment. (optional) /// @param AlignInBits Alignment. (optional)
/// \param Name Pointer type name. (optional) /// @param Name Pointer type name. (optional)
DIDerivedType *createPointerType(DIType *PointeeTy, uint64_t SizeInBits, DIDerivedType *createPointerType(DIType *PointeeTy, uint64_t SizeInBits,
uint64_t AlignInBits = 0, uint64_t AlignInBits = 0,
StringRef Name = ""); StringRef Name = "");
/// Create debugging information entry for a pointer to member. /// \brief Create debugging information entry for a pointer to member.
/// \param PointeeTy Type pointed to by this pointer. /// @param PointeeTy Type pointed to by this pointer.
/// \param SizeInBits Size. /// @param SizeInBits Size.
/// \param AlignInBits Alignment. (optional) /// @param AlignInBits Alignment. (optional)
/// \param Class Type for which this pointer points to members of. /// @param Class Type for which this pointer points to members of.
DIDerivedType *createMemberPointerType(DIType *PointeeTy, DIType *Class, DIDerivedType *createMemberPointerType(DIType *PointeeTy, DIType *Class,
uint64_t SizeInBits, uint64_t SizeInBits,
uint64_t AlignInBits = 0); uint64_t AlignInBits = 0);
/// Create debugging information entry for a c++ /// createReferenceType - Create debugging information entry for a c++
/// style reference or rvalue reference type. /// style reference or rvalue reference type.
DIDerivedType *createReferenceType(unsigned Tag, DIType *RTy); DIDerivedType *createReferenceType(unsigned Tag, DIType *RTy);
/// Create debugging information entry for a typedef. /// createTypedef - Create debugging information entry for a typedef.
/// \param Ty Original type. /// @param Ty Original type.
/// \param Name Typedef name. /// @param Name Typedef name.
/// \param File File where this type is defined. /// @param File File where this type is defined.
/// \param LineNo Line number. /// @param LineNo Line number.
/// \param Context The surrounding context for the typedef. /// @param Context The surrounding context for the typedef.
DIDerivedType *createTypedef(DIType *Ty, StringRef Name, DIFile *File, DIDerivedType *createTypedef(DIType *Ty, StringRef Name, DIFile *File,
unsigned LineNo, DIScope *Context); unsigned LineNo, DIScope *Context);
/// Create debugging information entry for a 'friend'. /// createFriend - Create debugging information entry for a 'friend'.
DIDerivedType *createFriend(DIType *Ty, DIType *FriendTy); DIDerivedType *createFriend(DIType *Ty, DIType *FriendTy);
/// Create debugging information entry to establish /// createInheritance - Create debugging information entry to establish
/// inheritance relationship between two types. /// inheritance relationship between two types.
/// \param Ty Original type. /// @param Ty Original type.
/// \param BaseTy Base type. Ty is inherits from base. /// @param BaseTy Base type. Ty is inherits from base.
/// \param BaseOffset Base offset. /// @param BaseOffset Base offset.
/// \param Flags Flags to describe inheritance attribute, /// @param Flags Flags to describe inheritance attribute,
/// e.g. private /// e.g. private
DIDerivedType *createInheritance(DIType *Ty, DIType *BaseTy, DIDerivedType *createInheritance(DIType *Ty, DIType *BaseTy,
uint64_t BaseOffset, unsigned Flags); uint64_t BaseOffset, unsigned Flags);
/// Create debugging information entry for a member. /// createMemberType - Create debugging information entry for a member.
/// \param Scope Member scope. /// @param Scope Member scope.
/// \param Name Member name. /// @param Name Member name.
/// \param File File where this member is defined. /// @param File File where this member is defined.
/// \param LineNo Line number. /// @param LineNo Line number.
/// \param SizeInBits Member size. /// @param SizeInBits Member size.
/// \param AlignInBits Member alignment. /// @param AlignInBits Member alignment.
/// \param OffsetInBits Member offset. /// @param OffsetInBits Member offset.
/// \param Flags Flags to encode member attribute, e.g. private /// @param Flags Flags to encode member attribute, e.g. private
/// \param Ty Parent type. /// @param Ty Parent type.
DIDerivedType *createMemberType(DIScope *Scope, StringRef Name, DIDerivedType *createMemberType(DIScope *Scope, StringRef Name,
DIFile *File, unsigned LineNo, DIFile *File, unsigned LineNo,
uint64_t SizeInBits, uint64_t AlignInBits, uint64_t SizeInBits, uint64_t AlignInBits,
uint64_t OffsetInBits, unsigned Flags, uint64_t OffsetInBits, unsigned Flags,
DIType *Ty); DIType *Ty);
/// Create debugging information entry for a /// createStaticMemberType - Create debugging information entry for a
/// C++ static data member. /// C++ static data member.
/// \param Scope Member scope. /// @param Scope Member scope.
/// \param Name Member name. /// @param Name Member name.
/// \param File File where this member is declared. /// @param File File where this member is declared.
/// \param LineNo Line number. /// @param LineNo Line number.
/// \param Ty Type of the static member. /// @param Ty Type of the static member.
/// \param Flags Flags to encode member attribute, e.g. private. /// @param Flags Flags to encode member attribute, e.g. private.
/// \param Val Const initializer of the member. /// @param Val Const initializer of the member.
DIDerivedType *createStaticMemberType(DIScope *Scope, StringRef Name, DIDerivedType *createStaticMemberType(DIScope *Scope, StringRef Name,
DIFile *File, unsigned LineNo, DIFile *File, unsigned LineNo,
DIType *Ty, unsigned Flags, DIType *Ty, unsigned Flags,
llvm::Constant *Val); llvm::Constant *Val);
/// Create debugging information entry for Objective-C /// createObjCIVar - Create debugging information entry for Objective-C
/// instance variable. /// instance variable.
/// \param Name Member name. /// @param Name Member name.
/// \param File File where this member is defined. /// @param File File where this member is defined.
/// \param LineNo Line number. /// @param LineNo Line number.
/// \param SizeInBits Member size. /// @param SizeInBits Member size.
/// \param AlignInBits Member alignment. /// @param AlignInBits Member alignment.
/// \param OffsetInBits Member offset. /// @param OffsetInBits Member offset.
/// \param Flags Flags to encode member attribute, e.g. private /// @param Flags Flags to encode member attribute, e.g. private
/// \param Ty Parent type. /// @param Ty Parent type.
/// \param PropertyNode Property associated with this ivar. /// @param PropertyNode Property associated with this ivar.
DIDerivedType *createObjCIVar(StringRef Name, DIFile *File, unsigned LineNo, DIDerivedType *createObjCIVar(StringRef Name, DIFile *File, unsigned LineNo,
uint64_t SizeInBits, uint64_t AlignInBits, uint64_t SizeInBits, uint64_t AlignInBits,
uint64_t OffsetInBits, unsigned Flags, uint64_t OffsetInBits, unsigned Flags,
DIType *Ty, MDNode *PropertyNode); DIType *Ty, MDNode *PropertyNode);
/// Create debugging information entry for Objective-C /// createObjCProperty - Create debugging information entry for Objective-C
/// property. /// property.
/// \param Name Property name. /// @param Name Property name.
/// \param File File where this property is defined. /// @param File File where this property is defined.
/// \param LineNumber Line number. /// @param LineNumber Line number.
/// \param GetterName Name of the Objective C property getter selector. /// @param GetterName Name of the Objective C property getter selector.
/// \param SetterName Name of the Objective C property setter selector. /// @param SetterName Name of the Objective C property setter selector.
/// \param PropertyAttributes Objective C property attributes. /// @param PropertyAttributes Objective C property attributes.
/// \param Ty Type. /// @param Ty Type.
DIObjCProperty *createObjCProperty(StringRef Name, DIFile *File, DIObjCProperty *createObjCProperty(StringRef Name, DIFile *File,
unsigned LineNumber, unsigned LineNumber,
StringRef GetterName, StringRef GetterName,
StringRef SetterName, StringRef SetterName,
unsigned PropertyAttributes, DIType *Ty); unsigned PropertyAttributes, DIType *Ty);
/// Create debugging information entry for a class. /// createClassType - Create debugging information entry for a class.
/// \param Scope Scope in which this class is defined. /// @param Scope Scope in which this class is defined.
/// \param Name class name. /// @param Name class name.
/// \param File File where this member is defined. /// @param File File where this member is defined.
/// \param LineNumber Line number. /// @param LineNumber Line number.
/// \param SizeInBits Member size. /// @param SizeInBits Member size.
/// \param AlignInBits Member alignment. /// @param AlignInBits Member alignment.
/// \param OffsetInBits Member offset. /// @param OffsetInBits Member offset.
/// \param Flags Flags to encode member attribute, e.g. private /// @param Flags Flags to encode member attribute, e.g. private
/// \param Elements class members. /// @param Elements class members.
/// \param VTableHolder Debug info of the base class that contains vtable /// @param VTableHolder Debug info of the base class that contains vtable
/// for this type. This is used in /// for this type. This is used in
/// DW_AT_containing_type. See DWARF documentation /// DW_AT_containing_type. See DWARF documentation
/// for more info. /// for more info.
/// \param TemplateParms Template type parameters. /// @param TemplateParms Template type parameters.
/// \param UniqueIdentifier A unique identifier for the class. /// @param UniqueIdentifier A unique identifier for the class.
DICompositeType *createClassType(DIScope *Scope, StringRef Name, DICompositeType *createClassType(DIScope *Scope, StringRef Name,
DIFile *File, unsigned LineNumber, DIFile *File, unsigned LineNumber,
uint64_t SizeInBits, uint64_t AlignInBits, uint64_t SizeInBits, uint64_t AlignInBits,
@@ -268,34 +265,34 @@ namespace llvm {
MDNode *TemplateParms = nullptr, MDNode *TemplateParms = nullptr,
StringRef UniqueIdentifier = ""); StringRef UniqueIdentifier = "");
/// Create debugging information entry for a struct. /// createStructType - Create debugging information entry for a struct.
/// \param Scope Scope in which this struct is defined. /// @param Scope Scope in which this struct is defined.
/// \param Name Struct name. /// @param Name Struct name.
/// \param File File where this member is defined. /// @param File File where this member is defined.
/// \param LineNumber Line number. /// @param LineNumber Line number.
/// \param SizeInBits Member size. /// @param SizeInBits Member size.
/// \param AlignInBits Member alignment. /// @param AlignInBits Member alignment.
/// \param Flags Flags to encode member attribute, e.g. private /// @param Flags Flags to encode member attribute, e.g. private
/// \param Elements Struct elements. /// @param Elements Struct elements.
/// \param RunTimeLang Optional parameter, Objective-C runtime version. /// @param RunTimeLang Optional parameter, Objective-C runtime version.
/// \param UniqueIdentifier A unique identifier for the struct. /// @param UniqueIdentifier A unique identifier for the struct.
DICompositeType *createStructType( DICompositeType *createStructType(
DIScope *Scope, StringRef Name, DIFile *File, unsigned LineNumber, DIScope *Scope, StringRef Name, DIFile *File, unsigned LineNumber,
uint64_t SizeInBits, uint64_t AlignInBits, unsigned Flags, uint64_t SizeInBits, uint64_t AlignInBits, unsigned Flags,
DIType *DerivedFrom, DINodeArray Elements, unsigned RunTimeLang = 0, DIType *DerivedFrom, DINodeArray Elements, unsigned RunTimeLang = 0,
DIType *VTableHolder = nullptr, StringRef UniqueIdentifier = ""); DIType *VTableHolder = nullptr, StringRef UniqueIdentifier = "");
/// Create debugging information entry for an union. /// createUnionType - Create debugging information entry for an union.
/// \param Scope Scope in which this union is defined. /// @param Scope Scope in which this union is defined.
/// \param Name Union name. /// @param Name Union name.
/// \param File File where this member is defined. /// @param File File where this member is defined.
/// \param LineNumber Line number. /// @param LineNumber Line number.
/// \param SizeInBits Member size. /// @param SizeInBits Member size.
/// \param AlignInBits Member alignment. /// @param AlignInBits Member alignment.
/// \param Flags Flags to encode member attribute, e.g. private /// @param Flags Flags to encode member attribute, e.g. private
/// \param Elements Union elements. /// @param Elements Union elements.
/// \param RunTimeLang Optional parameter, Objective-C runtime version. /// @param RunTimeLang Optional parameter, Objective-C runtime version.
/// \param UniqueIdentifier A unique identifier for the union. /// @param UniqueIdentifier A unique identifier for the union.
DICompositeType *createUnionType(DIScope *Scope, StringRef Name, DICompositeType *createUnionType(DIScope *Scope, StringRef Name,
DIFile *File, unsigned LineNumber, DIFile *File, unsigned LineNumber,
uint64_t SizeInBits, uint64_t AlignInBits, uint64_t SizeInBits, uint64_t AlignInBits,
@@ -303,102 +300,95 @@ namespace llvm {
unsigned RunTimeLang = 0, unsigned RunTimeLang = 0,
StringRef UniqueIdentifier = ""); StringRef UniqueIdentifier = "");
/// Create debugging information for template /// createTemplateTypeParameter - Create debugging information for template
/// type parameter. /// type parameter.
/// \param Scope Scope in which this type is defined. /// @param Scope Scope in which this type is defined.
/// \param Name Type parameter name. /// @param Name Type parameter name.
/// \param Ty Parameter type. /// @param Ty Parameter type.
DITemplateTypeParameter * DITemplateTypeParameter *
createTemplateTypeParameter(DIScope *Scope, StringRef Name, DIType *Ty); createTemplateTypeParameter(DIScope *Scope, StringRef Name, DIType *Ty);
/// Create debugging information for template /// createTemplateValueParameter - Create debugging information for template
/// value parameter. /// value parameter.
/// \param Scope Scope in which this type is defined. /// @param Scope Scope in which this type is defined.
/// \param Name Value parameter name. /// @param Name Value parameter name.
/// \param Ty Parameter type. /// @param Ty Parameter type.
/// \param Val Constant parameter value. /// @param Val Constant parameter value.
DITemplateValueParameter *createTemplateValueParameter(DIScope *Scope, DITemplateValueParameter *createTemplateValueParameter(DIScope *Scope,
StringRef Name, StringRef Name,
DIType *Ty, DIType *Ty,
Constant *Val); Constant *Val);
/// Create debugging information for a template template parameter. /// \brief Create debugging information for a template template parameter.
/// \param Scope Scope in which this type is defined. /// @param Scope Scope in which this type is defined.
/// \param Name Value parameter name. /// @param Name Value parameter name.
/// \param Ty Parameter type. /// @param Ty Parameter type.
/// \param Val The fully qualified name of the template. /// @param Val The fully qualified name of the template.
DITemplateValueParameter *createTemplateTemplateParameter(DIScope *Scope, DITemplateValueParameter *createTemplateTemplateParameter(DIScope *Scope,
StringRef Name, StringRef Name,
DIType *Ty, DIType *Ty,
StringRef Val); StringRef Val);
/// Create debugging information for a template parameter pack. /// \brief Create debugging information for a template parameter pack.
/// \param Scope Scope in which this type is defined. /// @param Scope Scope in which this type is defined.
/// \param Name Value parameter name. /// @param Name Value parameter name.
/// \param Ty Parameter type. /// @param Ty Parameter type.
/// \param Val An array of types in the pack. /// @param Val An array of types in the pack.
DITemplateValueParameter *createTemplateParameterPack(DIScope *Scope, DITemplateValueParameter *createTemplateParameterPack(DIScope *Scope,
StringRef Name, StringRef Name,
DIType *Ty, DIType *Ty,
DINodeArray Val); DINodeArray Val);
/// Create debugging information entry for an array. /// createArrayType - Create debugging information entry for an array.
/// \param Size Array size. /// @param Size Array size.
/// \param AlignInBits Alignment. /// @param AlignInBits Alignment.
/// \param Ty Element type. /// @param Ty Element type.
/// \param Subscripts Subscripts. /// @param Subscripts Subscripts.
DICompositeType *createArrayType(uint64_t Size, uint64_t AlignInBits, DICompositeType *createArrayType(uint64_t Size, uint64_t AlignInBits,
DIType *Ty, DINodeArray Subscripts); DIType *Ty, DINodeArray Subscripts);
/// Create debugging information entry for a vector type. /// createVectorType - Create debugging information entry for a vector type.
/// \param Size Array size. /// @param Size Array size.
/// \param AlignInBits Alignment. /// @param AlignInBits Alignment.
/// \param Ty Element type. /// @param Ty Element type.
/// \param Subscripts Subscripts. /// @param Subscripts Subscripts.
DICompositeType *createVectorType(uint64_t Size, uint64_t AlignInBits, DICompositeType *createVectorType(uint64_t Size, uint64_t AlignInBits,
DIType *Ty, DINodeArray Subscripts); DIType *Ty, DINodeArray Subscripts);
/// Create debugging information entry for an /// createEnumerationType - Create debugging information entry for an
/// enumeration. /// enumeration.
/// \param Scope Scope in which this enumeration is defined. /// @param Scope Scope in which this enumeration is defined.
/// \param Name Union name. /// @param Name Union name.
/// \param File File where this member is defined. /// @param File File where this member is defined.
/// \param LineNumber Line number. /// @param LineNumber Line number.
/// \param SizeInBits Member size. /// @param SizeInBits Member size.
/// \param AlignInBits Member alignment. /// @param AlignInBits Member alignment.
/// \param Elements Enumeration elements. /// @param Elements Enumeration elements.
/// \param UnderlyingType Underlying type of a C++11/ObjC fixed enum. /// @param UnderlyingType Underlying type of a C++11/ObjC fixed enum.
/// \param UniqueIdentifier A unique identifier for the enum. /// @param UniqueIdentifier A unique identifier for the enum.
DICompositeType *createEnumerationType( DICompositeType *createEnumerationType(
DIScope *Scope, StringRef Name, DIFile *File, unsigned LineNumber, DIScope *Scope, StringRef Name, DIFile *File, unsigned LineNumber,
uint64_t SizeInBits, uint64_t AlignInBits, DINodeArray Elements, uint64_t SizeInBits, uint64_t AlignInBits, DINodeArray Elements,
DIType *UnderlyingType, StringRef UniqueIdentifier = ""); DIType *UnderlyingType, StringRef UniqueIdentifier = "");
/// Create subroutine type. /// createSubroutineType - Create subroutine type.
/// \param File File in which this subroutine is defined. /// @param File File in which this subroutine is defined.
/// \param ParameterTypes An array of subroutine parameter types. This /// @param ParameterTypes An array of subroutine parameter types. This
/// includes return type at 0th index. /// includes return type at 0th index.
/// \param Flags E.g.: LValueReference. /// @param Flags E.g.: LValueReference.
/// These flags are used to emit dwarf attributes. /// These flags are used to emit dwarf attributes.
DISubroutineType *createSubroutineType(DIFile *File, DISubroutineType *createSubroutineType(DIFile *File,
DITypeRefArray ParameterTypes, DITypeRefArray ParameterTypes,
unsigned Flags = 0); unsigned Flags = 0);
/// Create external type ref. /// createArtificialType - Create a new DIType* with "artificial" flag set.
/// \param Tag Dwarf TAG.
/// \param File Module in which this type is defined.
/// \param UniqueIdentifier A unique identifier for the type.
DICompositeType *createExternalTypeRef(unsigned Tag, DIFile *File,
StringRef UniqueIdentifier);
/// Create a new DIType* with "artificial" flag set.
DIType *createArtificialType(DIType *Ty); DIType *createArtificialType(DIType *Ty);
/// Create a new DIType* with the "object pointer" /// createObjectPointerType - Create a new DIType* with the "object pointer"
/// flag set. /// flag set.
DIType *createObjectPointerType(DIType *Ty); DIType *createObjectPointerType(DIType *Ty);
/// Create a permanent forward-declared type. /// \brief Create a permanent forward-declared type.
DICompositeType *createForwardDecl(unsigned Tag, StringRef Name, DICompositeType *createForwardDecl(unsigned Tag, StringRef Name,
DIScope *Scope, DIFile *F, unsigned Line, DIScope *Scope, DIFile *F, unsigned Line,
unsigned RuntimeLang = 0, unsigned RuntimeLang = 0,
@@ -406,43 +396,43 @@ namespace llvm {
uint64_t AlignInBits = 0, uint64_t AlignInBits = 0,
StringRef UniqueIdentifier = ""); StringRef UniqueIdentifier = "");
/// Create a temporary forward-declared type. /// \brief Create a temporary forward-declared type.
DICompositeType *createReplaceableCompositeType( DICompositeType *createReplaceableCompositeType(
unsigned Tag, StringRef Name, DIScope *Scope, DIFile *F, unsigned Line, unsigned Tag, StringRef Name, DIScope *Scope, DIFile *F, unsigned Line,
unsigned RuntimeLang = 0, uint64_t SizeInBits = 0, unsigned RuntimeLang = 0, uint64_t SizeInBits = 0,
uint64_t AlignInBits = 0, unsigned Flags = DINode::FlagFwdDecl, uint64_t AlignInBits = 0, unsigned Flags = DINode::FlagFwdDecl,
StringRef UniqueIdentifier = ""); StringRef UniqueIdentifier = "");
/// Retain DIType* in a module even if it is not referenced /// retainType - Retain DIType* in a module even if it is not referenced
/// through debug info anchors. /// through debug info anchors.
void retainType(DIType *T); void retainType(DIType *T);
/// Create unspecified parameter type /// createUnspecifiedParameter - Create unspecified parameter type
/// for a subroutine type. /// for a subroutine type.
DIBasicType *createUnspecifiedParameter(); DIBasicType *createUnspecifiedParameter();
/// Get a DINodeArray, create one if required. /// getOrCreateArray - Get a DINodeArray, create one if required.
DINodeArray getOrCreateArray(ArrayRef<Metadata *> Elements); DINodeArray getOrCreateArray(ArrayRef<Metadata *> Elements);
/// Get a DITypeRefArray, create one if required. /// getOrCreateTypeArray - Get a DITypeRefArray, create one if required.
DITypeRefArray getOrCreateTypeArray(ArrayRef<Metadata *> Elements); DITypeRefArray getOrCreateTypeArray(ArrayRef<Metadata *> Elements);
/// Create a descriptor for a value range. This /// getOrCreateSubrange - Create a descriptor for a value range. This
/// implicitly uniques the values returned. /// implicitly uniques the values returned.
DISubrange *getOrCreateSubrange(int64_t Lo, int64_t Count); DISubrange *getOrCreateSubrange(int64_t Lo, int64_t Count);
/// Create a new descriptor for the specified /// createGlobalVariable - Create a new descriptor for the specified
/// variable. /// variable.
/// \param Context Variable scope. /// @param Context Variable scope.
/// \param Name Name of the variable. /// @param Name Name of the variable.
/// \param LinkageName Mangled name of the variable. /// @param LinkageName Mangled name of the variable.
/// \param File File where this variable is defined. /// @param File File where this variable is defined.
/// \param LineNo Line number. /// @param LineNo Line number.
/// \param Ty Variable Type. /// @param Ty Variable Type.
/// \param isLocalToUnit Boolean flag indicate whether this variable is /// @param isLocalToUnit Boolean flag indicate whether this variable is
/// externally visible or not. /// externally visible or not.
/// \param Val llvm::Value of the variable. /// @param Val llvm::Value of the variable.
/// \param Decl Reference to the corresponding declaration. /// @param Decl Reference to the corresponding declaration.
DIGlobalVariable *createGlobalVariable(DIScope *Context, StringRef Name, DIGlobalVariable *createGlobalVariable(DIScope *Context, StringRef Name,
StringRef LinkageName, DIFile *File, StringRef LinkageName, DIFile *File,
unsigned LineNo, DIType *Ty, unsigned LineNo, DIType *Ty,
@@ -450,26 +440,26 @@ namespace llvm {
llvm::Constant *Val, llvm::Constant *Val,
MDNode *Decl = nullptr); MDNode *Decl = nullptr);
/// Identical to createGlobalVariable /// createTempGlobalVariableFwdDecl - Identical to createGlobalVariable
/// except that the resulting DbgNode is temporary and meant to be RAUWed. /// except that the resulting DbgNode is temporary and meant to be RAUWed.
DIGlobalVariable *createTempGlobalVariableFwdDecl( DIGlobalVariable *createTempGlobalVariableFwdDecl(
DIScope *Context, StringRef Name, StringRef LinkageName, DIFile *File, DIScope *Context, StringRef Name, StringRef LinkageName, DIFile *File,
unsigned LineNo, DIType *Ty, bool isLocalToUnit, llvm::Constant *Val, unsigned LineNo, DIType *Ty, bool isLocalToUnit, llvm::Constant *Val,
MDNode *Decl = nullptr); MDNode *Decl = nullptr);
/// Create a new descriptor for the specified /// createLocalVariable - Create a new descriptor for the specified
/// local variable. /// local variable.
/// \param Tag Dwarf TAG. Usually DW_TAG_auto_variable or /// @param Tag Dwarf TAG. Usually DW_TAG_auto_variable or
/// DW_TAG_arg_variable. /// DW_TAG_arg_variable.
/// \param Scope Variable scope. /// @param Scope Variable scope.
/// \param Name Variable name. /// @param Name Variable name.
/// \param File File where this variable is defined. /// @param File File where this variable is defined.
/// \param LineNo Line number. /// @param LineNo Line number.
/// \param Ty Variable Type /// @param Ty Variable Type
/// \param AlwaysPreserve Boolean. Set to true if debug info for this /// @param AlwaysPreserve Boolean. Set to true if debug info for this
/// variable should be preserved in optimized build. /// variable should be preserved in optimized build.
/// \param Flags Flags, e.g. artificial variable. /// @param Flags Flags, e.g. artificial variable.
/// \param ArgNo If this variable is an argument then this argument's /// @param ArgNo If this variable is an argument then this argument's
/// number. 1 indicates 1st argument. /// number. 1 indicates 1st argument.
DILocalVariable *createLocalVariable(unsigned Tag, DIScope *Scope, DILocalVariable *createLocalVariable(unsigned Tag, DIScope *Scope,
StringRef Name, DIFile *File, StringRef Name, DIFile *File,
@@ -478,36 +468,36 @@ namespace llvm {
unsigned Flags = 0, unsigned Flags = 0,
unsigned ArgNo = 0); unsigned ArgNo = 0);
/// Create a new descriptor for the specified /// createExpression - Create a new descriptor for the specified
/// variable which has a complex address expression for its address. /// variable which has a complex address expression for its address.
/// \param Addr An array of complex address operations. /// @param Addr An array of complex address operations.
DIExpression *createExpression(ArrayRef<uint64_t> Addr = None); DIExpression *createExpression(ArrayRef<uint64_t> Addr = None);
DIExpression *createExpression(ArrayRef<int64_t> Addr); DIExpression *createExpression(ArrayRef<int64_t> Addr);
/// Create a descriptor to describe one part /// createBitPieceExpression - Create a descriptor to describe one part
/// of aggregate variable that is fragmented across multiple Values. /// of aggregate variable that is fragmented across multiple Values.
/// ///
/// \param OffsetInBits Offset of the piece in bits. /// @param OffsetInBits Offset of the piece in bits.
/// \param SizeInBits Size of the piece in bits. /// @param SizeInBits Size of the piece in bits.
DIExpression *createBitPieceExpression(unsigned OffsetInBits, DIExpression *createBitPieceExpression(unsigned OffsetInBits,
unsigned SizeInBits); unsigned SizeInBits);
/// Create a new descriptor for the specified subprogram. /// createFunction - Create a new descriptor for the specified subprogram.
/// See comments in DISubprogram* for descriptions of these fields. /// See comments in DISubprogram* for descriptions of these fields.
/// \param Scope Function scope. /// @param Scope Function scope.
/// \param Name Function name. /// @param Name Function name.
/// \param LinkageName Mangled function name. /// @param LinkageName Mangled function name.
/// \param File File where this variable is defined. /// @param File File where this variable is defined.
/// \param LineNo Line number. /// @param LineNo Line number.
/// \param Ty Function type. /// @param Ty Function type.
/// \param isLocalToUnit True if this function is not externally visible. /// @param isLocalToUnit True if this function is not externally visible.
/// \param isDefinition True if this is a function definition. /// @param isDefinition True if this is a function definition.
/// \param ScopeLine Set to the beginning of the scope this starts /// @param ScopeLine Set to the beginning of the scope this starts
/// \param Flags e.g. is this function prototyped or not. /// @param Flags e.g. is this function prototyped or not.
/// These flags are used to emit dwarf attributes. /// These flags are used to emit dwarf attributes.
/// \param isOptimized True if optimization is ON. /// @param isOptimized True if optimization is ON.
/// \param Fn llvm::Function pointer. /// @param Fn llvm::Function pointer.
/// \param TParam Function template parameters. /// @param TParam Function template parameters.
DISubprogram * DISubprogram *
createFunction(DIScope *Scope, StringRef Name, StringRef LinkageName, createFunction(DIScope *Scope, StringRef Name, StringRef LinkageName,
DIFile *File, unsigned LineNo, DISubroutineType *Ty, DIFile *File, unsigned LineNo, DISubroutineType *Ty,
@@ -516,7 +506,7 @@ namespace llvm {
Function *Fn = nullptr, MDNode *TParam = nullptr, Function *Fn = nullptr, MDNode *TParam = nullptr,
MDNode *Decl = nullptr); MDNode *Decl = nullptr);
/// Identical to createFunction, /// createTempFunctionFwdDecl - Identical to createFunction,
/// except that the resulting DbgNode is meant to be RAUWed. /// except that the resulting DbgNode is meant to be RAUWed.
DISubprogram *createTempFunctionFwdDecl( DISubprogram *createTempFunctionFwdDecl(
DIScope *Scope, StringRef Name, StringRef LinkageName, DIFile *File, DIScope *Scope, StringRef Name, StringRef LinkageName, DIFile *File,
@@ -535,25 +525,25 @@ namespace llvm {
Function *Fn = nullptr, MDNode *TParam = nullptr, Function *Fn = nullptr, MDNode *TParam = nullptr,
MDNode *Decl = nullptr); MDNode *Decl = nullptr);
/// Create a new descriptor for the specified C++ method. /// createMethod - Create a new descriptor for the specified C++ method.
/// See comments in \a DISubprogram* for descriptions of these fields. /// See comments in DISubprogram* for descriptions of these fields.
/// \param Scope Function scope. /// @param Scope Function scope.
/// \param Name Function name. /// @param Name Function name.
/// \param LinkageName Mangled function name. /// @param LinkageName Mangled function name.
/// \param File File where this variable is defined. /// @param File File where this variable is defined.
/// \param LineNo Line number. /// @param LineNo Line number.
/// \param Ty Function type. /// @param Ty Function type.
/// \param isLocalToUnit True if this function is not externally visible.. /// @param isLocalToUnit True if this function is not externally visible..
/// \param isDefinition True if this is a function definition. /// @param isDefinition True if this is a function definition.
/// \param Virtuality Attributes describing virtualness. e.g. pure /// @param Virtuality Attributes describing virtualness. e.g. pure
/// virtual function. /// virtual function.
/// \param VTableIndex Index no of this method in virtual table. /// @param VTableIndex Index no of this method in virtual table.
/// \param VTableHolder Type that holds vtable. /// @param VTableHolder Type that holds vtable.
/// \param Flags e.g. is this function prototyped or not. /// @param Flags e.g. is this function prototyped or not.
/// This flags are used to emit dwarf attributes. /// This flags are used to emit dwarf attributes.
/// \param isOptimized True if optimization is ON. /// @param isOptimized True if optimization is ON.
/// \param Fn llvm::Function pointer. /// @param Fn llvm::Function pointer.
/// \param TParam Function template parameters. /// @param TParam Function template parameters.
DISubprogram * DISubprogram *
createMethod(DIScope *Scope, StringRef Name, StringRef LinkageName, createMethod(DIScope *Scope, StringRef Name, StringRef LinkageName,
DIFile *File, unsigned LineNo, DISubroutineType *Ty, DIFile *File, unsigned LineNo, DISubroutineType *Ty,
@@ -562,131 +552,131 @@ namespace llvm {
unsigned Flags = 0, bool isOptimized = false, unsigned Flags = 0, bool isOptimized = false,
Function *Fn = nullptr, MDNode *TParam = nullptr); Function *Fn = nullptr, MDNode *TParam = nullptr);
/// This creates new descriptor for a namespace with the specified /// createNameSpace - This creates new descriptor for a namespace
/// parent scope. /// with the specified parent scope.
/// \param Scope Namespace scope /// @param Scope Namespace scope
/// \param Name Name of this namespace /// @param Name Name of this namespace
/// \param File Source file /// @param File Source file
/// \param LineNo Line number /// @param LineNo Line number
DINamespace *createNameSpace(DIScope *Scope, StringRef Name, DIFile *File, DINamespace *createNameSpace(DIScope *Scope, StringRef Name, DIFile *File,
unsigned LineNo); unsigned LineNo);
/// This creates new descriptor for a module with the specified /// createModule - This creates new descriptor for a module
/// parent scope. /// with the specified parent scope.
/// \param Scope Parent scope /// @param Scope Parent scope
/// \param Name Name of this module /// @param Name Name of this module
/// \param ConfigurationMacros /// @param ConfigurationMacros
/// A space-separated shell-quoted list of -D macro /// A space-separated shell-quoted list of -D macro
/// definitions as they would appear on a command line. /// definitions as they would appear on a command line.
/// \param IncludePath The path to the module map file. /// @param IncludePath The path to the module map file.
/// \param ISysRoot The clang system root (value of -isysroot). /// @param ISysRoot The clang system root (value of -isysroot).
DIModule *createModule(DIScope *Scope, StringRef Name, DIModule *createModule(DIScope *Scope, StringRef Name,
StringRef ConfigurationMacros, StringRef ConfigurationMacros,
StringRef IncludePath, StringRef IncludePath,
StringRef ISysRoot); StringRef ISysRoot);
/// This creates a descriptor for a lexical block with a new file /// createLexicalBlockFile - This creates a descriptor for a lexical
/// attached. This merely extends the existing /// block with a new file attached. This merely extends the existing
/// lexical block as it crosses a file. /// lexical block as it crosses a file.
/// \param Scope Lexical block. /// @param Scope Lexical block.
/// \param File Source file. /// @param File Source file.
/// \param Discriminator DWARF path discriminator value. /// @param Discriminator DWARF path discriminator value.
DILexicalBlockFile *createLexicalBlockFile(DIScope *Scope, DIFile *File, DILexicalBlockFile *createLexicalBlockFile(DIScope *Scope, DIFile *File,
unsigned Discriminator = 0); unsigned Discriminator = 0);
/// This creates a descriptor for a lexical block with the /// createLexicalBlock - This creates a descriptor for a lexical block
/// specified parent context. /// with the specified parent context.
/// \param Scope Parent lexical scope. /// @param Scope Parent lexical scope.
/// \param File Source file. /// @param File Source file.
/// \param Line Line number. /// @param Line Line number.
/// \param Col Column number. /// @param Col Column number.
DILexicalBlock *createLexicalBlock(DIScope *Scope, DIFile *File, DILexicalBlock *createLexicalBlock(DIScope *Scope, DIFile *File,
unsigned Line, unsigned Col); unsigned Line, unsigned Col);
/// Create a descriptor for an imported module. /// \brief Create a descriptor for an imported module.
/// \param Context The scope this module is imported into /// @param Context The scope this module is imported into
/// \param NS The namespace being imported here /// @param NS The namespace being imported here
/// \param Line Line number /// @param Line Line number
DIImportedEntity *createImportedModule(DIScope *Context, DINamespace *NS, DIImportedEntity *createImportedModule(DIScope *Context, DINamespace *NS,
unsigned Line); unsigned Line);
/// Create a descriptor for an imported module. /// \brief Create a descriptor for an imported module.
/// \param Context The scope this module is imported into /// @param Context The scope this module is imported into
/// \param NS An aliased namespace /// @param NS An aliased namespace
/// \param Line Line number /// @param Line Line number
DIImportedEntity *createImportedModule(DIScope *Context, DIImportedEntity *createImportedModule(DIScope *Context,
DIImportedEntity *NS, unsigned Line); DIImportedEntity *NS, unsigned Line);
/// Create a descriptor for an imported module. /// \brief Create a descriptor for an imported module.
/// \param Context The scope this module is imported into /// @param Context The scope this module is imported into
/// \param M The module being imported here /// @param M The module being imported here
/// \param Line Line number /// @param Line Line number
DIImportedEntity *createImportedModule(DIScope *Context, DIModule *M, DIImportedEntity *createImportedModule(DIScope *Context, DIModule *M,
unsigned Line); unsigned Line);
/// Create a descriptor for an imported function. /// \brief Create a descriptor for an imported function.
/// \param Context The scope this module is imported into /// @param Context The scope this module is imported into
/// \param Decl The declaration (or definition) of a function, type, or /// @param Decl The declaration (or definition) of a function, type, or
/// variable /// variable
/// \param Line Line number /// @param Line Line number
DIImportedEntity *createImportedDeclaration(DIScope *Context, DINode *Decl, DIImportedEntity *createImportedDeclaration(DIScope *Context, DINode *Decl,
unsigned Line, unsigned Line,
StringRef Name = ""); StringRef Name = "");
/// Insert a new llvm.dbg.declare intrinsic call. /// insertDeclare - Insert a new llvm.dbg.declare intrinsic call.
/// \param Storage llvm::Value of the variable /// @param Storage llvm::Value of the variable
/// \param VarInfo Variable's debug info descriptor. /// @param VarInfo Variable's debug info descriptor.
/// \param Expr A complex location expression. /// @param Expr A complex location expression.
/// \param DL Debug info location. /// @param DL Debug info location.
/// \param InsertAtEnd Location for the new intrinsic. /// @param InsertAtEnd Location for the new intrinsic.
Instruction *insertDeclare(llvm::Value *Storage, DILocalVariable *VarInfo, Instruction *insertDeclare(llvm::Value *Storage, DILocalVariable *VarInfo,
DIExpression *Expr, const DILocation *DL, DIExpression *Expr, const DILocation *DL,
BasicBlock *InsertAtEnd); BasicBlock *InsertAtEnd);
/// Insert a new llvm.dbg.declare intrinsic call. /// insertDeclare - Insert a new llvm.dbg.declare intrinsic call.
/// \param Storage llvm::Value of the variable /// @param Storage llvm::Value of the variable
/// \param VarInfo Variable's debug info descriptor. /// @param VarInfo Variable's debug info descriptor.
/// \param Expr A complex location expression. /// @param Expr A complex location expression.
/// \param DL Debug info location. /// @param DL Debug info location.
/// \param InsertBefore Location for the new intrinsic. /// @param InsertBefore Location for the new intrinsic.
Instruction *insertDeclare(llvm::Value *Storage, DILocalVariable *VarInfo, Instruction *insertDeclare(llvm::Value *Storage, DILocalVariable *VarInfo,
DIExpression *Expr, const DILocation *DL, DIExpression *Expr, const DILocation *DL,
Instruction *InsertBefore); Instruction *InsertBefore);
/// Insert a new llvm.dbg.value intrinsic call. /// insertDbgValueIntrinsic - Insert a new llvm.dbg.value intrinsic call.
/// \param Val llvm::Value of the variable /// @param Val llvm::Value of the variable
/// \param Offset Offset /// @param Offset Offset
/// \param VarInfo Variable's debug info descriptor. /// @param VarInfo Variable's debug info descriptor.
/// \param Expr A complex location expression. /// @param Expr A complex location expression.
/// \param DL Debug info location. /// @param DL Debug info location.
/// \param InsertAtEnd Location for the new intrinsic. /// @param InsertAtEnd Location for the new intrinsic.
Instruction *insertDbgValueIntrinsic(llvm::Value *Val, uint64_t Offset, Instruction *insertDbgValueIntrinsic(llvm::Value *Val, uint64_t Offset,
DILocalVariable *VarInfo, DILocalVariable *VarInfo,
DIExpression *Expr, DIExpression *Expr,
const DILocation *DL, const DILocation *DL,
BasicBlock *InsertAtEnd); BasicBlock *InsertAtEnd);
/// Insert a new llvm.dbg.value intrinsic call. /// insertDbgValueIntrinsic - Insert a new llvm.dbg.value intrinsic call.
/// \param Val llvm::Value of the variable /// @param Val llvm::Value of the variable
/// \param Offset Offset /// @param Offset Offset
/// \param VarInfo Variable's debug info descriptor. /// @param VarInfo Variable's debug info descriptor.
/// \param Expr A complex location expression. /// @param Expr A complex location expression.
/// \param DL Debug info location. /// @param DL Debug info location.
/// \param InsertBefore Location for the new intrinsic. /// @param InsertBefore Location for the new intrinsic.
Instruction *insertDbgValueIntrinsic(llvm::Value *Val, uint64_t Offset, Instruction *insertDbgValueIntrinsic(llvm::Value *Val, uint64_t Offset,
DILocalVariable *VarInfo, DILocalVariable *VarInfo,
DIExpression *Expr, DIExpression *Expr,
const DILocation *DL, const DILocation *DL,
Instruction *InsertBefore); Instruction *InsertBefore);
/// Replace the vtable holder in the given composite type. /// \brief Replace the vtable holder in the given composite type.
/// ///
/// If this creates a self reference, it may orphan some unresolved cycles /// If this creates a self reference, it may orphan some unresolved cycles
/// in the operands of \c T, so \a DIBuilder needs to track that. /// in the operands of \c T, so \a DIBuilder needs to track that.
void replaceVTableHolder(DICompositeType *&T, void replaceVTableHolder(DICompositeType *&T,
DICompositeType *VTableHolder); DICompositeType *VTableHolder);
/// Replace arrays on a composite type. /// \brief Replace arrays on a composite type.
/// ///
/// If \c T is resolved, but the arrays aren't -- which can happen if \c T /// If \c T is resolved, but the arrays aren't -- which can happen if \c T
/// has a self-reference -- \a DIBuilder needs to track the array to /// has a self-reference -- \a DIBuilder needs to track the array to
@@ -694,7 +684,7 @@ namespace llvm {
void replaceArrays(DICompositeType *&T, DINodeArray Elements, void replaceArrays(DICompositeType *&T, DINodeArray Elements,
DINodeArray TParems = DINodeArray()); DINodeArray TParems = DINodeArray());
/// Replace a temporary node. /// \brief Replace a temporary node.
/// ///
/// Call \a MDNode::replaceAllUsesWith() on \c N, replacing it with \c /// Call \a MDNode::replaceAllUsesWith() on \c N, replacing it with \c
/// Replacement. /// Replacement.