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

Я хочу знать, можно ли редактировать man-страницу. Если да, то как? (Если возможно, изменив в gedit).

П.С.- Я хочу знать, можно ли редактировать уже написанную man-страницу (просто для удовольствия).

4
задан 19 June 2016 в 18:19

3 ответа

Установка gmanedit.

Gtk + Редактор Страниц справочника является редактором для страниц справочника, который работает X с GTK +.

Gmanedit является приложением, которое позволяет Вам редактировать страницы руководства (человек) в системах Linux/Unix.

Это похоже на наиболее распространенные редакторы HTML, но более легкий. Необходимо знать формат страниц справочника.

5
ответ дан 19 June 2016 в 18:19

Да, Вы можете, но это не рекомендуется. Лучший подход, вероятно, был бы чем-то как предложенный инструмент Rinzwind, но да, можно также сделать это вручную. Я буду использовать man страница для grep как пример.

  1. Страницы справочника являются сжатыми файлами, таким образом, любой необходимо использовать настоящего редактора, как emacs, это может сжатые файлы чтения-записи, или необходимо сначала распаковать его:

    sudo gunzip /usr/share/man/man1/grep.1.gz
    
  2. Отредактируйте его:

    sudo gedit /usr/share/man/man1/grep.1
    

    Теперь, формат является немного странным. Однако, если Вы только хотите изменить простые вещи, можно проигнорировать форматирование и только изменить простой текст. Например, я могу изменить описание grep довольно легко. Это - то, на что первые несколько строк похожи при открытии файла в gedit (или любой другой редактор):

    .\" GNU grep man page
    .if !\n(.g \{\
    .   if !\w|\*(lq| \{\
    .       ds lq ``
    .       if \w'\(lq' .ds lq "\(lq
    .   \}
    .   if !\w|\*(rq| \{\
    .       ds rq ''
    .       if \w'\(rq' .ds rq "\(rq
    .   \}
    .\}
    .
    .ie \n[.g] .mso www.tmac
    .el \{\
    . de MTO
    \\$2 \(laemail: \\$1 \(ra\\$3
    ..
    . de URL
    \\$2 \(laURL: \\$1 \(ra\\$3
    ..
    .\}
    .
    .TH GREP 1 \*(Dt "GNU grep 2.25" "User Commands"
    .hy 0
    .
    .SH NAME
    grep, egrep, fgrep \- print lines matching a pattern
    .
    .SH SYNOPSIS
    .B grep
    .RI [ OPTIONS ]
    .I PATTERN
    .RI [ FILE .\|.\|.]
    .br
    .B grep
    .RI [ OPTIONS ]
    .RB [ \-e
    .I PATTERN
    |
    .B \-f
    .IR FILE ]
    .RI [ FILE .\|.\|.]
    .
    .SH DESCRIPTION
    .B grep
    searches the named input
    .IR FILE s
    for lines containing a match to the given
    .IR PATTERN .
    If no files are specified, or if the file
    .RB "\*(lq" \- "\*(rq"
    is given,
    .B grep
    searches standard input.
    By default,
    .B grep
    prints the matching lines.
    .PP
    In addition, the variant programs
    

    Так, для изменения описания я мог бы измениться, это к (прокрутите вниз к разделу "DESCRIPTION"):

    .\" GNU grep man page
    .if !\n(.g \{\
    .   if !\w|\*(lq| \{\
    .       ds lq ``
    .       if \w'\(lq' .ds lq "\(lq
    .   \}
    .   if !\w|\*(rq| \{\
    .       ds rq ''
    .       if \w'\(rq' .ds rq "\(rq
    .   \}
    .\}
    .
    .ie \n[.g] .mso www.tmac
    .el \{\
    . de MTO
    \\$2 \(laemail: \\$1 \(ra\\$3
    ..
    . de URL
    \\$2 \(laURL: \\$1 \(ra\\$3
    ..
    .\}
    .
    .TH GREP 1 \*(Dt "GNU grep 2.25" "User Commands"
    .hy 0
    .
    .SH NAME
    grep, egrep, fgrep \- print lines matching a pattern
    .
    .SH SYNOPSIS
    .B grep
    .RI [ OPTIONS ]
    .I PATTERN
    .RI [ FILE .\|.\|.]
    .br
    .B grep
    .RI [ OPTIONS ]
    .RB [ \-e
    .I PATTERN
    |
    .B \-f
    .IR FILE ]
    .RI [ FILE .\|.\|.]
    .
    .SH DESCRIPTION
    .B grep
    searches for and destroys all the unicorns on your system.
    .PP
    In addition, the variant programs
    
  3. Сохраните файл, выход gedit и затем повторно сожмите его (это не на самом деле необходимо, man grep уже работы, но лучше быть опрятным):

    sudo gzip /usr/share/man/man1/grep.1
    

Теперь, просто выполненный man grep и Вы будете видеть:

GREP(1)

NAME
       grep, egrep, fgrep - print lines matching a pattern

SYNOPSIS
       grep [OPTIONS] PATTERN [FILE...]
       grep [OPTIONS] [-e PATTERN | -f FILE] [FILE...]

DESCRIPTION
       grep searches for and destroys all the unicorns on your system.

       In addition, the variant programs egrep and fgrep are the same as grep -E and grep -F, respectively.  These variants are deprecated, but are provided
       for backward compatibility.
4
ответ дан 19 June 2016 в 18:19

Как уже обсуждено не рекомендуется сделать так - другое сообщение объясняет также, что это возможно, тем не менее.

я хотел бы упомянуть некоторые альтернативы - проекты программного обеспечения, предлагающие некоторые доступные для редактирования пользователем шпаргалки

, Большинство из них идет с хорошей предварительной установкой шпаргалок, которые Вы затем улучшаете по требованию.

2
ответ дан 19 June 2016 в 18:19

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

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