int3 updated this revision to Diff 444740. int3 retitled this revision from "[clang] Document -femit-compact-unwind flag in the User’s Manual" to "[clang] Document -femit-compact-unwind option in the User’s Manual". int3 added a comment.
option Repository: rG LLVM Github Monorepo CHANGES SINCE LAST ACTION https://reviews.llvm.org/D129772/new/ https://reviews.llvm.org/D129772 Files: clang/docs/UsersManual.rst Index: clang/docs/UsersManual.rst =================================================================== --- clang/docs/UsersManual.rst +++ clang/docs/UsersManual.rst @@ -843,6 +843,23 @@ option tells Clang to put double-quotes around the entire filename, which is the convention used by NMake and Jom. +.. option:: -femit-dwarf-unwind=<value> + + When to emit DWARF unwind (EH frame) info. This is a Mach-O-specific option. + + Valid values are: + + * ``no-compact-unwind`` - Only emit DWARF unwind when compact unwind encodings + aren't available. This is the default for AArch64. + * ``always`` - Always emit DWARF unwind regardless. + * ``default`` - Use the platform-specific default (``always`` for all + non-AArch64-platforms). + +``no-compact-unwind`` is a performance optimization -- Clang will emit smaller +object files that are more quickly processed by the linker. This may cause +binary compatibility issues on older x86_64 targets, however, so use it with +caution. + .. _configuration-files: Configuration files
Index: clang/docs/UsersManual.rst =================================================================== --- clang/docs/UsersManual.rst +++ clang/docs/UsersManual.rst @@ -843,6 +843,23 @@ option tells Clang to put double-quotes around the entire filename, which is the convention used by NMake and Jom. +.. option:: -femit-dwarf-unwind=<value> + + When to emit DWARF unwind (EH frame) info. This is a Mach-O-specific option. + + Valid values are: + + * ``no-compact-unwind`` - Only emit DWARF unwind when compact unwind encodings + aren't available. This is the default for AArch64. + * ``always`` - Always emit DWARF unwind regardless. + * ``default`` - Use the platform-specific default (``always`` for all + non-AArch64-platforms). + +``no-compact-unwind`` is a performance optimization -- Clang will emit smaller +object files that are more quickly processed by the linker. This may cause +binary compatibility issues on older x86_64 targets, however, so use it with +caution. + .. _configuration-files: Configuration files
_______________________________________________ cfe-commits mailing list cfe-commits@lists.llvm.org https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits
