Как создать man-страницу?

Question 1

Я думаю, вы пропустили несколько шагов (chmod +x, может быть?). Работает для меня:

$ wget http://www.robots.ox.ac.uk/[...]/compute_descriptors.ln.gz                
[...]
2012-12-12 11:55:36 (1.55 MB/s) - `compute_descriptors.ln.gz' saved [3222607/3222607]                                            

$ gunzip compute_descriptors.ln.gz                                                                             
$ chmod +x compute_descriptors.ln 
$ ./compute_descriptors.ln 
Interest point descriptors implemented by Krystian.Mikolajczyk@inrialpes.fr                                                      
at INRIA Rhone-Alpes.[ref. www.inrialpes.fr/movi/people/Mikolajczyk/Affine]                                                      
Options:
[...]

Question 2

Вы можете написать manpages в docbook / refentry, формате документации XML,

  & lt;? xml version = "1.0" encoding = "ISO-8859-1"? & gt;  & lt;! DOCTYPE refentry PUBLIC "- // OASIS // DTD DocBook XML V4.1.2 // EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">  & lt; refentry id = 'vfplot1' & gt;  & lt; refentryinfo & gt; & lt; date & gt; 1 июля 2008 & lt; / date & gt; & lt; / refentryinfo & gt;  & Lt; refmeta & GT;  & Lt; refentrytitle & GT; VFPLOT & л; / refentrytitle & GT;  & Lt; manvolnum & GT; 1 & л; / manvolnum & GT;  & lt; refmiscinfo class = 'date' & gt; 1 июля 2008 г. & lt; / refmiscinfo & gt;  & Lt; / refmeta & GT;  & lt; refnamediv id = 'name' & gt;  & Lt; refname & GT; vfplot & л; / refname & GT;  & lt; refpurpose & gt; векторные векторные поля с изогнутыми стрелками. & lt; / refpurpose & gt;  & Lt; / refnamediv & GT;  & lt; refsynopsisdiv id = 'синопсис' & gt;  & Lt; cmdsynopsis & GT;  & Lt; & команда GT; vfplot & л; / & команда GT;  & lt; arg choice = 'opt' & gt; -a & lt; сменный & gt; аспект & lt; / replaceable & gt; & lt; / arg & gt;  & lt; arg choice = 'opt' & gt; -d & lt; replaceable & gt; file & lt; / replaceable & gt; & lt; / arg & gt;  & lt; arg choice = 'opt' & gt; -D & lt; сменный & gt; перо & lt; / replaceable & gt; & lt; / arg & gt;  :

, а затем преобразовать результаты в формат человека, используя

  xsltproc /path/to/docbook.xsl vfplot.xml

в html с

  docbook2html docbook2html

и т. д. Это не самый простой способ написать man-страницу, но если вы уже написали XML, то уже знаете синтаксис, это просто вопрос изучения используемых тегов.

Question 3

Question 4

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

http://gtk-apps.org/content/ show.php / Man + Page + Editor +? content = 160219

Это приложение gtk2 с отдельной вкладкой для каждого раздела, в котором импортируются предварительные просмотры и экспорт файлов manpages, нет эзотерических команд форматирования, это все еще находится в разработке, но, безусловно, достаточно стабильно для использования.

jjg · Answer 1 · 13 August 2018 в 15:59

Вы можете написать manpages в docbook / refentry, формате документации XML,

  & lt;? xml version = "1.0" encoding = "ISO-8859-1"? & gt;  & lt;! DOCTYPE refentry PUBLIC "- // OASIS // DTD DocBook XML V4.1.2 // EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">  & lt; refentry id = 'vfplot1' & gt;  & lt; refentryinfo & gt; & lt; date & gt; 1 июля 2008 & lt; / date & gt; & lt; / refentryinfo & gt;  & Lt; refmeta & GT;  & Lt; refentrytitle & GT; VFPLOT & л; / refentrytitle & GT;  & Lt; manvolnum & GT; 1 & л; / manvolnum & GT;  & lt; refmiscinfo class = 'date' & gt; 1 июля 2008 г. & lt; / refmiscinfo & gt;  & Lt; / refmeta & GT;  & lt; refnamediv id = 'name' & gt;  & Lt; refname & GT; vfplot & л; / refname & GT;  & lt; refpurpose & gt; векторные векторные поля с изогнутыми стрелками. & lt; / refpurpose & gt;  & Lt; / refnamediv & GT;  & lt; refsynopsisdiv id = 'синопсис' & gt;  & Lt; cmdsynopsis & GT;  & Lt; & команда GT; vfplot & л; / & команда GT;  & lt; arg choice = 'opt' & gt; -a & lt; сменный & gt; аспект & lt; / replaceable & gt; & lt; / arg & gt;  & lt; arg choice = 'opt' & gt; -d & lt; replaceable & gt; file & lt; / replaceable & gt; & lt; / arg & gt;  & lt; arg choice = 'opt' & gt; -D & lt; сменный & gt; перо & lt; / replaceable & gt; & lt; / arg & gt;  :

, а затем преобразовать результаты в формат человека, используя

  xsltproc /path/to/docbook.xsl vfplot.xml

в html с

  docbook2html docbook2html

и т. д. Это не самый простой способ написать man-страницу, но если вы уже написали XML, то уже знаете синтаксис, это просто вопрос изучения используемых тегов.

Eliah Kagan · Answer 2 · 13 August 2018 в 15:59

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

http://gtk-apps.org/content/ show.php / Man + Page + Editor +? content = 160219

Это приложение gtk2 с отдельной вкладкой для каждого раздела, в котором импортируются предварительные просмотры и экспорт файлов manpages, нет эзотерических команд форматирования, это все еще находится в разработке, но, безусловно, достаточно стабильно для использования.

2

ответ дан Eliah Kagan 13 August 2018 в 15:59

1

Это приложение выглядит интересным. Не могли бы вы представить здесь более подробно, чем просто ссылку? – Kevin Bowen 30 August 2013 в 01:08
2

Это приложение gtk2 с отдельной вкладкой для каждого раздела, в котором импортируются предварительные просмотры и экспорт manpages, все они поддерживаются, нет эзотерических команд форматирования, это все еще находится в разработке, но, безусловно, достаточно стабильно для использования. – Tony Duncun 8 September 2013 в 22:29

Как создать man-страницу?

32 ответа

Другие вопросы по тегам:

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