Tracking Issue for `-Z link-directives`
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 119k
- Forks
- 16.1k
- PR merge metrics
- PR metrics pending
Description
This is a tracking issue for the unstable rustc flag -Z link-directives where
-Zlink-directives=nowill ignored#[link]directives while compiling a crate, so nothing is emitted into the crate's metadata. The assumption is that the build system already knows about the crate's native dependencies and can provide them at link time without these directives.PR description of https://github.com/rust-lang/rust/pull/107675#issue-1571163041
About tracking issues
Tracking issues are used to record the overall progress of implementation. They are also used as hubs connecting to other relevant issues, e.g., bugs or open design questions. A tracking issue is however not meant for large scale discussion, questions, or bug reports about a feature. Instead, open a dedicated issue for the specific matter and add the relevant feature gate label.
Steps
-
Open an MCP and have it accepted.At the time of impl, there was no such requirement. - Implementation
- Adjust documentation (see instructions on rustc-dev-guide)
- Stabilization PR (see instructions on rustc-dev-guide)
Unresolved Questions
- Missing unstable flag documentation?
- What does this unstable rustc flag
-Z link-directivesdo, exactly? - How does it relate to the stable
#[link]attribute? - What does this mean for the
#[link]attribute (which is a stable attribute)? - How does this unstable flag relate to
-Z link-native-libraries?
Implementation history
- Initial implementation PR: https://github.com/rust-lang/rust/pull/107675
Related links
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the linked implementation PR and the rustc-dev-guide documentation and stabilization guides. Clarify what the -Z link-directives flag does, how it relates to #[link] and -Z link-native-libraries, then update the relevant documentation and prepare the stabilization PR described by the checklist.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- compilers
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 30/100