Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

doc: Comparison to Ecosystem (including Rust std impl) [doc: 4/N]#1292

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 ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Merged
nicholasbishop merged 2 commits intorust-osdev:mainfromphip1611:doc5
Aug 15, 2024

Conversation

phip1611
Copy link
Member

@phip1611phip1611 commentedAug 6, 2024
edited
Loading

This is split-out 4/N from#1264 to improve reviewability.

This:

  • adds a minimal example inlib.rs so that readers know what to expect from the crate
  • comparesuefi to other impls in the ecosystem, especially to thestd impl for Rust
  • adds a minimal example for a Rust app built withstd anduefi

Steps to Un-draft

Checklist

  • Sensible git history (for example, squash "typo" or "fix" commits). See theRewriting History guide for help.
  • Update the changelog (if necessary)

Aalivexy reacted with heart emoji
@phip1611phip1611force-pushed thedoc5 branch 2 times, most recently from299a9f7 to979c131CompareAugust 6, 2024 15:39
@phip1611phip1611 changed the titledoc: move misc stuff from README to lib.rs [doc: 4/N]doc: TODO [doc: 4/N]Aug 6, 2024
@phip1611phip1611 mentioned this pull requestAug 6, 2024
2 tasks
@phip1611phip1611 linked an issueAug 12, 2024 that may beclosed by this pull request
@phip1611phip1611 changed the titledoc: TODO [doc: 4/N]doc: Comparison to Ecosystem (including Rust std impl) [doc: 4/N]Aug 14, 2024
@phip1611phip1611 marked this pull request as ready for reviewAugust 14, 2024 11:16
@phip1611phip1611force-pushed thedoc5 branch 3 times, most recently fromb2ec5d5 to2f42ea8CompareAugust 14, 2024 11:24
//! to our `uefi-raw` crate, which is part of this project, but more
//! feature-complete. It targets a lower-level than our `uefi` crate does.
//!
//! # MSRV

Choose a reason for hiding this comment

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

The MSRV section was already added tolib.rs in a previous PR, so this can be dropped.

Copy link
MemberAuthor

Choose a reason for hiding this comment

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

Sorry, artifact from a big rebase - I missed that.

Choose a reason for hiding this comment

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

The duplicate MSRV section is still present

Copy link
MemberAuthor

Choose a reason for hiding this comment

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

What?! How? I definitely removed that locally.

Sorry.. I really have no clue how this happened.

@phip1611phip1611force-pushed thedoc5 branch 3 times, most recently from6de3a05 to89dceefCompareAugust 14, 2024 18:01
@phip1611
Copy link
MemberAuthor

Nice! I will split the "rust-std-example" into a dedicated MR. Can you approve it in its current state, please?

//! Minimal example for an UEFI application using functionality of the
//! `uefi` crate:
//!
//! ```ignore

Choose a reason for hiding this comment

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

Withignore there's a good chance the code will stop compiling over time (in fact currently it's missing ause uefi::println). It's tricky to getno_std code compiling in a doc test, so how about linking to a file that is already tested by CI? Example:

//! ```ignore#![doc =include_str!("../../template/src/main.rs")]//! ```

Copy link
MemberAuthor

Choose a reason for hiding this comment

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

Oh, great idea! Thanks

@phip1611phip1611force-pushed thedoc5 branch 2 times, most recently from3ce42be tob605167CompareAugust 15, 2024 16:06
This is especially interesting as the `std` implementation of Rust is upcoming.
@nicholasbishopnicholasbishop added this pull request to themerge queueAug 15, 2024
Merged via the queue intorust-osdev:main with commita07379eAug 15, 2024
13 checks passed
@phip1611phip1611 deleted the doc5 branchAugust 15, 2024 16:36
@phip1611
Copy link
MemberAuthor

I'm very happy about the recent documentation additions, especially this one and#1331. This helps, I hope, to position ourself in the long term as the ones that define what is relevant, convenient and practical in UEFI with Rust and how the APIs should be designed, asstd and the ecosystem grow closer together

Sign up for freeto join this conversation on GitHub. Already have an account?Sign in to comment
Reviewers

@nicholasbishopnicholasbishopnicholasbishop approved these changes

Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.

Use with nightly uefi-std
2 participants
@phip1611@nicholasbishop

[8]ページ先頭

©2009-2025 Movatter.jp