Uzun adam sayfalarını okumak ve aramak

Hakkında okumak isteyen da nihayet bıkmış bash 'ın readve' s -sile seçeneği man bash. Ben (hat 4500 civarında) sonunda doğru noktaya bulundu, ancak her ikisi beri, her zamanki gibi bir sinir bozucu /readve hatta /\s-s\saramalar yol çok sayıda maçları var.

Öyleyse, soru şudur: Uzun man sayfalarını verimli bir şekilde nasıl okuyabilirim ya da yerel olarak yerel olarak aynı bilgileri nasıl alabilirim ? Spesifik bir örnek olarak, read -s pwdbir kabuk betiğinde gördükten sonra ilgili belgelere nasıl ulaşılır ? İyi bir cevap, kabuk komut dosyası snippet'i olabilir ya da bazı araçlar ve nasıl kullanıldığı hakkında ipucu ya da okumak için doğru noktayı bulmaya yardımcı olduğu sürece tamamen başka bir şey olabilir.

Not: Bash ile etiketlemiyorum, çünkü sorunun genel olarak manyak okuma hakkında olmasına rağmen en sık karşılaşılan humongöz man sayfası.

Bash yerleşiklerinde hızlı bir şekilde yardım almak için helpşunları kullanın :

help read

İstediğin şey bu.

Man sayfası benzeri biçimlendirme için

help -m read

veya daha da iyisi,

help -m read | less

Hala man sayfasında onu aramakta ısrar edersen, beni bir komutun açıklamasına çabucak götüren şeyi buluyorum.

