Ero sivun ”Man” versioiden välillä
Siirry navigaatioon
Siirry hakuun
→Käyttö: Lisäsin että verkkoselain tai Emacs on yleensä kätevämpi kuin man.
pEi muokkausyhteenvetoa |
(→Käyttö: Lisäsin että verkkoselain tai Emacs on yleensä kätevämpi kuin man.) |
||
| (5 välissä olevaa versiota 4 käyttäjän tekeminä ei näytetä) | |||
| Rivi 1: | Rivi 1: | ||
{{DISPLAYTITLE:{{lcfirst:{{PAGENAME}}}}}} | |||
[[Kuva:man.vim.jpg|200px|right|thumb|[[Vim]]in man-sivun alkupäätä.]] | [[Kuva:man.vim.jpg|200px|right|thumb|[[Vim]]in man-sivun alkupäätä.]] | ||
'''man'''-komennolla saat esille ohjelman [[Dokumentaatio|ohjeita]] sisältävän manuaalisivun, yleensä englanninkielisenä. | |||
== Man-sivut == | == Man-sivut == | ||
| Rivi 17: | Rivi 18: | ||
Man-sivut ovat hyvin loogisia rakenteeltaan, yleensä ne sisältävät järjestyksessään seuraavat osiot: ohjelman nimi (''name''), mahdolliset valitsimet (''synopsis''), ohjelman kuvaus (''description''), ohjelman asetukset (''options''), ohjelman tiedostot (''files''), ja katso myös (''see also''), tiedot virheraportointia varten (''bugs'') ja tiedot tekijöistä (''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 standardiosiot. Voit tulkita niitä seuraavasti: | Man-sivut ovat hyvin loogisia rakenteeltaan, yleensä ne sisältävät järjestyksessään seuraavat osiot: ohjelman nimi (''name''), mahdolliset valitsimet (''synopsis''), ohjelman kuvaus (''description''), ohjelman asetukset (''options''), ohjelman tiedostot (''files''), ja katso myös (''see also''), tiedot virheraportointia varten (''bugs'') ja tiedot tekijöistä (''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 standardiosiot. Voit tulkita niitä seuraavasti: | ||
*''Name'' on ohjelman nimi sekä lyhyt kuvaus ohjelmasta, | *''Name'' on ohjelman nimi sekä lyhyt kuvaus ohjelmasta, jota yllämainitut työkalut käyttävät hakuun ja löytyneiden sivujen kuvaamiseen. | ||
*''Synopsis'' kertoo, mitä valitsimia 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: | *''Synopsis'' kertoo, mitä valitsimia 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>]] ... | '''man''' ['''-c'''|'''-w'''|'''-tZ'''] ['''-H'''[<u>browser</u>]] ... | ||
| Rivi 32: | Rivi 33: | ||
== Käyttö == | == Käyttö == | ||
Perinteisen <tt>man</tt>-ohjelman lisäksi, manuaalisivuja voi lukea helpommin mm. [[Verkkoselaimet|verkkoselaimella]] tai [[Emacs|GNU Emacsin]] komennolla <tt>M-x man</tt>. | |||
Avataan [[zsh]]-[[komentotulkki|komentotulkin]] man-sivu: | |||
man zsh | man zsh | ||
Joskus eri kategorioissa saattaa olla samannimisiä komentoja. Tällöin man-komennolla on kerrottava halutun kategorian numero. Esimerkiksi komento | Joskus eri kategorioissa saattaa olla samannimisiä komentoja. Tällöin man-komennolla on kerrottava halutun kategorian numero. Esimerkiksi komento | ||
| Rivi 41: | Rivi 44: | ||
Pelkkä komento | Pelkkä komento | ||
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 tai joissakin komennon versioissa pyytää käyttäjää tarkentamaan, minkä eri man-sivuista hän haluaa nähtäväkseen. Sen onko samalla nimellä useita eri man-sivuja, saa selville [[whatis]]-komennolla (jollei komento sitä itse kerro). | ||
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 hyvät hakuominaisuudet. 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 | ||
Komento suorittaa haun järjestelmän man-sivujen otsaketiedoista, tässä tapauksessa kaikista joihin sisältyy merkkijono [[bzip2]]. | |||
Tuloste näyttää tältä (vain osa tulosteesta): | |||
bunzip2 [bzip2] (1) - a block-sorting file compressor, v1.0.2 | bunzip2 [bzip2] (1) - a block-sorting file compressor, v1.0.2 | ||
bzcat [bzip2] (1) - decompresses files to stdout | bzcat [bzip2] (1) - decompresses files to stdout | ||
| Rivi 65: | Rivi 67: | ||
== Katso myös == | == Katso myös == | ||
*[[Info]] | *[[Info]] | ||
*[[Dokumentaatio]] | |||
[[Luokka:Komentorivin perustyökalut]] | [[Luokka:Komentorivin perustyökalut]] | ||
[[Luokka:Ohjeet]] | [[Luokka:Ohjeet]] | ||
[[Luokka:Ohjelukijat]] | [[Luokka:Ohjelukijat]] | ||
[[pl:man]] | |||