Come far funzionare `man` per comandi e parole chiave integrati nella shell?

Uso sempre il mancomando quando voglio ottenere informazioni su un comando specifico. Ma questo non mi aiuta molto quando quel comando specifico è incorporato nella shell. Per esempio:

man cd

ritorna:

No manual entry for cd

La mia domanda è: è possibile fare mananche funzionare per tutti builtin di shell comandi (come cd, alias, history, etc.), e le parole chiave (come if, while, [[, {, etc.)?

Il helpcomando quando utilizzato con l' -mopzione può visualizzare informazioni sui comandi integrati in formato pseudo-manpage. Per esempio:

help -m cd | less

visualizzerà le informazioni sul cdcomando in un formato quasi esattamente come in una pagina di manuale.

A partire da questo comando è possibile racchiudere il mancomando in una funzione nel .bashrcfile come segue:

man () {
    case "$(type -t -- "$1")" in
    builtin|keyword)
        help -m "$1" | sensible-pager
        ;;
    *)
        command man "$@"
        ;;
    esac
}

Dopodiché manfunzionerà anche con tutti i comandi e le parole chiave incorporati nella shell. Per esempio:

man :

visualizzerà:

NAME
    : - Null command.

SYNOPSIS
    :

DESCRIPTION
    Null command.

    No effect; the command does nothing.

    Exit Status:
    Always succeeds.

SEE ALSO
    bash(1)

IMPLEMENTATION
    GNU bash, version 4.2.45(1)-release (x86_64-pc-linux-gnu)
    Copyright (C) 2011 Free Software Foundation, Inc.
    License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>

man bash-builtins

Questo contiene frammenti di aiuto per i comandi integrati, sebbene in un formato leggermente più condensato rispetto helpall'equivalente.

È possibile installare pagine di manuale sull'uso di un sistema POSIX per lo sviluppo come,

sudo apt-get install manpages-posix-dev

Fornirà pagine man per i builtin della shell.

$ type cd
cd is a shell builtin

Adesso prova,

$ man cd
CD(P)                      POSIX Programmer's Manual                      CD(P)

NAME
   cd - change the working directory

SYNOPSIS
   cd [-L | -P] [directory]


...

Questa soluzione funziona perfettamente, ma è anche un po 'uno scherzo perché la prima cosa che ho pensato quando ho letto la tua domanda è stata: "Chi usa ancora letteralmente l'uomo dalla riga di comando? Google non è solo la pagina man che desidera (in modo da ottenere cose fantasiose come lo scorrimento illimitato)? '. Poi mi sono reso conto che i siti che Google di solito hanno tutti e due i tipi di comandi, quindi perché non utilizzarli solo per fornire un'interfaccia man page uniforme su tutti i comandi. Quindi, questo divertimento è nato.

Ciò richiede una connessione Internet per tutte le voci che non hai già cercato almeno una volta. Ha anche bisogno di queste due piccole app che mancano in un'installazione predefinita di Ubuntu:

 sudo apt-get install tidy html2text

Questi non sono assolutamente necessari, ma aiutano a renderlo un po 'più bello. Tidy pulirà l'HTML e html2text formatterà quell'html come testo formattato (che di solito è piuttosto banale poiché la maggior parte di questi siti sono già formattati in testo e racchiusi in tag <pre>.

Ora tutto ciò che devi fare è aggiungere questo alla fine di ~/.profile:

function iman() {
    if [ ! -d "/usr/share/iman" ]; then
        sudo mkdir -m a=rwx /usr/share/iman
    fi
    if [ ! -f "/usr/share/iman/$1.html" ]; then
        curl "http://unixhelp.ed.ac.uk/CGI/man-cgi?$1"| tidy -n -asxml 2>/dev/null| html2text > "/usr/share/iman/$1.html"; 
    fi
    if [ -f "/usr/share/iman/$1.html" ]; then
        cat "/usr/share/iman/$1.html";
    else
        echo "Entry not found."
    fi
}

Dopo aver effettuato il logout e poi di nuovo l'accesso, dovresti essere in grado di digitare questo:

iman cd

e mostrerà la pagina man per cd.

Questo utilizza una directory di dati (/ usr / share / iman) al fine di ridurre al minimo i nostri requisiti di rete (quindi funzionerà per le voci che hai già trovato prima anche senza la connessione; anche per minimizzare il carico su questo sito di pagine man linux casuali Ho trovato anche con le voci di sistema che vogliamo). Se non lo usi più, ti consigliamo di rimuoverlo per recuperare spazio su disco.

Spero che il resto sia piuttosto semplice.