rustdoc научился понимать формулы в долларовых обёртках

Принято предложение добавить в генератор документации поддержку математических формул: текст между двумя символами доллара будет отображаться как формула.

Какая проблема

Стандартной библиотеке Rust приходится документировать алгоритмы шифрования, векторные типы и вычислительную геометрию — то есть вещи, которые без формул не описать. Сейчас в комментарии пишут простые формулы текстом или вставляют картинками.

Картинками плохо: их не найти поиском по тексту, они не читаются с экрана голосовым программам, их нужно хранить и обновлять отдельно.

Что даёт

Формула становится обычным текстом внутри комментария, который индексируется, копируется и читается с экрана. Это важно для справочных материалов.

Предлагаемый синтаксис совпадает с принятым в научной публикации: одиночный доллар — внутри строки, двойной — отдельным блоком.

Что пока впереди

Предложение принято, поддержка пока не в стабильных сборках.

Оригинал

RFC 3958 «Rustdoc LaTeX math», принят 6 сентября 2026 года