#rustdoc — Public Fediverse posts

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

#rustdoc #rustlang #rust

@hcsch @CyReVolt I'd add `Self::method` is a type address, while `self.method()` is a instance address.

#Rustdoc documents types, not instances.

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.

Fixed in https://github.com/rust-lang/rust/pull/143590.

#rust #rustdoc

[Перевод] 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.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.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.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 #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод

[Перевод] 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 #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод

[Перевод] 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 #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод

[Перевод] 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 #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод

[Перевод] 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 #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод

[Перевод] 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 #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод

[Перевод] 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 #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод

[Перевод] 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.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.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.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?🔍

https://doc.rust-lang.org/rustdoc/advanced-features.html#add-aliases-for-an-item-in-documentation-search

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!

#RustLang #Search #RustTip #Documentation #UX

[Перевод] 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 #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод

[Перевод] 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!

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

#rust #rustdoc

[Перевод] 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 #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод

[Перевод] Rust 1.78.0: Диагностические атрибуты, проверка предусловий unsafe и детерминированное повторное выравнивание

Команда Rust рада сообщить о новой версии языка — 1.78.0. Rust — это язык программирования, позволяющий каждому создавать надёжное и эффективное программное обеспечение. Если у вас есть предыдущая версия Rust, установленная через rustup , то для обновления до версии 1.78.0 вам достаточно выполнить команду: $ rustup update stable Если у вас ещё не установлен rustup , вы можете установить его с соответствующей страницы нашего веб-сайта, а также посмотреть подробные примечания к выпуску на GitHub. Если вы хотите помочь нам протестировать будущие выпуски, вы можете использовать канал beta ( rustup default beta ) или nightly ( rustup default nightly ). Пожалуйста, сообщайте обо всех встреченных вами ошибках.

https://habr.com/ru/articles/812199/

#clippy #cargo #rustc #rustdoc #rustfmt #rustfix #release #stable #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод

[Перевод] Rust 1.77.0: C-подобные строки, offset_of!, рекурсивные async fn, strip в release-профилях

Команда Rust рада сообщить о новой версии языка — 1.77.0. Rust — это язык программирования, позволяющий каждому создавать надёжное и эффективное программное обеспечение. Если у вас есть предыдущая версия Rust, установленная через rustup , то для обновления до версии 1.77.0 вам достаточно выполнить команду: $ rustup update stable Если у вас ещё не установлен rustup , вы можете установить его с соответствующей страницы нашего веб-сайта, а также посмотреть подробные примечания к выпуску на GitHub. Если вы хотите помочь нам протестировать будущие выпуски, вы можете использовать канал beta ( rustup default beta ) или nightly ( rustup default nightly ). Пожалуйста, сообщайте обо всех встреченных вами ошибках.

https://habr.com/ru/articles/802725/

#clippy #cargo #rustc #rustdoc #rustfmt #rustfix #release #stable #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод

[Перевод] Rust 1.76.0: обновление совместимости ABI, получение имени типа из ссылки

Команда Rust рада сообщить о новой версии языка — 1.76.0. Rust — это язык программирования, позволяющий каждому создавать надёжное и эффективное программное обеспечение. Если у вас есть предыдущая версия Rust, установленная через rustup , то для обновления до версии 1.76.0 вам достаточно выполнить команду: rustup update stable Если у вас ещё не установлен rustup , вы можете установить его с соответствующей страницы нашего веб-сайта, а также посмотреть подробные примечания к выпуску на GitHub. Если вы хотите помочь нам протестировать будущие выпуски, вы можете использовать канал beta ( rustup default beta ) или nightly ( rustup default nightly ). Пожалуйста, сообщайте обо всех встреченных вами ошибках.

https://habr.com/ru/articles/793076/

#clippy #cargo #rustc #rustdoc #rustfmt #rustfix #release #stable #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод

@imperio Is it possible to have rustdoc add a table of contents based on headings and sub-headings in the crate-level documentation block?

My "Examples" section in lib.rs has become (necessarily, I feel) rather huge, and a table of contents would really help with navigation.

(This is a naive question rather than a feature request.)

#Rust #RustLang #rustdoc

From discussing with @imperio on a #rustdoc issue, I realize that I might be alone in copy-pasting links into #GitHub issues? You can copy a link from any web page and paste it into the GitHub editor. You get a proper #Markdown link in return!

See https://github.com/rust-lang/rust/pull/117662#issuecomment-1902094332 for a screenshot of what I mean.

I found this some years ago and I used it all the time now. It also works in other places such as a #googledoc. There you'll want to reset the formatting `Ctrl+\` afterwards.

Share away 😀

From discussing with @imperio on a #rustdoc issue, I realize that I might be alone in copy-pasting links into #GitHub issues? You can copy a link from any web page and paste it into the GitHub editor. You get a proper #Markdown link in return!

See https://github.com/rust-lang/rust/pull/117662#issuecomment-1902094332 for a screenshot of what I mean.

I found this some years ago and I used it all the time now. It also works in other places such as a #googledoc. There you'll want to reset the formatting `Ctrl+\` afterwards.

