@@ -67,30 +67,30 @@ pub(crate) fn maybe_sign_fn_ptr<'ll, 'tcx>(
6767}
6868
6969/*
70- * A note on nomenclature of linking: "extern", "foreign", and "upcall".
71- *
72- * An "extern" is an LLVM symbol we wind up emitting an undefined external
73- * reference to. This means "we don't have the thing in this compilation unit,
74- * please make sure you link it in at runtime". This could be a reference to
75- * C code found in a C library, or rust code found in a rust crate.
76- *
77- * Most "externs" are implicitly declared (automatically) as a result of a
78- * user declaring an extern _module_ dependency; this causes the rust driver
79- * to locate an extern crate, scan its compilation metadata, and emit extern
80- * declarations for any symbols used by the declaring crate.
81- *
82- * A "foreign" is an extern that references C (or other non-rust ABI) code.
83- * There is no metadata to scan for extern references so in these cases either
84- * a header-digester like bindgen, or manual function prototypes, have to
85- * serve as declarators. So these are usually given explicitly as prototype
86- * declarations, in rust code, with ABI attributes on them noting which ABI to
87- * link via.
88- *
89- * An "upcall" is a foreign call generated by the compiler (not corresponding
90- * to any user-written call in the code) into the runtime library, to perform
91- * some helper task such as bringing a task to life, allocating memory, etc.
92- *
93- */
70+ * A note on nomenclature of linking: "extern", "foreign", and "upcall".
71+ *
72+ * An "extern" is an LLVM symbol we wind up emitting an undefined external
73+ * reference to. This means "we don't have the thing in this compilation unit,
74+ * please make sure you link it in at runtime". This could be a reference to
75+ * C code found in a C library, or rust code found in a rust crate.
76+ *
77+ * Most "externs" are implicitly declared (automatically) as a result of a
78+ * user declaring an extern _module_ dependency; this causes the rust driver
79+ * to locate an extern crate, scan its compilation metadata, and emit extern
80+ * declarations for any symbols used by the declaring crate.
81+ *
82+ * A "foreign" is an extern that references C (or other non-rust ABI) code.
83+ * There is no metadata to scan for extern references so in these cases either
84+ * a header-digester like bindgen, or manual function prototypes, have to
85+ * serve as declarators. So these are usually given explicitly as prototype
86+ * declarations, in rust code, with ABI attributes on them noting which ABI to
87+ * link via.
88+ *
89+ * An "upcall" is a foreign call generated by the compiler (not corresponding
90+ * to any user-written call in the code) into the runtime library, to perform
91+ * some helper task such as bringing a task to life, allocating memory, etc.
92+ *
93+ */
9494
9595/// A structure representing an active landing pad for the duration of a basic
9696/// block.
0 commit comments