/^\s*read [[]

Bu, bir komut ilk açıklandığında isminin satırın başından biraz girintili olduğu için işe yarıyor. Belirli bir durumda read, gerçek readbelgelere ulaşmadan önce bu biraz göz atmanız gerekir, çünkü (bariz nedenlerden dolayı) "okuma" kelimesi man sayfasında çok tekrarlanır. [[], Genellikle isteğe bağlı parametrelerden önceki bir [ile eşleşme anlamına gelir. (Genellikle / ^ \ s * dışına çıkarım ve / / built-command> [[] işlevini yapıyorum)

Başka bir alternatif

Format değişikliğine aldırış etmezseniz, man sayfanızı bir DVI veya PDF dosyasına dönüştürebilirsiniz:

man -T dvi bash >bash.dvi

veya

man -T ps bash | ps2pdf - bash.pdf # Requires the Ghostscript suite for ps2pdf

Elbette, bir DVI veya PDF belgesi verildiğinde, kolayca bir metin araması yapabilirsiniz.

Yaklaşım 1

man bashsonra /read \[sonra/-s

Yaklaşım 2

Sen denilen komut satırı argümanları açıklamak için bir açık kaynak aracı deneyebilirsiniz explainshell .

Yerel olarak kullanılabilir. Https://github.com/idank/explainshell adresindeki belgeleri okuyun.

Uyarılar: Genellikle çalışır, ancak yalnızca Ubuntu'nun manpage deposunda bulunan komutlarla

Senin durumunda, -sgeçişi tanıyamıyor read -s pwd.

Yaklaşım 3

Umut verici görünen başka bir araç buldum ancak sistemimde çalışmıyor.

açıkladı: Unix Komutları için Kısa Belgeler

Bu durumda genellikle yaptığım şey sadece çalıştırılır man, SHELL BUILTIN COMMANDSbaşlığı arar, sonra yerleşikleri arar, yani

man bash
/^SHELL BUILTIN
/  read 

Ancak, bash içinde yapabilirsiniz

help read

veya sisteme bağlı olarak

man 1 read
man bash-builtins

Genel olarak, bunu yapmak için he("kısa yardım") adlı bir komut dosyası var . Böyle koşarsın:

he bash read

Bir man sayfasında bilgi bulmanın genel bir yolu yoktur, kitapta bilgi bulmanın genel bir yolu yoktur. Ne aradığına bağlı.

Bir kabuk yerleşimi hakkında bilgi ararken, yerleşimi girinti için kaydettiği satırın başında arayabilir ve ardından bir boşluk arayabilirsiniz: ^ *read␣(örneğin, tür /^ *read␣ Enter) arama ( ␣boşluk). Bu çizgi, pdksh, mksh ve bash ile çalışır. Zsh'in man sayfası bölünmüş durumda, man sayfasını okuman gerekiyor zshbuiltins. Ksh93, bazı yerleşiklerin isimlerinden önce özel sembollere sahiptir ^ *†*␣, UTF-8'de veya ^ *-*␣ASCII'de aramanız gerekir . Birkaç yanlış pozitif var, ancak bu sizi hızlı bir şekilde doğru çizgiye getirecektir. Aramak ^ *read($| [-[])yanlış pozitiflerin miktarını azaltır.

Çağrı cihazınıza nereye gitmek istediğinizi söyleyerek aramayı hızlandırabilirsiniz. Örneğin PAGER='less "+/^ *read \["' man bash, readyerleşik ifadenin açıklamasına ilişkin bash man sayfasını açar . Bunu bir işlev haline getirebilirsiniz:

man-builtin () {
  PAGER="less '+/^ *$1(\$|\\[|-)'" man ${SHELL##*/}
}

Doğrudan bash man sayfasının SHELL BUILTINS COMMANDS bölümüne atlamak için, dosyamda aşağıdaki diğer adı tanımlarım $HOME/.bash_aliases.

alias man-builtin="man -P 'less -p ^SHELL\ BUILTIN\ COMMANDS' bash"

Sadece başka bir alternatif sunmak için, mevcut sayfayı kolayca aramanıza izin veren bir web tarayıcısı kullanmayı tercih ederseniz, freeBSD.org'da kullanılan man.cgi gibi bir şey kullanabilirsiniz. Onlar farklı. Diğer sitelerde de benzer şeyler gördüm, bu yüzden etrafta başka çeşitler de olmasını bekliyoruz.

Apropos altındaki yardım bağlantısı, kendi sayfanıza koymak için betiğin bir kopyasını almak üzere bazı sayfalar sunar.

Bu amaçla bir bash işlevi yaratmaya başladım. Bu snippet örneğin sonuna yapıştırılabilir ~/.bashrc:

manfind() {
  # required args
  test "$1" -a "$2" || return 1                  

  # create temp file and get its name
  local tmp=$(mktemp /tmp/manfindXXXXXX) || return 1
  ( # subshell for trap
    trap "rm $tmp" EXIT

    # grep all matching lines with line numbers and pipe them to dialog
    if man "$1" |                   # get the whole man page
      grep -n "^\s*$2" |            # grep for the search string, with line nums
      sed 's/:/\n/' |               # replace line num separator with newline for dialog
      cut -c-70  |                  # cut long lines to nice length
      xargs -d'\n' -n 999999 \
        dialog --output-fd 3 --menu "Select line to go to" 0 0 0 3>$tmp -- 1 '(start of man page)'
    then
      # selected line number is now in $tmp, get man page and
      # use vim in read only mode to view it at right line
      man "$1" | vim -R +"$(< $tmp)" -
    else
      # cancel selected from dialog
      exit 1
    fi
  )
}

Yorumlar ne yaptığını biraz açıklar. Özellikle varsayılan arama dizesi, verilen kelimeyi satırların başından itibaren arar ve ilk boşluğu atlar. Örnekler:

# find every line which starts with 'read' followed by space
manfind bash 'read '
# research bash subshells
manfind bash '.*subshell'

Not: Bu senaryoda man sayfa bölümleri kavramı yoktur ... Bunu daha sonra çimdik edip etmediğimi göreceğim, ancak insanınMANSECT ortam değişkenini ayarlamak yardımcı olur.

Buradaki diğer tartışmalardan parçaları bir araya getirerek, içinde .bashrcdoğrudan bırakabileceğiniz (varsa) sizi içine alabileceğiniz hızlı bir işlev . Aksi takdirde mannormal şekilde açılır :

man() {
    case "$(/bin/bash -c 'type -t '"$1")" in 
        builtin)
            LESS=+?"^       $1 " command -p man bash
            ;;
        *)
            command -p man $@
            ;;
    esac
}

Herhangi bir Linux dağıtımından info bash, bilgilerin man sayfalarıyla aynı olduğu eylem türüne göre ayrı paragraflara sahip olmak istiyorsanız kullanabilmelisiniz .