From 7d11856584768c1fb0bf941cd754898ef7d73909 Mon Sep 17 00:00:00 2001 From: Sergey Matveev Date: Sat, 30 Aug 2025 10:03:39 +0300 Subject: [PATCH] =?utf8?q?=D0=92=20zsh=20=D0=BE=D0=B1=D1=81=D1=83=D0=B6?= =?utf8?q?=D0=B4=D0=B0=D1=8E=D1=82=20=D1=81=D0=BC=D0=B5=D0=BD=D1=83=20?= =?utf8?q?=D1=84=D0=BE=D1=80=D0=BC=D0=B0=D1=82=D0=B0=20=D0=B4=D0=BE=D0=BA?= =?utf8?q?=D1=83=D0=BC=D0=B5=D0=BD=D1=82=D0=B0=D1=86=D0=B8=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit Хотя бы не сраный Markdown предлагают. Всё обсуждение сводится либо к reStructured Text, либо AsciiDoc. А также к тому, что люди критикуют тот же info, банально просто в нём не разобравшись. Полностью солидарен с одним из писем: IMO, and especially with zsh's manual where it's of exceptional quality, "info" is orders of magnitude better than man or HTML (and I don't even use half its features). The killer feature is definitely the index (i), with completion and searchable (I) and available on command line (like in "info zsh typeset"; and with (perfectible as discussed not so long ago here) completion in zsh). The day I discovered that, there was no turning back. Compared to HTML: - can be used from a terminal (like zsh, a terminal application, more than anything else). - quicker to bring up: info zsh; even info zsh for completion on nodes vs x-www-browser /usr/share/doc/zsh-doc/html/index.html - can be searched as a whole (/) or current tree (ESC /) and s, ^S... alternatives for those used to emacs. - regexp support in search - index jump one key away (i, next with ,) - index with completion - index search one key away (I) - node navigation (prev, next, up...) with single keys - node search with completion - easier hyperlink navigation than in most browsers - no need for a mouse Учитывая сложности в установке зависимостей для Python, reST так себе вариант. С ним я провёл бОльшую часть жизни и не хотел бы возвращаться к нему. Впрочем для многих мест я и Texinfo перестал использовать в пользу своего SWG, который тоже умеет генерировать info. Вообще заметил что опытные разработчики никогда не выбирают Markdown, приводя, как минимум, один и тот же аргумент о том, что нет такого формата (о котором бы все договорились) и он отнюдь не прост для парсинга. -- 2.51.0