Abi leidmine: man, --help ja info

Kui uus käsk ei tööta või selle mõte ei ole selge, siis esimene mõistlik reaktsioon ei ole juhuslik veebileht, vaid käsu enda abi.

Loogika

Abi otsimisel on hea liikuda selles järjekorras:

1. ava man, kui tahad rahulikku tervikpilti
2. proovi --help, kui tahad lühikest meeldetuletust
3. kasuta whatis või apropos, kui sa ei mäleta käsu nime
4. vaata info, kui teema on suurem GNU tööriistade kogum

See peatükk on seotud kogu ülejäänud õpikuga, sest iga uue käsu õppimine peaks algama just siit.

1. Käsu manuaal: man

Kõige tavalisem kuju on:

man ls

See avab käsu manuaali.

Mida seal teha saab

• Space liigub järgmise lehe peale
• b liigub tagasi
• /muster otsib tekstist
• q väljub

Näited

man ls
man grep
man less

Kui sa ei tea veel kõiki detaile, siis piisab alguses täiesti sellest, et loed manuaali alguse läbi ja otsid üles kõige tavalisemad valikud.

2. Lühike abi: --help

Paljud käsud toetavad lühikest abi kujul:

ls --help
grep --help

See on hea siis, kui tahad kiirelt näha:

• milliseid lippe käsk toetab
• milline on põhisüntaks
• mis järjekorras argumendid käivad

--help on eriti mugav siis, kui sa ei taha kohe pikka manuaali lugema minna.

3. -h, --help ja -H ei ole sama asi

Kõik käsud ei kasuta samu võtmeid.

• --help on levinud GNU stiil
• -h tähendab mõnes käsus abi, mõnes käsus midagi muud
• -H tähendab sageli hoopis teist käitumist

Seepärast ei maksa eeldada, et -h on alati “help”.

Praktiline rusikareegel:

• proovi kõigepealt man käsk
• seejärel vaata käsk --help

4. Kui käsu nime ei mäleta

Mõnikord tead teemat, aga mitte käsku. Siis on abiks:

whatis ls
apropos archive

Vahe nende vahel

• whatis käsk annab ühe lühikirjelduse tuntud käsu kohta
• apropos sõna otsib märksõna järgi seotud käske

Näited:

whatis awk
apropos copy
apropos archive

5. GNU info-dokumendid

Mõne suurema GNU tööriistakogumi puhul kohtad ka käsku:

info coreutils

See ei ole alguses kõige tähtsam tööriist, aga hea on teada, et ta on olemas.

info on kõige kasulikum siis, kui:

• man tundub liiga lühike
• teema koosneb tervest tööriistaperest
• vajad sügavamat dokumentatsiooni

6. Väike praktiline rada

Kui sa ei mäleta, kuidas tar töötab, siis hea järjekord on:

man tar
tar --help
apropos archive

Siin:

1. man tar annab tervikpildi
2. tar --help näitab lühikest meeldetuletust
3. apropos archive aitab leida ka teisi samasse teemasse kuuluvaid käske

Minitest

1. Ava man less.
2. Kontrolli, kas käsk tar toetab kuju --help.
3. Leia apropos abil mõni pakkimisega seotud käsk.
4. Vaata käsu ls lühikirjeldust käsuga whatis.