Comments | lionet: Pandoc and Manual Pages

lionet

Pandoc and Manual Pages

Dec 02, 2015 02:42

Итак, надоело мне рисовать мануальные страницы через nroff. Как в asn1c, например:

( Read more... )

Comments 22

max630 December 4 2015, 07:53:54 UTC

А смысле, с nroff _ещё_ больше проблем, чем перечисленные?

Похоже, гитхаб не поддерживает : в начале строки, а больше ничего странного не заметно. Вообще markdown существует как стандарт?

lionet December 4 2015, 09:18:12 UTC

Что значит "ещё" больше? Проблем-то только две осталось:

Таблицы в ман-странице порождают лишнюю пустую строку над собой, если не указывать табличный заголовок (title).

Нельзя надёжно форсировать перенос строки внутри таблицы.

Остальное или пофикшено (мой патч применили уже), или то же самое в nroff (двойные пробелы).

По поводу странного:

не выделяются жирным опции

"Use the **--source-ip** to override this behavior" (звёздочки)

"EXPRESSION % int Remainder" сделалось заголовком

Двоеточия в начале строки

Бэкслеши: "\ MBps\ (for\ bytes\ per\ second)."

"Time ms, s, m, h, d" сделалось заголовком

". Throw 42 requests per second" сделалось заголовком

"On TIME-WAIT state and its reuse:\ " <- бэкслеш.