Why is rustdoc so slow? I feel like it wasn't that slow 'before'. (I don't have a cutoff, but I built docs for projects like these before, and it did not take half an hour lmao)
Sure it was 800 crates (Most of which are crates I don't build, so I assume they are crates for other platforms) but 25 minutes ?? And most of it seemingly single-threaded? On a 12-core processor!
This is on rustdoc 1.91.0
@imperio I’ve been struggling with the new search UI on docs.rs. My brain keeps hunting for a text box to type in, so I end up clicking the global search bar instead of the crate icon every time.
It's especially confusing seeing the old vs new UI on different crates. Is there a reason we moved away from the persistent bar? I'd be happy to file an issue/PR to improve the icon's visibility!
Edit: TIL how to reference another method in #Rustdoc. It was not intuitive!
https://doc.rust-lang.org/rustdoc/write-documentation/linking-to-items-by-name.html
I thought I could do this:
[`self.calc_new_offset(min_offset)`]
However, that is not turned into a link.
I had a look at the std lib docs to find an example; https://doc.rust-lang.org/src/core/bool.rs.html#72
So this is what I gotta do:
Use [`calc_new_offset`] in my description, and then later, declare what it is supposed to be:
[`calc_new_offset`]: Directory::calc_new_offset
Fixed yet another reexport bug in rustdoc:
mod raw {
pub struct Foo;
}
pub use raw::Foo;
pub use raw::*;
In this code, Foo was imported twice and the second one overwrote the first, making docs and attributes nonsensical.
[Перевод] Rust 1.88.0: Цепочки let, naked-функции, булевы литералы в cfg и очистка кеша cargo
Команда Rust рада сообщить о новой версии языка — 1.88.0. Rust — это язык программирования, позволяющий каждому создавать надёжное и эффективное программное обеспечение. Если у вас есть предыдущая версия Rust, установленная через rustup , то для обновления до версии 1.88.0 вам достаточно выполнить команду: $ rustup update stable Если у вас ещё не установлен rustup , вы можете установить его с соответствующей страницы нашего веб-сайта, а также посмотреть подробные примечания к выпуску на GitHub. Если вы хотите помочь нам протестировать будущие выпуски, вы можете использовать канал beta ( rustup default beta ) или nightly ( rustup default nightly ). Пожалуйста, сообщайте обо всех встреченных вами ошибках.
https://habr.com/ru/articles/922762/
#clippy #cargo #rustc #rustdoc #rustfmt #rustfix #release #stable #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод
[Перевод] Rust 1.87.0: 10 лет Rust, анонимные каналы, безопасный вызов встроенных интринсиков
Rust 1.87.0 и 10 лет Rust! Команда Rust празднует 10-летие Rust в Утрехте, Нидерланды, и рада сообщить о новой версии языка — 1.87.0! Сегодняшний день релиза выпал на 10-летний юбилей выхода Rust 1.0 ! Спасибо мириадам участников, кто работал или работает над Rust. Выпьем за ещё многие десятилетия впереди! 🎉 Как обычно, новая версия включает в себя все изменения, которые были внесены в бета-версию за последние шесть недель согласно последовательному и регулярному циклу выпуска. Мы следуем ему начиная с Rust 1.0. Если у вас есть предыдущая версия Rust, установленная через rustup , то для обновления до версии 1.87.0 вам достаточно выполнить команду:
https://habr.com/ru/articles/910204/
#clippy #cargo #rustc #rustdoc #rustfmt #rustfix #release #stable #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод
Most annoying thing about #rustdoc: when you look up the impl of a standard #RustLang trait on a particular concrete type, and it just repeats the documentation from the trait itself.
1. I wanted to know how the trait's functionality is interpreted for _this type_. E.g. don't just tell me `Add` implements the addition operator – tell me what addition _means_ for this particular type. Or if the trait docs say "you can do X or Y", I want to know which option this type chose, and maybe why.
2. Trait docs often include advice to the trait implementor, and in this context, that advice is going to the wrong person. E.g. the docs for PartialEq::ne() say it's a mistake to override the default implementation without a really good reason. This is useful advice if I'm implementing PartialEq on my own type. But when I look up the impl of PartialEq on someone else's type, _I_ don't need to be told what the crate author ought not to have done!
In fact rustdoc doesn't even tell me _whether_ the crate author _did_ override ne() (without providing a replacement doc comment), or whether they left the default in place. So it's not just nagging the wrong person – it's nagging the wrong person about a thing that very likely didn't even happen!
In principle, crate authors could fix #1 by being less lazy, and writing custom docs for their impls. But fixing #2 is really hard. If I want to delete that nagging comment about PartialEq::ne(), I have to do it by overriding the default implementation – exactly what the comment tells me not to do!
[Перевод] Rust 1.86.0: преобразование в родительский трейт, поддержка изменяемой индексации для HashMap и срезов
Команда Rust рада сообщить о новой версии языка — 1.86.0. Rust — это язык программирования, позволяющий каждому создавать надёжное и эффективное программное обеспечение. Если у вас есть предыдущая версия Rust, установленная через rustup , то для обновления до версии 1.86.0 вам достаточно выполнить команду: $ rustup update stable Если у вас ещё не установлен rustup , вы можете установить его с соответствующей страницы нашего веб-сайта, а также посмотреть подробные примечания к выпуску на GitHub. Если вы хотите помочь нам протестировать будущие выпуски, вы можете использовать канал beta ( rustup default beta ) или nightly ( rustup default nightly ). Пожалуйста, сообщайте обо всех встреченных вами ошибках.
https://habr.com/ru/articles/898008/
#clippy #cargo #rustc #rustdoc #rustfmt #rustfix #release #stable #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод
With #rustup, we can view the #Rust #documentation in our browser :firefox: which is very helpful.
The docs are located at "${HOME}/.rustup/toolchains/"${ToolChain}/share/doc/rust/html/"
If your browser can't access that location (for instance due to confinement rules), you can spin up a quick http server
:python: 🌐 python3 -m http.server --directory "${HOME}/.rustup/toolchains/stable-x86_64-unknown-linux-gnu/share/doc/rust/html/" 9005
Or, you could spin up an NGINX server block, if you're so inclined.
Here's mine running in #Firefox :firefox: on #KUbuntu :kubuntu: (#ubuntu :ubuntu: )
[Перевод] Rust 1.85.0 и Rust 2024
Команда Rust рада сообщить о новой версии языка — 1.85.0, а также о стабилизации 2024-й редакции. Rust — это язык программирования, позволяющий каждому создавать надёжное и эффективное программное обеспечение. Если у вас есть предыдущая версия Rust, установленная через rustup , то для обновления до версии 1.85.0 вам достаточно выполнить команду: $ rustup update stable Если у вас ещё не установлен rustup , вы можете установить его с соответствующей страницы нашего веб-сайта, а также посмотреть подробные примечания к выпуску на GitHub. Если вы хотите помочь нам протестировать будущие выпуски, вы можете использовать канал beta ( rustup default beta ) или nightly ( rustup default nightly ). Пожалуйста, сообщайте обо всех встреченных вами ошибках.
https://habr.com/ru/articles/884770/
#clippy #cargo #rustc #rustdoc #rustfmt #rustfix #release #stable #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод
[Перевод] Rust 1.84.0: MSRV при выборе зависимости, новый резолвер трейтов и API для отслеживания происхождения указателей
Команда Rust рада сообщить о новой версии языка — 1.84.0. Rust — это язык программирования, позволяющий каждому создавать надёжное и эффективное программное обеспечение. Если у вас есть предыдущая версия Rust, установленная через rustup , то для обновления до версии 1.84.0 вам достаточно выполнить команду: $ rustup update stable Если у вас ещё не установлен rustup , вы можете установить его с соответствующей страницы нашего веб-сайта, а также посмотреть подробные примечания к выпуску на GitHub. Если вы хотите помочь нам протестировать будущие выпуски, вы можете использовать канал beta ( rustup default beta ) или nightly ( rustup default nightly ). Пожалуйста, сообщайте обо всех встреченных вами ошибках.
https://habr.com/ru/articles/872854/
#clippy #cargo #rustc #rustdoc #rustfmt #rustfix #release #stable #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод
[Перевод] Rust 1.83.0: новые возможности констант
Команда Rust рада сообщить о новой версии языка — 1.83.0. Rust — это язык программирования, позволяющий каждому создавать надёжное и эффективное программное обеспечение. Если у вас есть предыдущая версия Rust, установленная через rustup , то для обновления до версии 1.83.0 вам достаточно выполнить команду: $ rustup update stable Если у вас ещё не установлен rustup , вы можете установить его с соответствующей страницы нашего веб-сайта, а также посмотреть подробные примечания к выпуску на GitHub. Если вы хотите помочь нам протестировать будущие выпуски, вы можете использовать канал beta ( rustup default beta ) или nightly ( rustup default nightly ). Пожалуйста, сообщайте обо всех встреченных вами ошибках.
https://habr.com/ru/articles/862868/
#clippy #cargo #rustc #rustdoc #rustfmt #rustfix #release #stable #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод
[Перевод] Rust 1.82.0: cargo info, AArch64 для macOS в tier1, use<..>, небезопасные указатели и другое
Команда Rust рада сообщить о новой версии языка — 1.82.0. Rust — это язык программирования, позволяющий каждому создавать надёжное и эффективное программное обеспечение. Если у вас есть предыдущая версия Rust, установленная через rustup , то для обновления до версии 1.82.0 вам достаточно выполнить команду: $ rustup update stable Если у вас ещё не установлен rustup , вы можете установить его с соответствующей страницы нашего веб-сайта, а также посмотреть подробные примечания к выпуску на GitHub. Если вы хотите помочь нам протестировать будущие выпуски, вы можете использовать канал beta ( rustup default beta ) или nightly ( rustup default nightly ). Пожалуйста, сообщайте обо всех встреченных вами ошибках.
https://habr.com/ru/articles/851800/
#clippy #cargo #rustc #rustdoc #rustfmt #rustfix #release #stable #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод
Did you know that you can add doc aliases to your #Rust items (struct, method etc.), so that they appear in #RustDoc search results, when searching for that alias?🔍
You can even add multiple aliases at once, like this:
#[doc(alias("modify", "index"))]
pub fn modified_field_indices(...);
Such a useful feature (that should be used more often)!
⚠️ Note that it will only show in results, when searching for the full alias!
[Перевод] Rust 1.81.0: Error, новая реализация сортировки, #[expect(lint)]
Команда Rust рада сообщить о новой версии языка — 1.81.0. Rust — это язык программирования, позволяющий каждому создавать надёжное и эффективное программное обеспечение. Если у вас есть предыдущая версия Rust, установленная через rustup , то для обновления до версии 1.81.0 вам достаточно выполнить команду: $ rustup update stable Если у вас ещё не установлен rustup , вы можете установить его с соответствующей страницы нашего веб-сайта, а также посмотреть подробные примечания к выпуску на GitHub. Если вы хотите помочь нам протестировать будущие выпуски, вы можете использовать канал beta ( rustup default beta ) или nightly ( rustup default nightly ). Пожалуйста, сообщайте обо всех встреченных вами ошибках.
https://habr.com/ru/articles/841366/
#clippy #cargo #rustc #rustdoc #rustfmt #rustfix #release #stable #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод
If serde uses a private rustdoc feature, does that mean it is fair game? Asking for myself 🙈
https://docs.rs/serde/latest/src/serde/ser/impls.rs.html#416
[Перевод] Rust 1.80.0: типы LazyCell, LazyLock, проверяемые имена и значения cfg, эксклюзивные диапазоны в шаблонах
Команда Rust рада сообщить о новой версии языка — 1.80.0. Rust — это язык программирования, позволяющий каждому создавать надёжное и эффективное программное обеспечение. Если у вас есть предыдущая версия Rust, установленная через rustup , то для обновления до версии 1.80.0 вам достаточно выполнить команду: $ rustup update stable Если у вас ещё не установлен rustup , вы можете установить его с соответствующей страницы нашего веб-сайта, а также посмотреть подробные примечания к выпуску на GitHub. Если вы хотите помочь нам протестировать будущие выпуски, вы можете использовать канал beta ( rustup default beta ) или nightly ( rustup default nightly ). Пожалуйста, сообщайте обо всех встреченных вами ошибках.
https://habr.com/ru/articles/831894/
#clippy #cargo #rustc #rustdoc #rustfmt #rustfix #release #stable #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод
The new unsafe extern feature was implemented in rustdoc as well!
[Перевод] Rust 1.79.0: встроенные const, ограничения в ассоциированном типе, продление автоматического времени жизни
Команда Rust рада сообщить о новой версии языка — 1.79.0. Rust — это язык программирования, позволяющий каждому создавать надёжное и эффективное программное обеспечение. Если у вас есть предыдущая версия Rust, установленная через rustup , то для обновления до версии 1.79.0 вам достаточно выполнить команду: $ rustup update stable Если у вас ещё не установлен rustup , вы можете установить его с соответствующей страницы нашего веб-сайта, а также посмотреть подробные примечания к выпуску на GitHub. Если вы хотите помочь нам протестировать будущие выпуски, вы можете использовать канал beta ( rustup default beta ) или nightly ( rustup default nightly ). Пожалуйста, сообщайте обо всех встреченных вами ошибках.
https://habr.com/ru/articles/822565/
#clippy #cargo #rustc #rustdoc #rustfmt #rustfix #release #stable #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод
