Às vezes você está se sentindo pra baixo, você quer 'man up' - como eu posso adicionar esta entrada manual no unix?

Question

Cris-Mac-Book-2:src cris$ man up
No manual entry for up

Como posso remediar esta situação?

Eu quero adicionar uma entrada manual 'inventada' para um comando inexistente up , para que eu possa digitar man up quando necessário. Sugestões de coisas para incluir são adições bem-vindas às instruções de adição manuais.

Além disso, caso minha estação de trabalho receba usuários do sexo feminino, assegurarei que ln woman:

Cris-Mac-Book-2:src cris$ sudo link /usr/bin/man /usr/bin/woman
Cris-Mac-Book-2:src cris$ woman
What manual page do you want?
Cris-Mac-Book-2:src cris$ 

Embora eu provavelmente deva mudar isso para Which womanual page do you want? - isso envolveria re-compilar ou há algum patch?

    

Answer 1

Aqui parecem boas instruções para adicionar uma nova página de manual:

HowTo: Linux / UNIX Crie uma Manpage

Em suma, uma página de manual é simplesmente um arquivo de texto, com informações adicionais de formatação para o troff

Geralmente é no formato

.\" Manpage for up.
.\" Contact [email protected] to correct errors or typos.
.TH man 8 "06 May 2010" "1.0" "name man page"
.SH NAME
up \- into a higher position or level
.SH SYNOPSIS
up [anything you like]
.SH DESCRIPTION
up is a pretty good place to be
.SH OPTIONS
up does not take any options, though you can choose the speed of your acent 
.SH SEE ALSO
yes(1), time cat (2) cal 3() 
.SH BUGS
No known bugs. Gravity is not a bug, "Its a feature"
.SH AUTHOR
Chris Stringfellow ([email protected])

Salvar como up

Você pode visualizar a página de manual com man ./up do mesmo diretório

As páginas do manual geralmente estão em /usr/local/man/man8/ e gzipped

Você pode copiar sua página de manual com cp up /usr/local/man/man8/up.1 e depois gzip com gzip /usr/local/man/man8/name.1

Você pode testá-lo com man up - o que deve resultar em algo como isto

    

Answer 2

Though I should probably change that to Which womanual page do you want? -- would that involve re-compile or is there a patch?

Recompilar produz os melhores resultados, mas isso deve acontecer enquanto isso:

#!/bin/bash

ARG=${1/woman/man}

man $ARG > /dev/null 2>&1

if [ $? -eq 0 ]; then
    man $ARG 2> /dev/null \
        | sed \
            -e 's/\(m[ae]n\)/wo/g' \
            -e 's/\(M[AE]N\)/WO/g' \
            -e 's/M\([ae]n\)/Wom/g' \
            -e 's/    //' \
            -e 's/\([^ ]\)  / /g' \
        | less
else
    man $ARG 2>&1 | sed -e 's/\(m[ae]n\)/wo/'
fi

Salvar como /usr/sbin/woman , definir permissões de execução e iniciar o teste:

woman
woman down
woman woman