user0/rust
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Document virality of feature(rustc_private)

Browse source 
Since 9cb1998ea1 this feature is viral.
This commit is contained in:
Tamir Duberstein 2024-12-28 08:44:25 -05:00
parent 8b3f7ac526
commit 35e5c7d438
No known key found for this signature in database
1 changed files with 5 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

7
src/doc/unstable-book/src/language-features/rustc-private.md
View file

@ -6,6 +6,9 @@ The tracking issue for this feature is: [#27812]
------------------------
This feature allows access to unstable internal compiler crates.
This feature allows access to unstable internal compiler crates such as `rustc_driver`.
Additionally it changes the linking behavior of crates which have this feature enabled. It will prevent linking to a dylib if there's a static variant of it already statically linked into another dylib dependency. This is required to successfully link to `rustc_driver`.
The presence of this feature changes the way the linkage format for dylibs is calculated in a way
that is necessary for linking against dylibs that statically link `std` (such as `rustc_driver`).
This makes this feature "viral" in linkage; its use in a given crate makes its use required in
dependent crates which link to it (including integration tests, which are built as separate crates).