Как man.cgi работает с справочными страницами cat и mdoc?

В MirBSD мы предоставляем все онлайн-справочные страницы в виде статического HTML (фактический веб-CGI, таким образом, очень мал). ) и используйте хитрый скрипт для преобразования вывода nroff -Tcol foo.1 | col -x в XHTML. /1.1 — хотя, чтобы это работало, нам пришлось немного подправить nroff(1) и макропакеты mdoc и man (а также ms и me и т. д.). Однако мы отправляем все man-страницы только из базы, а также историческую документацию BSD.

Кроме того, в GNU gnroff нет -Tcol, но -Tascii будет работать, но если вы хотите использовать это с выводом gnroff, вам может потребоваться соответствующим образом изменить регулярные выражения.

Будьте особенно осторожны при редактировании этого файла: он содержит обычные элементы UTF-8, а также дополнительные управляющие символы и недопустимые последовательности байтов; если вы не будете осторожны, ваш редактор испортит его. (Я сам использую jupp.)

Для получения более подробной обратной связи по этому поводу, не стесняйтесь посетить IRC-канал MirBSD.

Что касается вашей первоначальной цели: я предлагаю собирать man-страницы только из бинарных пакетов, потому что они часто изменяются во время компиляции, например, с помощью AC_SUBST в autoconf, или даже генерируются только как часть сборки пакета.