Triky a tipy pro vyhledávání informací na manuálových stránkách [uzavřeno]

Věnujte pozornost číslu sekce: Předpokládejme, že potřebujete pomoc s printf. existují alespoň dva z nich: v prostředí shell a C. Základní verze printf je v sekci 1, verze C v sekci 3 nebo 3C. Pokud nevíte, který z nich chcete, zadejte man -a printf a zobrazí se všechny ruční stránky.

Pokud hledáte formát formátu printf se všemi% kódy a nezobrazí se na printf manuálové stránce, můžete přeskočit na související manuálové stránky uvedené pod SEE TAKÉ odstavec. Můžete najít něco jako formats(5), které vám navrhne zadat man 5 formats.

Pokud vás štve man printf vám poskytne printf (1) a vše, co chcete, je printf (3), musíte změnit pořadí naskenovaných adresářů v prostředí MANPATH proměnnou a dejte ty pro jazyk C před ty pro příkazy prostředí. K tomu může dojít, i když jsou stránky Fortran nebo TCL / Tk uvedeny před C.

Pokud nevíte, kde začít, zadejte man intro nebo man -s <section> intro. Získáte tak souhrn příkazů požadované sekce.

Sekce jsou dobře definované:

• 1 je pro shell příkazy,
• 2 je pro systémová volání,
• 3 pro programovací rozhraní (někdy 3C pro C, 3F pro Fortran …)
• 5 pro formáty souborů a další pravidla, jako jsou formáty printf nebo regex.

V neposlední řadě: informace dodávané na manuálových stránkách nejsou nadbytečné, proto si je pozorně přečtěte od začátku do konce, abyste zvýšili své šance najít to, co potřebujete.

Komentáře

• Ve většině systémů si můžete prohlédnout man man a zobrazit celou popis různých sekcí.
• Bylo by skvělé, kdyby existoval program pro vyhledávání stránek podle « klíčových slov ». Tj. nedávno Nelze ' si nepamatovat název funkce c a najít podřetězec (strstr()) a Neměl jsem kolem sebe žádný internet.
• @ Hi-Angel man -k substring nebo apropos substring by vám pomohly.

Zadejte lomítko / a zadejte řetězec do hledat. Poté pokračujte stisknutím n k přechodu na další položku

Komentáře

• shift + n přejít na předchozí zápas. Tak užitečné!

man -k vyhledávání

Získáte seznam všech manuálových stránek, které se vztahují k „vyhledávání“.

Komentáře

• A seznam všech manuálových stránek, které se týkají ' vyhledávání ' v konkrétní části (například číslo 3) by se dalo použít toto: man -k search -s 3 Také uvedeno v superuser.com/a/677969/ 599957
• Vím, že podobné komentáře jsou zamračeny, ale děkuji, děkuji, děkuji! Doslova jsem hledal takový příkaz déle, než jsem si ' připustil … roky !!
• apropos search je ekvivalentní s man -k search 🙂

Jak říká @Steven D, nezapomeňte na stránky info.

Kromě toho se nenechte zastrašit info stránky. Znám spoustu lidí, kteří informační stránky nepoužívají kvůli integrovanému navigačnímu systému. Mým oblíbeným řešením je procházet informační stránky prostřednictvím less:

info gpg |less 

Tímto způsobem mohu procházet stránky info pomocí svého oblíbeného pageru. info se nyní budou chovat stejně jako stránky man.

Komentáře

• hej, ten ' je skvělý tip pro navigaci

apropos Nástroj je opravdu užitečný pro nalezení vhodné stránky.

Komentáře

• man -k = = apropos není ' to?
• apropos je to, co používám pořád, když hledám něco, co pro sebe nemá stránku man.
• ' man man ' říká, že ' man -k ' odpovídá ' apropos -r '. Myslím, že apropos je trochu silnější. Obecně používám ' man -k ', protože ' je o něco kratší.

Výchozí pager pro čtení manuálové stránky je less . Dokumentace je less zde .

Zejména:

• Posun nahoru / dolů o jednu stránku: b / mezera
• Posun nahoru / dolů o půl stránky: u / d
• Vyhledávání vpřed / vzad: / / ? , poté zadejte regulární výraz,
  • poté stiskněte n pro přechod na další zápas, nebo
  • shift + N pro přechod na předchozí zápas.
  • Pokud je stránka pokryta nezajímavými shodami, stisknutím mezerníku přejděte na další stránku.
• Přidejte @ před regulární výraz, který chcete hledat od začátku.

Komentáře

• TOTO je nejlepší odpověď. Body navíc za používání symbolů kbd. 😉
• Posun nahoru / dolů o jednu stránku lze provést také pomocí ctrl+space / f, což může být užitečné podle toho, které prsty chcete při navigaci použít.

Vždy zkontrolujte, co je v část VIZ TÉŽ. Příkazy zobrazené v této části na stránce info lze vybrat umístěním kurzoru na požadovaný příkaz a stisknutím klávesy Enter. Často najdu další užitečné příkazy nebo funkce, které způsobem.

Pokud vám editor vyhovuje více než výchozí pager, můžete nastavit MANPAGER ve vašem prostředí. Například mám tento řádek ve své ~/.bashrc:

export MANPAGER="col -b | vim -c "set ft=man nomod nolist ignorecase" -" 

Předpokládám, že použití většiny pageru je dobrý nápad. Tento pager je velmi výkonný, ale pro mě je to hlavní vlastnost – zobrazování barevných manuálových stránek. Tato funkce zlepšuje vnímání prostého textu a usnadňuje vyhledávání potřebných informací.

Podívejte se na přiložený snímek obrazovky, text vypadá velmi pěkně, že?

Komentáře

• Vynechali jste nejdůležitější informace: jak mohu použít most k prohlížení manuálových stránek.
• @ACK_stoverflow – pravděpodobně není dobrý nápad doporučit člověku, aby to provedl > ~/.bashrc, protože tím přepíše to, co už tam je. Lepší je přidat (>>) nebo přidat vápno podle mého názoru ručně.
• @vatsug Páni dobrý hovor, tady by měl mít můj komentář řekl: Nainstalujte si to a vyzkoušejte: aptitude install most; export MANPAGER="most"; man man. Chcete-li, aby byl trvalý: echo 'export MANPAGER="most"' >> ~/.bashrc

Neignorujte stránky info. Mnoho nástrojů GNU má mnohem rozsáhlejší informační stránky než manuálové stránky. V sekci SEE ALSO se často zobrazuje „Úplná dokumentace pro foo je udržována jako příručka Texinfo.“ To platí zejména pro cokoli v balíčku GNU coreutils.

Také, pokud jste uživatelem emacsu, nezapomeňte, že si můžete přečíst informace a ruční stránky, aniž byste opustili editor: M-x info a M-x woman.

V systému Linux man, můžete man -K string (všimněte si velkého písmene K) a vyhledejte hrubou silou daného výrazu

 -K, --global-apropos Search for text in all manual pages. This is a brute-force search, and is likely to take some time; if you can, you should specify a section to reduce the number of pages that need to be searched. Search terms may be simple strings (the default), or regular expressions if the --regex option is used. 

velmi užitečné, když nevíte, kde hledat.

Z Kristofovy odpovědi, pokud (tj.) Napíšete man -k chmod, získáte seznam možností.Poznamenejte si číslo v závorkách, to znamená sekci, kterou je třeba hledat na manuálových stránkách:

V systému UNIX můžete vyzkoušet:

man -s1 chmod zobrazí manuálovou stránku pro příkaz chmod

man -s2 chmod zobrazí manuálovou stránku pro funkci C lib chmod ()

V systému Linux byste měli změnit -s za -S

komentáře

• muž 1 chmod člověk 2 chmod dělá totéž.

pro ty delší, více složité man stránky Zjistím, že je mnohem snazší je číst mimo počítač (liché, já vím), a proto mám tyto funkce ve svých .bashrc

# Print man pages manp() { man -t "$@" | lpr -pPrinter; } # Create pdf of man page - requires ghostscript and mimeinfo manpdf() { man -t "$@" | ps2pdf - /tmp/manpdf_$1.pdf && \ xdg-open /tmp/manpdf_$1.pdf ;} 

Zobrazit manuálové stránky v uživatelsky přívětivé grafické aplikaci:

konqueror man:(command) 

Obsah nejvyšší úrovně:

konqueror man: 

Funkce:

• Pokud zadáte příkaz t klobouk má shodu ve více sekcích, přenese vás na stránku disambiguation
• Jedná se o grafickou aplikaci, takže si pro navigaci po stránce nemusíte pamatovat tajné sekvence kláves
• Zahrnuje hypertextové odkazy na související stránky (včetně stránek „viz také“)
• Související stránky můžete otevřít na samostatných kartách

Komentáře

