İnsan 'kabuk yerleşik komutları ve anahtar sözcükleri için nasıl çalışır?

Kullandığım manBelirli bir komutla ilgili bilgi almak istediğinizde komutunu her zaman. Ancak bu özel komut bir kabuk yerleşik komutu olduğunda bu bana çok yardımcı olmuyor. Örneğin:

man cd

döner:

No manual entry for cd

Bunu yapmak mümkündür: Benim sorum mantüm kabuk Yerleşik komutlar (benzerleri için de çalışmak cd, alias, historyvb) ve anahtar kelimeler (gibi if, while, [[, {, vb)?

Seçenekle helpbirlikte kullanıldığında verilen komut, -myerleşik komutlarla ilgili bilgileri sözde manpage biçiminde görüntüleyebilir. Örneğin:

help -m cd | less

cdKomut hakkındaki bilgileri neredeyse tamamen manuel sayfadaki gibi bir biçimde görüntüler .

Bu komuttan başlayarak komutu man, .bashrcdosyanızdaki tek bir fonksiyona aşağıdaki gibi sarabilirsiniz :

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

Bundan sonra manda tüm kabuk yerleşik komutları ve anahtar sözcükleri için çalışacaktır. Örneğin:

man :

gösterecek:

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

Bu, yerleşik komutlar için, helpeşdeğerinden biraz daha yoğun bir biçimde olsa da, yardım snippet'lerini içerir .

Bir POSIX sistemini kullanma hakkında el ile sayfalar oluşturabilir ,

sudo apt-get install manpages-posix-dev

Kabuk yerleşimleri için man sayfaları sağlayacaktır.

$ type cd
cd is a shell builtin

Şimdi dene,

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

NAME
   cd - change the working directory

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


...

Bu çözüm mükemmel bir şekilde çalışıyor ama biraz şaka gibi çünkü sorunuzu okuduğumda ilk düşündüğüm şey, 'Gerçekten de insanı komut satırından kim kullanıyor? Herkes yalnızca istediği adam sayfasını Google (yalnızca sınırsız kaydırma gibi süslü şeyler elde etmek için almıyor) değil mi? '. Sonra, Google’ın tüm sitelerinin genellikle iki tür komutun da olduğunu fark ettim, bu yüzden neden onları tüm komutlar boyunca tek biçimli bir adam sayfası arayüzü sağlamak için kullanmıyorsunuz? Dolayısıyla, bu eğlence doğdu.

Bu, daha önce hiç aramadığınız tüm girişler için İnternet bağlantısı gerektirir. Ayrıca Ubuntu'nun varsayılan kurulumunda eksik olan bu iki küçük uygulamaya da ihtiyacı var:

 sudo apt-get install tidy html2text

Bunlara kesinlikle ihtiyaç duyulmuyor, ancak biraz daha hoş görünmesine yardımcı oluyorlar. Tidy HTML'yi temizler ve html2text bu html'yi biçimlendirilmiş metin olarak biçimlendirir (bu sitelerin çoğu zaten metin biçiminde olduğundan ve sadece <pre> etiketleriyle sarıldığından genellikle oldukça önemsizdir).

Şimdi yapmanız gereken sonuna bu ekleyin ~/.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
}

Oturumu kapatıp tekrar girdikten sonra şunu yazmanız gerekir:

iman cd

ve için man sayfasını görüntüler cd.

Bu, ağ gereksinimlerimizi en aza indirgemek için bir veri dizini (/ usr / share / iman) kullanır (bu yüzden daha önce bağlantı olmadan bile daha önce bulduğunuz girişler için çalışacaktır; İstediğimiz sistem girişlerinde de buldum). Bunu artık kullanmazsanız, disk alanını kurtarmak için onu kaldırmak isteyeceksiniz.

Umarım, geri kalanı oldukça yalındır.