Como edito uma página de manual?

4

Eu quero saber se uma página de manual pode ser editada. Se sim como? (Se possível, alterando no gedit).

P.S.- Eu quero saber se uma manpage já escrita pode ser editada (apenas por diversão).

    
por bha159 18.06.2016 / 19:39

3 respostas

5

Instale gmanedit .

  

O Gtk + Manpages Editor é um editor para páginas man executadas no X com o GTK +.

     

Gmanedit é uma aplicação que permite editar páginas de manual (man) em sistemas Linux / Unix.

     

É como os editores de HTML mais comuns, mas é mais fácil. Você precisa saber o formato das páginas de manual.

    
por Rinzwind 18.06.2016 / 19:47
4

Sim, você pode, mas não é recomendado. A melhor abordagem provavelmente seria algo como a ferramenta sugerida por Rinzwind, mas, sim, você também pode fazer isso manualmente. Usarei a página man para grep como exemplo.

  1. As páginas man são arquivos compactados, portanto, você precisa usar um editor real, como emacs , que pode ler / gravar arquivos compactados ou primeiro descompactá-lo:

    sudo gunzip /usr/share/man/man1/grep.1.gz
    
  2. Edite-o:

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

    Agora, o formato é um pouco estranho . No entanto, se você quiser apenas alterar coisas simples, poderá ignorar a formatação e alterar somente o texto sem formatação. Por exemplo, posso alterar facilmente a descrição de grep . Isto é o que as primeiras linhas parecem quando você abre o arquivo em gedit (ou qualquer outro editor):

    .\" 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
    \ \(laemail: \ \(ra\
    ..
    . de URL
    \ \(laURL: \ \(ra\
    ..
    .\}
    .
    .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
    

    Então, para mudar a descrição, eu posso mudar isso para (rolar para baixo até a seção "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
    \ \(laemail: \ \(ra\
    ..
    . de URL
    \ \(laURL: \ \(ra\
    ..
    .\}
    .
    .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. Salve o arquivo, saia do gedit e recompacte-o (isso não é realmente necessário, man grep já funciona, mas é melhor ser arrumado):

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

Agora, basta executar man grep e você verá:

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.
    
por terdon 18.06.2016 / 20:13
2

Como já foi discutido, não é recomendado fazê-lo - o outro post explica também que é possível mesmo assim.

Eu gostaria de mencionar algumas alternativas - projetos de software que oferecem algum tipo de cheat-sheets editáveis pelo usuário

A maioria deles vem com uma boa predefinição de folhas de fraude, que você aprimora sob demanda.

    
por dufte 18.06.2016 / 21:52