• Mimochodem, toto funguje také s info:(command). Některé programy poskytují mnohem více informací prostřednictvím " informací " než prostřednictvím " man " a konqueror poskytuje mnohem hezčí rozhraní pro procházení těchto informačních stránek. Poznámka: Pouhé použití info: funguje také pro získání obsahu nejvyšší úrovně.
• Podobného efektu lze dosáhnout pomocí gman balíček, který zřizuje webový server manpage na adrese localhost / cgi-bin / man / man2html .
• Alternativy na AskUbuntu: askubuntu.com/questions/253705/…
• … nahrazení konqueror odlehčeného doplňku – i když má nedostatek toho, že nepředloží obsah nebo stránku s rozcestníkem pro jména používá se ve více sekcích. Musíte je výslovně odlišit připojením .(section) – např. yelp man:open.2. Můžete také použít < kbd > Ctrl-L < / kbd > otevřete panel umístění.

Dayum, lidi! Co je se spletitými odpověďmi ?! Co se stalo s jednoduchostí, která je klíčem k lesku, a co ne? Většina vašich klíčů vi / vim bude plavat:

/ or ? – Hledání vpřed nebo vzad (jak už někteří z chlápků zmínili). V případě prvního z nich bude malá písmena n procházet zápasy vpřed, velká N bude vrátit se zpět. Opak je pravdou pro druhý jmenovaný – otazník.

Mírně složitější vyhledávání pomocí regulárních výrazů. Rozdíl mezi man (nebo less) a VIM je, že při deklaraci metaznaků ve vašem výrazu musíte použít znak escape () k vyjádření metaznaků. Dobrou zprávou je, že když používáte první (man nebo less) – ne tolik. Můžete to tedy snadno použít například při hledání iptables manuálová stránka pro několik podobných výrazů: . Pokud vaše běžné výrazy neznají, znamená to „Hledat výskyty slov iptables NEBO rules„. Po zadání tohoto a dalším stisknutí tlačítka n budete procházet střídavé výsledky hledání, přičemž výsledky budou pro vás pěkně zvýrazněny různými barvami (vlastně dvě. Haha). Pokud se pokoušíte procházet stránkou a chcete se soustředit na konkrétní pojmy nebo koncepty – nenechte si ujít jedinou věc!

A samozřejmě pro rychlejší navigaci běžná vi standbies stále stojí (není zamýšleno slovní hříčka): gg nebo G – začátek / konec dokumentu; (oprava ! V man můžete použít všechny níže uvedené klíče bez použití Ctrl. To platí pouze pro vi). Ctrl + u or d – Posun nahoru nebo dolů; Ctrl + b or f – Totéž, jen větší skoky. „Stránka vzad nebo vpřed“; e nebo y – posouvání o jeden řádek, ale myslím, že většina lidí by raději používala klávesy se šipkami. Pokud však chcete zůstat na čísle „1337“ a „nikdy neopouštět domácí řádek“ (jako já lol) – je to způsob, jak jít.

Snažím se říci, že UNIX má dvě hlavní příchutě ovládacích prvků klávesnice, které jsou součástí knihovny readline: vi a emacs. Zvyšte si kotlety v jednom (ale nejlépe v obou) a „to vám život výrazně zkomplikuje. Většina programů CLI v systému UNIX používá jeden z nich. BASH ve výchozím nastavení používá ovládací prvky emacs, lze jej však snadno nastavit na režim „vi“ zadáním set -o vi. Totéž lze říci o regulárních výrazech, ale to bude mimo téma. Dokonce bych řekl, že oba jsou „lingua franca“ systému UNIX.

Podobná, ale mírně odlišná od odpovědi Roba Hoelze,

Přidejte do svého ~/.vimrc:

let $GROFF_NO_SGR=1 runtime ftplugin/man.vim 

Nyní je vimman vynikajícím prohlížečem stránek a :Man z prostředí Vim (nebo jednoduše stiskem K nad klíčovým slovem) je vynikající prohlížeč stránek.

Většina z nás nastavila proměnnou PATH. Ukáže vám, jak automaticky nastavit cestu pro vyhledávání člověka tak, aby odpovídala vaší cestě hledání příkazu.

Řekněme, že připojíte cesta k zahrnutí vašich osobních, pracovně specifických a místně nainstalovaných nástrojů, například export PATH=$PATH:~/bin:/workgroup/bin:/opt/local/bin:. Jako vedlejší efekt man foo nebude zobrazovat stránky uložené v ~ / man, / workgroup / man nebo / opt / local / man.

Řešení toto, používám příkaz manpath k automatickému nastavení cesty hledání manuálové stránky. Například můj ~ / .bashrc má následující. Funguje to pro mě na stovce různých systémů, kde běží vše z FreeBSD 4.x, Darwin a CentOS 5:

