imperio

@imperio@toot.cat

#rustlang reviewer and contributor, #rustdoc team leader, #gnome foundation member, owner of the Gtk-rs organization

This profile is from a federated server and may be incomplete. Browse more on the original instance.

hywan, to rust
@hywan@fosstodon.org avatar

Aquamarine, https://github.com/mersinvald/aquamarine.

> Aquamarine is a procedural macro extension for rustdoc, that aims to improve the visual component of Rust documentation through use of the mermaid.js diagrams.

Quite neat. I’m unsure what are the benefits over providing an image (even vectorised, eg SVG), but it’s possible.

imperio,

@hywan @bnjbvr_en Indeed :)

imperio, to rust

My new clippy lint just got merged! In case you have a &mut argument of a function which could be a &, it'll tell you so.

You can find examples in the PR: https://github.com/rust-lang/rust-clippy/pull/10900

imperio, to rust

The rustdoc search query syntax evolved a bit: whitespace characters are not considered the same as , anymore but instead as equivalent of ::. Example:

query:  Vec new<br></br>before: Vec,new<br></br>after:  Vec::new<br></br>

PR: https://github.com/rust-lang/rust/pull/108537

imperio, to rust

Following feedback, we improved the new display of rustdoc search results to have the type names aligned on the left.

https://github.com/rust-lang/rust/pull/113100

imperio,

@janriemer @laund Discussed and rejected. You can see some screenshots of the results in the few PRs on this feature. Basically, it was too much visual information and also shifted focus from the "primary" information. We want the users attention to be first on the result itself, then eventually on the docs/type name.

imperio, to rust

Big step forward just reached today in rustdoc for cross-crate type aliases thanks to the compiler team!

Explanations:

// crate a<br></br>pub type A = Result<u32, ()>;<br></br><br></br>// crate b<br></br>pub fn foo() -> a::A;<br></br>

In docs of crate b you will see "fn foo() -> Result` because the type alias information is not exported.

I added a feature in case you want to test it in https://github.com/rust-lang/rust/pull/112853. Now we need to fix all bugs so it can be enabled by default.

imperio, to rust

The type of the item is now before the item name in rustdoc search results (first text on the left). It should make it much easier for everyone to make it more obvious what each type is without having to remember colors.

The PR was https://github.com/rust-lang/rust/pull/110688.

imperio, to rust

It seems like the re-export fixes marathon in rustdoc is finished (let's cross fingers!). My PR to document re-exports behaviour in rustdoc just got merged (https://github.com/rust-lang/rust/pull/112304)! \o/

I'll make another post once the chapter will be available in the rustdoc book.

imperio, to rust

Just published the 8.3.0 version of the geos crate.

It prevents the compute_voronoi function to panic by adding new variants in the geos::Error enum.

https://crates.io/crates/geos

imperio, to rust

A funny case where rustdoc picked too many items:

pub fn foo() {<br></br>    pub mod inaccessible {}<br></br>}<br></br>

In this case, inaccessible was visible in the documentation because rustdoc was considering all wrapping items the same as modules.

I fixed it in https://github.com/rust-lang/rust/pull/111642.

imperio, to rust

More work on rustdoc re-exports. I continue to fix the corner cases I find around. Hopefully (strong hopes) we'll have an official handling of re-exports and its documentation ready in the next weeks.

Last re-export PRs:

imperio, to rust French

Je viens tout juste de mettre à jour mon tutoriel pour apprendre le langage Rust en français. Notamment les parties sur les durées de vie et la généricité. Vous pouvez voir tout ça ici : https://blog.guillaume-gomez.fr/Rust

Bonne lecture !

imperio, to rust

The sysinfo crate just reached 10 million downloads! \o/

https://crates.io/crates/sysinfo

imperio, to rust

docs.rs navigation should now be much faster overall: the release list is now only loaded when the dropdown menu is opened, greatly reducing the default amount of data downloaded and rendered.

https://github.com/rust-lang/docs.rs/pull/2113

imperio, to rust

Just released the "0.29.0" version of the sysinfo crate! Lot of changes/bugfixes this time:

  • Added API to get effective_user_id and effective_group_id.
  • Fixed a long standing issue with macOS processes status.
  • Renamed DiskType into DiskKind.

Most changes come from contributors this time, so many thanks to them! cc @zeenix

https://crates.io/crates/sysinfo

imperio, to programming

I have some improvements and fixes for the sysinfo crate that I've been wanted to do for weeks but can't find the time for it... T_T

One of them I discovered thanks to @slomo is that some C functions could error with "EINTR", which means you should call it again and not return with an error. The more you know...

https://github.com/guillaumegomez/sysinfo

  • All
  • Subscribed
  • Moderated
  • Favorites
  • anitta
  • thenastyranch
  • magazineikmin
  • everett
  • InstantRegret
  • rosin
  • Youngstown
  • slotface
  • love
  • khanakhh
  • kavyap
  • tacticalgear
  • GTA5RPClips
  • DreamBathrooms
  • megavids
  • modclub
  • mdbf
  • tester
  • Durango
  • ethstaker
  • osvaldo12
  • cubers
  • ngwrru68w68
  • provamag3
  • normalnudes
  • Leos
  • cisconetworking
  • JUstTest
  • All magazines