Як змусити людину працювати над командами та ключовими словами вбудованими оболонками?

Я використовую manкоманду весь час, коли хочу отримати інформацію про певну команду. Але це не дуже допомагає мені, коли ця конкретна команда є вбудованою оболонкою. Наприклад:

man cd

повертає:

No manual entry for cd

Моє питання: це можна зробити manтакож працювати для всіх оболонок вбудованих команд (як cd, alias, historyі т.д.) і ключові слова (як if, while, [[, {і т.д.)?

helpКоманда , коли використовується з -mопцією може відображати інформацію про вбудовані командах в форматі псевдо-сторінці керівництва. Наприклад:

help -m cd | less

відобразить інформацію про cdкоманду у форматі майже точно так само, як на сторінці вручну.

Починаючи з цієї команди, ви можете перетворити manкоманду на одну функцію у вашому .bashrcфайлі наступним чином:

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

Після цього manбуде працювати також для всіх вбудованих оболонок команд та ключових слів. Наприклад:

man :

відобразиться:

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

Він містить фрагменти довідки для вбудованих команд, хоча і у трохи більш ущільненому форматі, ніж helpеквівалент.

Ви можете встановити сторінки вручну щодо використання системи POSIX для розробки як,

sudo apt-get install manpages-posix-dev

Він надасть довідкові сторінки для вбудованих оболонок.

$ type cd
cd is a shell builtin

Тепер спробуйте,

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

NAME
   cd - change the working directory

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


...

Це рішення працює чудово, але це трохи жарт, тому що перше, що я подумав, читаючи ваше запитання, було: «Хто все ще буквально використовує людину з командного рядка? Чи не всі просто Google шукають потрібну сторінку (щоб вони отримували фантазії, такі як необмежена прокрутка)? '. Тоді я зрозумів, що сайти, на яких я Google, зазвичай, мають обидва типи команд, то чому б просто не використовувати їх для надання єдиного інтерфейсу на всій команді. Отже, ця забава народилася.

Для цього потрібне підключення до Інтернету для будь-яких записів, які ви хоч раз не шукали. Також йому потрібні ці дві невеликі програми, яких немає в установці Ubuntu за замовчуванням:

 sudo apt-get install tidy html2text

Вони абсолютно не потрібні, але вони допомагають зробити це виглядати трохи приємніше. Tidy очистить HTML, а html2text буде форматувати цей HTML у форматованому тексті (що, як правило, досить тривіально, оскільки більшість із цих сайтів вже форматовані у тексті та просто загорнуті у теги <pre>.

Тепер все, що вам потрібно зробити, це додати це до кінця ~/.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
}

Після виходу з системи, а потім повернення в систему, ви повинні мати можливість ввести це:

iman cd

і на ній відобразиться довідкова сторінка cd.

Для цього використовується каталог даних (/ usr / share / iman), щоб мінімізувати наші мережеві вимоги (тому він буде працювати для записів, які ви вже знаходили раніше навіть без з'єднання; а також мінімізувати завантаження на цьому випадковому веб-сайті linux man man Я знайшов і записи системи, які ми хочемо в ньому). Якщо ви цим більше не користуєтесь, вам захочеться видалити це місце, щоб відновити місце на диску.

Сподіваємось, решта досить прямо вперед.