Share away 😀

From discussing with @imperio on a #rustdoc issue, I realize that I might be alone in copy-pasting links into #GitHub issues? You can copy a link from any web page and paste it into the GitHub editor. You get a proper #Markdown link in return!

See https://github.com/rust-lang/rust/pull/117662#issuecomment-1902094332 for a screenshot of what I mean.

I found this some years ago and I used it all the time now. It also works in other places such as a #googledoc. There you'll want to reset the formatting `Ctrl+\` afterwards.

Share away 😀

From discussing with @imperio on a #rustdoc issue, I realize that I might be alone in copy-pasting links into #GitHub issues? You can copy a link from any web page and paste it into the GitHub editor. You get a proper #Markdown link in return!

See https://github.com/rust-lang/rust/pull/117662#issuecomment-1902094332 for a screenshot of what I mean.

I found this some years ago and I used it all the time now. It also works in other places such as a #googledoc. There you'll want to reset the formatting `Ctrl+\` afterwards.

Share away 😀

From discussing with @imperio on a #rustdoc issue, I realize that I might be alone in copy-pasting links into #GitHub issues? You can copy a link from any web page and paste it into the GitHub editor. You get a proper #Markdown link in return!

See https://github.com/rust-lang/rust/pull/117662#issuecomment-1902094332 for a screenshot of what I mean.

I found this some years ago and I used it all the time now. It also works in other places such as a #googledoc. There you'll want to reset the formatting `Ctrl+\` afterwards.

Share away 😀

[Перевод] Rust 1.75.0: API адресной арифметики, async fn и impl Trait в трейтах, уcкорение rustc

Команда Rust рада сообщить о новой версии языка — 1.75.0. Rust — это язык программирования, позволяющий каждому создавать надёжное и эффективное программное обеспечение. Если у вас есть предыдущая версия Rust, установленная через rustup , то для обновления до версии 1.75.0 вам достаточно выполнить команду: rustup update stable Если у вас ещё не установлен rustup , вы можете установить его с соответствующей страницы нашего веб-сайта, а также посмотреть подробные примечания к выпуску на GitHub. Если вы хотите помочь нам протестировать будущие выпуски, вы можете использовать канал beta ( rustup default beta ) или nightly ( rustup default nightly ). Пожалуйста, сообщайте обо всех встреченных вами ошибках.

https://habr.com/ru/articles/784126/

#clippy #cargo #rustc #rustdoc #rustfmt #rustfix #release #stable #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод

When teaching #rust, I often see people have a "Wow 🤯!" experience when I show #rustdoc #doctest system: you write small pieces of Rust code in your documentation and they are then executed as part of your test suite.

What people often don't know is that this system is ancient! I first met in #python and there it was introduced in 1999: https://groups.google.com/g/comp.lang.python/c/DfzH5Nrt05E/m/Yyd3s7fPVxwJ. That's 24 years ago!

I don't know if this was the first implementation of this concept?

[Перевод] Rust 1.74.0: конфигурация проверки в Cargo, авторизация для приватных реестров, проекции возвращаемых типов

Команда Rust рада сообщить о новой версии языка — 1.74.0. Rust — это язык программирования, позволяющий каждому создавать надёжное и эффективное программное обеспечение. Если у вас есть предыдущая версия Rust, установленная через rustup , то для обновления до версии 1.74.0 вам достаточно выполнить команду: rustup update stable Если у вас ещё не установлен rustup , вы можете установить его с соответствующей страницы нашего веб-сайта, а также посмотреть подробные примечания к выпуску на GitHub. Если вы хотите помочь нам протестировать будущие выпуски, вы можете использовать beta ( rustup default beta ) или nightly ( rustup default nightly ) канал. Пожалуйста, сообщайте обо всех встреченных вами ошибках.

https://habr.com/ru/articles/775076/

#clippy #cargo #rustc #rustdoc #rustfmt #rustfix #release #stable #языки_программирования #стабильная_версия #выпуск_версий #системное_программирование #новости_технологий #перевод

Rustdoc' JSON format is an alternative output (vs the HTML of the documentation itself). for Rustdoc.

It's currently unstable, but on its way to stabilization

#EuroRust #EuroRust23 #Rustdoc

Let's try this: Dear #lazyweb / #lazyfedi, what is the current go-to if I have to/want to write application #documentation for #endusers?
It is a #rust application, that does contain a lot of #rustdoc already, but that is very specific to the code, like api/developers doc. It is not end user stuff.

So, what to do? Own branch and something in it, that then gets rendered on a Github-or-similar page? A .md file used with #mkdocs? Using #readthedocs and their #sphinx based setup (also their examples are pretty python related). Somehting else?

I would like to stay as near to the code as I can. *Ideally* it would be rustdoc comments, but that can't be, as that is used for the developers doc already. "Just" a file besides, maybe in doc/ sounds better than whole new branch? Also, would be nice if I do NOT have to learn a complete new markup language.

Any #suggestions?