4 175
muokkausta
Ero sivun ”Man” versioiden välillä
Siirry navigaatioon
Siirry hakuun
vähän lisää materiaalia Raja-anturasta tekijän luvalla
Pb (keskustelu | muokkaukset) p (luokka) |
(vähän lisää materiaalia Raja-anturasta tekijän luvalla) |
||
| Rivi 2: | Rivi 2: | ||
Man-komennolla saat esille ohjelman [[Dokumentaatio|ohjeita]] sisältävän manuaalisivun. | Man-komennolla saat esille ohjelman [[Dokumentaatio|ohjeita]] sisältävän manuaalisivun. | ||
== Man-sivut == | |||
Man-sivut on jaettu kahdeksaan eri kategoriaan, jotka ovat seuraavat: | Man-sivut on jaettu kahdeksaan eri kategoriaan, jotka ovat seuraavat: | ||
#Yleiset komennot | #Yleiset komennot | ||
| Rivi 11: | Rivi 12: | ||
#Sekalaista | #Sekalaista | ||
#Järjestelmänhallinnan komennot ja [[demoni]]t eli taustaprosessit | #Järjestelmänhallinnan komennot ja [[demoni]]t eli taustaprosessit | ||
Man-sivut ovat järjestelmän käyttöohjeita, ja lähes jokainen ohjelma sisältää oman man-sivunsa. Sivujen selailu onnistuu komennolla <tt>man ohjelman_nimi</tt>. Myös monien ohjelmointikielien funktioille on omat man-sivunsa (esim. <tt>man printf</tt>). Tämä komento siis näyttää man-sivun halutusta aiheesta. Man-komento ei suinkaan ole ainoa millä man-sivuja voidaan selata, on olemassa myös mm. [[apropos]] ja [[whatis]] -työkalut jotka on suunnattu lähinnä man-sivujen etsimiseen. | |||
Man-sivut ovat hyvin loogisia rakenteeltaan, yleensä ne sisältävät järjestyksessään seuraavat osiot: ohjelman nimi (''name''), mahdolliset kytkimet (''synopsis''), ohjelman kuvaus (''description''), ohjelman asetukset (''options''), ohjelman tiedostot (''files''), katso myös (''see also''), tiedot virheraportointia varten (''bugs'') ja Atiedot tekijästä (''author''). Nämä voivat myös esiintyä eri nimillä, osa niistä voi puuttua tai niitä voi olla enemmän. Mutta nämä ovat man-sivujen "standardit" osiot. Voit tulkita niitä seuraavasti: | |||
*''Name'' on ohjelman nimi sekä lyhyt kuvaus ohjelmaan, siihen ei ole sen kummallisempaa lisättävää. | |||
*''Synopsis'' kertoo, mitä kytkimiä voidaan lisätä komennon perään ja pääasiallisesti sen, kuinka niitä käytetään. ''Synopsis''-osiossa on erikoismerkintöjä, joilla on oma tarkoituksensa optioiden selittämisessä. Esimerkiksi komento <tt>man man</tt> näyttää jotakuinkin seuraavaa: | |||
'''man''' ['''-c'''|'''-w'''|'''-tZ'''] ['''-H'''[<u>browser</u>]] ... | |||
Lihavoitu osa tekstistä kertoo meille että se teksti tulee kirjoittaa juuri tuolla tavalla - pienillä ja isoilla kirjaimilla on väliä. Alleviivattu teksti taas meidän tulee korvata vihjeen mukaisella argumentilla. Tässä tapauksessa argumentti on browser (selain), joka voidaan korvata esim. [[Konqueror]]illa. |-merkit taas kertovat ettei näitä samojen sulkujen sisässä olevia argumentteja voi käyttää yhtäaikaisesti. | |||
*''Description'' on pidennetty kuvaus ohjelmasta ja lyhyt kertomus sen toiminnasta ja erikoispiirteistä. | |||
*''Options'' kertoo tarkasti jokaisen erillisen kytkimen toiminnan sekä selittää, kuinka ja missä tilanteessa niitä tulisi käyttää. | |||
*''Files'' näyttää komentoon liittyvien tärkeiden tiedostojen (esim. asetustiedostot) sijainnit [[Linuxin hakemistorakenne|hakemistopuussa]]. | |||
*''See Also'' näyttää muut man-sivut, joista voi olla hyötyä komennon kanssa ja sellaiset man-sivut, joihin on man-sivulla viitattu. | |||
*''Bugs'' ei suinkaan kerro mitä virheitä ohjelmassa on, vaan osoitteen johon virheraportteja voidaan lähettää. | |||
*''Authors'' kertoo ohjelman tekijät ja mahdollisesti valmistumisajankohdan | |||
Nyt osaamme siis tulkita man-sivuilta löytyviä tietoja. Seuraavaksi siirrymmekin sitten edistyksellisemmisiin ominaisuuksiin kuten sivujen hakeminen. | |||
== Käyttö == | == Käyttö == | ||
man zsh | man zsh | ||
Avaa [[zsh]]-[[komentotulkki|komentotulkin]] | Avaa [[zsh]]-[[komentotulkki|komentotulkin]] man-sivun. | ||
Joskus eri kategorioissa saattaa olla samannnimisiä komentoja. Tällöin man-komennolla on kerrottava haluttavan kategorian numero. Esimerkiksi komento | Joskus eri kategorioissa saattaa olla samannnimisiä komentoja. Tällöin man-komennolla on kerrottava haluttavan kategorian numero. Esimerkiksi komento | ||
| Rivi 23: | Rivi 42: | ||
man echo | man echo | ||
avaa sivun echo(1), koska tämä on yleisemmin käytetty komento. Sen onko samalla nimellä useita eri man-sivuja saa selville [[whatis]]-komennolla. | avaa sivun echo(1), koska tämä on yleisemmin käytetty komento. Sen onko samalla nimellä useita eri man-sivuja saa selville [[whatis]]-komennolla. | ||
Man-sivua ei välttämättä aina löydy sille komennolle tai ainakaan sillä nimellä, mitä etsitään. Ei paniikkia, man-sivut sisältävät loistavat hakuominaisuudet - tai oikeastaan [[bash]]-komentokehote ja man-ohjelma sisältävät, sillä bashin tuntemuksella voi parantaa hakuominaisuuksia huomattavasti. Man-sivujen hakeminen tapahtuu komennolla <tt>man -k haettava_sana</tt>. Se kutsuu komentoa [[apropos]], joten voit myös käyttää muotoa <tt>apropos haettava_sana</tt> ja saat saman tuloksen. Otetaan esimerkki komennon [[bzip2]] man-sivun hakemisesta: | |||
man -k bzip2 | man -k bzip2 | ||
| Rivi 31: | Rivi 52: | ||
bzcmp [bzdiff] (1) - compare bzip2 compressed files | bzcmp [bzdiff] (1) - compare bzip2 compressed files | ||
bzdiff (1) - compare bzip2 compressed files | bzdiff (1) - compare bzip2 compressed files | ||
Rivien muotoilu on seuraava: ''Ohjelman nimi (kategorian numero) - kuvaus''. | |||
Aproposin ja man -k:n haku perustuu [[whatis]]in tietokantaan. | |||
Joskus samalla ohjelmalla on useampia man-sivuja eri kategorioissa. Kokeillaan esimerkiksi avata komennon <tt>foo</tt> man-sivu (tällaista ei siis ole oikeasti): | |||
man foo | |||
foo(3) – Foo-funktio | |||
foo(1) – Foo-komento | |||
Jolloin foo-komennon man-sivun näkisimme komennolla | |||
man 1 foo | |||
== Katso myös == | |||
*[[Info]] | |||
[[Luokka:Komentorivin perustyökalut]] | [[Luokka:Komentorivin perustyökalut]] | ||
[[Luokka:Ohjeet]] | [[Luokka:Ohjeet]] | ||