Às vezes você está desanimado, quer 'man up' - como posso adicionar esta entrada manual no unix?

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

Como posso remediar esta situação?

Quero adicionar uma entrada manual 'inventada' para um comando inexistente uppara que eu possa digitar man upquando necessário. Sugestões de coisas a serem incluídas são adições bem-vindas às instruções de adição manual.

Além disso, no caso de minha estação de trabalho ter usuários do sexo feminino, terei a certeza de ln:

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 deva provavelmente mudar isso para Which womanual page do you want?- isso envolveria uma recompilação ou há um patch?

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

HowTo: Linux / UNIX Criar uma página de manual

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

Geralmente está 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 ./upo mesmo diretório

As páginas de /usr/local/man/man8/manual geralmente estão abaixo e compactadas com gzip

Você pode copiar a sua página de manual e, em cp up /usr/local/man/man8/up.1seguida, compactá-la comgzip /usr/local/man/man8/name.1

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

Embora eu deva provavelmente mudar isso para Which womanual page do you want?- isso envolveria uma recompilação ou há um patch?

A recompilação produz os melhores resultados, mas isso deve ocorrer 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\1/g' \
            -e 's/\(M[AE]N\)/WO\1/g' \
            -e 's/M\([ae]n\)/Wom\1/g' \
            -e 's/    //' \
            -e 's/\([^ ]\)  /\1 /g' \
        | less
else
    man $ARG 2>&1 | sed -e 's/\(m[ae]n\)/wo\1/'
fi

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

woman
woman down
woman woman