Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Refactor documentation for Apple targets #124772

Merged
merged 1 commit into from
May 21, 2024

Conversation

madsmtm
Copy link
Contributor

@madsmtm madsmtm commented May 5, 2024

Refactor the documentation for Apple targets in rustc's platform support page to make it clear what the supported OS version is and which environment variables are being read (*_DEPLOYMENT_TARGET and SDKROOT). This fixes #124215.

Note that I've expanded the aarch64-apple-ios-sim maintainers @badboy and @deg4uss3r to include being maintainer of all *-apple-ios-* targets. If you do not wish to be so, please state that, then I'll explicitly note that in the docs.

Additionally, I've added myself as co-maintainer of most of these targets.

r? @thomcc

I think the documentation you've previously written on tvOS is great, have mostly modified it to have a more consistent formatting with the rest of the Apple target.

I recognize that there's quite a few changes here, feel free to ask about any of them!


CC @simlay @Nilstrieb

@rustbot label O-apple

- Fixed std support in top-level docs.
- Added `*-apple-darwin` docs.
- Added `i686-apple-darwin` docs.
- Moved `aarch64-apple-ios-sim` to `*-apple-ios` and document all the
  iOS targets there.
- Added `*-apple-ios-macabi` docs.
- Add myself (madsmtm) as co-maintainer of most of these targets.
@rustbot rustbot added S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. T-compiler Relevant to the compiler team, which will review and decide on the PR/issue. labels May 5, 2024
@rustbot
Copy link
Collaborator

rustbot commented May 5, 2024

These commits modify compiler targets.
(See the Target Tier Policy.)

Some changes occurred in src/doc/rustc/src/platform-support

cc @Nilstrieb

@rustbot rustbot added the O-apple Operating system: Apple (macOS, iOS, tvOS, visionOS, watchOS) label May 5, 2024
@badboy
Copy link
Member

badboy commented May 6, 2024

works for me. The targets are similar enough and I use them that I can try to help if things break.

@madsmtm
Copy link
Contributor Author

madsmtm commented May 17, 2024

r? compiler

@rustbot
Copy link
Collaborator

rustbot commented May 17, 2024

Error: Parsing assign command in comment failed: ...'' | error: specify user to assign to at >| ''...

Please file an issue on GitHub at triagebot if there's a problem with this bot, or reach out on #t-infra on Zulip.

@rustbot rustbot assigned oli-obk and unassigned thomcc May 17, 2024
@oli-obk
Copy link
Contributor

oli-obk commented May 21, 2024

I don't have an opinion on the changes, but they look like an improvement and y'all seem happy with it.

@bors r+ rollup

@bors
Copy link
Contributor

bors commented May 21, 2024

📌 Commit 0eb782d has been approved by oli-obk

It is now in the queue for this repository.

@bors bors added S-waiting-on-bors Status: Waiting on bors to run and complete tests. Bors will change the label on completion. and removed S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. labels May 21, 2024
bors added a commit to rust-lang-ci/rust that referenced this pull request May 21, 2024
…iaskrgr

Rollup of 7 pull requests

Successful merges:

 - rust-lang#124570 (Miscellaneous cleanups)
 - rust-lang#124772 (Refactor documentation for Apple targets)
 - rust-lang#125011 (Add opt-for-size core lib feature flag)
 - rust-lang#125218 (Migrate `run-make/no-intermediate-extras` to new `rmake.rs`)
 - rust-lang#125225 (Use functions from `crt_externs.h` on iOS/tvOS/watchOS/visionOS)
 - rust-lang#125266 (compiler: add simd_ctpop intrinsic)
 - rust-lang#125348 (Small fixes to `std::path::absolute` docs)

Failed merges:

 - rust-lang#125296 (Fix `unexpected_cfgs` lint on std)

r? `@ghost`
`@rustbot` modify labels: rollup
@bors bors merged commit 4a4883b into rust-lang:master May 21, 2024
6 checks passed
@rustbot rustbot added this to the 1.80.0 milestone May 21, 2024
rust-timer added a commit to rust-lang-ci/rust that referenced this pull request May 21, 2024
Rollup merge of rust-lang#124772 - madsmtm:apple-platform-support-docs, r=oli-obk

Refactor documentation for Apple targets

Refactor the documentation for Apple targets in `rustc`'s platform support page to make it clear what the supported OS version is and which environment variables are being read (`*_DEPLOYMENT_TARGET` and `SDKROOT`). This fixes rust-lang#124215.

Note that I've expanded the `aarch64-apple-ios-sim` maintainers `@badboy` and `@deg4uss3r` to include being maintainer of all `*-apple-ios-*` targets. If you do not wish to be so, please state that, then I'll explicitly note that in the docs.

Additionally, I've added myself as co-maintainer of most of these targets.

r? `@thomcc`

I think the documentation you've previously written on tvOS is great, have mostly modified it to have a more consistent formatting with the rest of the Apple target.

I recognize that there's quite a few changes here, feel free to ask about any of them!

---

CC `@simlay` `@Nilstrieb`

`@rustbot` label O-apple
@madsmtm madsmtm deleted the apple-platform-support-docs branch May 21, 2024 19:57
Comment on lines +23 to +26
- [arm64e-apple-darwin.md](platform-support/arm64e-apple-darwin.md)
- [\*-apple-ios](platform-support/apple-ios.md)
- [\*-apple-ios-macabi](platform-support/apple-ios-macabi.md)
- [arm64e-apple-ios.md](platform-support/arm64e-apple-ios.md)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the .md suffix is probably not needed?

Suggested change
- [arm64e-apple-darwin.md](platform-support/arm64e-apple-darwin.md)
- [\*-apple-ios](platform-support/apple-ios.md)
- [\*-apple-ios-macabi](platform-support/apple-ios-macabi.md)
- [arm64e-apple-ios.md](platform-support/arm64e-apple-ios.md)
- [arm64e-apple-darwin](platform-support/arm64e-apple-darwin.md)
- [\*-apple-ios](platform-support/apple-ios.md)
- [\*-apple-ios-macabi](platform-support/apple-ios-macabi.md)
- [arm64e-apple-ios](platform-support/arm64e-apple-ios.md)

fmease added a commit to fmease/rust that referenced this pull request May 22, 2024
Remove unnecessary `.md` from the documentation sidebar

Oversight from rust-lang#124772, caught in rust-lang#124772 (comment).

r? weihanglo
fmease added a commit to fmease/rust that referenced this pull request May 22, 2024
Remove unnecessary `.md` from the documentation sidebar

Oversight from rust-lang#124772, caught in rust-lang#124772 (comment).

r? weihanglo
rust-timer added a commit to rust-lang-ci/rust that referenced this pull request May 22, 2024
Rollup merge of rust-lang#125395 - madsmtm:fix-doc-summary, r=lqd

Remove unnecessary `.md` from the documentation sidebar

Oversight from rust-lang#124772, caught in rust-lang#124772 (comment).

r? weihanglo
github-actions bot pushed a commit to rust-lang/miri that referenced this pull request May 23, 2024
Remove unnecessary `.md` from the documentation sidebar

Oversight from rust-lang/rust#124772, caught in rust-lang/rust#124772 (comment).

r? weihanglo
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
O-apple Operating system: Apple (macOS, iOS, tvOS, visionOS, watchOS) S-waiting-on-bors Status: Waiting on bors to run and complete tests. Bors will change the label on completion. T-compiler Relevant to the compiler team, which will review and decide on the PR/issue.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Document minimum supported versions for apple operating systems to platform documentation
8 participants