### PATH & MANPATH # My personal utilities export PATH=$PATH:$HOME/bin ### Set the manpath based on the PATH, after man(1) parses man.conf # - No need to modify man.conf or manually modify MANPATH_MAP # - Works on Linux, FreeBSD & Darwin, unlike /etc/manpaths.d/ # See "SEARCH PATH FOR MANUAL PAGES" in man(1) # Just set the man search path. Don"t print output to screeen. manpath >/dev/null 

Některé systémy (jako Apple Leopard) nastavují MANPATH automaticky, ale to znamená, že váš systém bude používat Proměnná MANPATH namísto použití manpath. V důsledku toho jsou stránky manuálu pro „MacPorts“ (/ opt / local / man) ignorovány. Chci to ovládat sám, takže jsem zrušil nastavení MANPATH:

unset MANPATH manpath >/dev/null 

Pokud hledáte informace týkající se bash builtin (například time, disown, set nebo [[), místo procházení podrobnou bash informační stránkou nebo man bash můžete zadat help {builtin-keyword} a rychle získáte základní informace o syntaxi.

Pokud vás štve, man man vám dá printf ( 1) a vše, co chcete, je printf (3), můžete říct člověku, že chcete printf ze sekce 3, tím, že dáte sekci před printf, například: man 3 printf, aniž byste museli měnit pořadí naskenovaných adresářů v proměnné prostředí MANPATH a dejte ty pro jazyk C před ty pro příkazy prostředí.

Používám grep. Pokud by mě zajímalo, co udělala možnost -s příkazu read, zkusím tyto příkazy v pořadí, dokud nedostanu odpověď :

info read |grep \\-s man read |grep \\-s help read |grep \\-s 

V tomto případě poskytl jasnou odpověď pouze příkaz info. Tato vynikající odpověď poskytuje podrobnosti o různých systémech nápovědy.

man -a printf na mém stroji s Linuxem má výchozí nastavení man 1. whatis printf mi poskytuje příslušné informace.

Pokud zjistíte, že je obtížné číst manuálové stránky kvůli celému bílému textu, můžete je obarvit. Většina manuálových stránek se otevře pomocí less. Pro less, v .bashrc od zde :

man() { LESS_TERMCAP_md=$"\e[01;31m" \red LESS_TERMCAP_me=$"\e[0m" \ LESS_TERMCAP_se=$"\e[0m" \ LESS_TERMCAP_so=$"\e[01;44;33m" \yellow on blue LESS_TERMCAP_ue=$"\e[0m" \ LESS_TERMCAP_us=$"\e[01;32m" \green command man "$@" } 

Toto je pro bash a zsh. Pro most, fish, xterm a rxvt viz výše uvedený odkaz.

Další čtení:

• Barvy v manuálových stránkách

• Dokumentace k proměnným LESS_TERMCAP_ *?

• Manuál Termcap – https://www.gnu.org/software/termutils/manual/termcap-1.3/html_mono/termcap.html

• Pro barevné kódy- https://wiki.archlinux.org/index.php?title=Bash/Prompt_customization&oldid=362976#List_of_colors_for_prompt_and_Bash

Chcete-li efektivně hledat přepínání jednotlivých znaků, například -u, můžete často použít:

/^ *-u($|\s) 

Šetří spoustu času, pokud má mnoho možností předponu „-u“.

Komentáře

• Tento regex by byl také užitečný: /-u($|[,\s]) v případě, že je znak volby orámován čárkou. Pokud ale chcete vidět všechny položky volitelného znaku ' u ' (jako -u] v [--udp|-u] příručce netstat) ' budete něco podobného potřebovat: /-u($|[^a-z]) A je-li vi nebo vim použit jako pager: /-u\($\|[^a-z]\)

The apropos ( 1) Příkaz se používá pro vyhledávání manuálových stránek. Většina implementací apropos (1) však hledá pouze v sekci JMÉNO, což je velmi omezující.

NetBSD má implementaci fulltextového vyhledávání apropos (1), která je schopna prohledávat celý obsah manuálových stránek. K dispozici je také webové rozhraní: man-k.org , které si můžete vyzkoušet.

A pro ty lidi, kteří rádi čte stránky man a info na dotykové obrazovce, můžete přepnout man / info na yad nebo zenity a využít všechny vychytávky gtk3 jako nativní prst svitek. Skvěle funguje také s refular obrazovkou a myší:

man cat |yad --text-info 

Můžete také použít zenity nebo můžete přidat možnosti yad jako:

man cat |yad --text-info --height=500 --width=800 --center --wrap --show-uri --no-markup & 

Tip: zobrazením uri můžete klepnout na webové odkazy uvnitř manuálových stránek myší / prstem.