Skip to content

Commit

Permalink
wrap suffix paragraph at 80 chars
Browse files Browse the repository at this point in the history
  • Loading branch information
lqd committed Mar 2, 2022
1 parent 8e83f7f commit 9b2672d
Showing 1 changed file with 10 additions and 8 deletions.
18 changes: 10 additions & 8 deletions text/2603-rust-symbol-name-mangling-v0.md
Original file line number Diff line number Diff line change
Expand Up @@ -808,14 +808,16 @@ like regular identifiers and need no further special handling.

### Vendor-specific suffix

Similarly to the [Itanium C++ ABI mangling scheme][itanium-mangling-structure], a symbol name
containing a period (`.`) or a dollar sign (`$`) represents a vendor-specific version of the symbol.
There are no restrictions on the characters following the period or dollar sign.

This can happen in practice when locally unique names needed to become globally unique. For example,
LLVM can append a `.llvm.<numbers>` suffix during LTO to ensure a unique name, and `$` can be used
for thread-local data on Mach-O. In these situations it's generally fine to ignore the suffix: the
suffixed name has the same semantics as the original.
Similarly to the [Itanium C++ ABI mangling scheme][itanium-mangling-structure],
a symbol name containing a period (`.`) or a dollar sign (`$`) represents a
vendor-specific version of the symbol. There are no restrictions on the
characters following the period or dollar sign.

This can happen in practice when locally unique names needed to become globally
unique. For example, LLVM can append a `.llvm.<numbers>` suffix during LTO to
ensure a unique name, and `$` can be used for thread-local data on Mach-O. In
these situations it's generally fine to ignore the suffix: the suffixed name has
the same semantics as the original.

[itanium-mangling-structure]: https://itanium-cxx-abi.github.io/cxx-abi/abi.html#mangling-structure

Expand Down

0 comments on commit 9b2672d

Please sign in to comment.