Как разобрать man-страницы в Windows?

686
sdaffa23fdsf

Вот сырая справочная страница . Есть ли способ, как я могу разобрать его под Windows, чтобы сделать его более читабельным?

0
что-то разобрать roff? sdaffa23fdsf 9 лет назад 0
Сигвин, наверное. Daniel B 9 лет назад 1

2 ответа на вопрос

1
JakeGould

Похоже, этот maniocнабор инструментов будет работать для вас:

Страницы руководства, также называемые справочными страницами, являются хорошо поддерживаемым и популярным способом документирования программного обеспечения в операционных системах Unix, BSD и GNU / Linux. Программа для форматирования текста необходима для обработки внутренних форматов man-страниц в других форматах, подходящих для просмотра. Системы GNU / Linux обычно используют groff, а некоторые системы BSD, например OpenBSD, используют набор программ mandoc в качестве средства форматирования текста. Однако для просмотра справочных страниц в Windows вам все еще нужна программа форматирования. Поэтому мы решили собрать для Windows основные программы пакета mandoc и собрать двоичные файлы для загрузки с кратким объяснением использования и сборки из исходных текстов.

1
embedeo

I am affiliated with the webpage that JakeGould have posted in his answer. I have ported the essence of mandoc suite to Windows (MinGW/MSYS) and I have created that page. My thanks to the authors and contributors of mandoc suite and MinGW/MSYS! So you have 3 options:

  1. Go to my page Viewing man pages in Windows and MinGW/MSYS, read the disclaimer :) please, download the zip-file with pre-built binaries, for example mdocml-1.13.1-win32-embedeo-02.zip, extract locally and then run either of the following commands on Windows command line (cmd.exe) with your man-page as an argument:

    mandoc.exe openvpn.8 | more

    or, my preferred way, convert to an html page:

    mandoc.exe -Thtml -Oman=%N.%S.html openvpn.8 > openvpn.8.html

    Besides, it is a good idea to be aware of mandoc, if you ever come across the idea of writing your own man-pages. In my view, mandoc suite is superior to a roff-only tool set and a better "common denominator" from author's perspective.

  2. However if your man-page is overly "traditional" roff, or if you are not happy with mandoc's formatting, you might want to format/view your man-page with GNU troff (groff). For example, you can get groff pre-built binaries for Windows from ezwinports.

  3. You can search for an online html variant of your man-page. However I would not recommend this option, because there is always risk that the online document might cover different version of the software than the version that you have locally.

Похожие вопросы