path: root/man/fi/man.man

.\" From rkoski@pp.weppi.fi Sun Jun 28 12:50:44 1998
.\"
.\" Man page for man (and the former manpath)
.\"
.\" Copyright (c) 1990, 1991, John W. Eaton.
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the README file that comes with the man 1.0
.\" distribution.  
.\"
.\" John W. Eaton
.\" jwe@che.utexas.edu
.\" Department of Chemical Engineering
.\" The University of Texas at Austin
.\" Austin, Texas  78712
.\"
.\" Many changes - aeb
.\" Translated into Finnish by Teppo Kankaanpää (photon@clinet.fi)
.\" Proofread by Raimo Koski (rkoski@pp.weppi.fi)
.\" Reconstructed man.man from man.1 - aeb
.\"
.\" TERM man_page man-sivu     Näin se oli sotin sivuillakin..
.\" TERM manual_page ohjesivu
.\" TERM section osasto        Osasto kuvaa melko hyvin manin luonnetta
.\" TERM pager näytinohjelma   Tulee ihan IBM ja sen näyttimet mieleen...
.\" TERM debugging_info,debugging_information debuggaustiedot
.\" TERM preprocessor esikäsittelyohjelma,esikäsittelijä Mikä olisi parempi?
.\" TERM message_catalog viestikirjasto
.\" TERM search_path hakupolku
.\" TERM owner_mode käyttöoikeudet
.\" TERM suid suid
.\" TERM arguments parametrit
.\"
.TH MAN 1 "4. Kesäkuuta 1998" "Linux" "Käyttäjän sovellusohjelmat"
.LO 1
.SH NIMI
man \- muotoile ja näytä on-line -ohjesivuja
.br
manpath \- määritä käyttäjän hakupolku man-sivuihin
.SH "YLEISKATSAUS"
man [\-acdfhkKtwW] [\-m järjestelmä] [\-p merkkijono] [\-C konfiguraatiotiedosto] [\-M polku]
[\-P selausohjelma] [\-S sektiolista] [sektio] nimi ...
.SH KUVAUS
.B man
muotoilee ja näyttää on-line -ohjesivuja. Tämä versio tuntee
ympäristömuuttujat
.B MANPATH
ja
.BR "(MAN)PAGER" ,
joten sinulla voi olla oma(t) kokoelmasi man-sivuja ja voit valita minkä tahansa
ohjelman näyttämään muotoillut sivut. Jos
.I sektio
on annettu,
.B man
etsii sivuja vain siitä sektiosta.
Voit myös määritellä, missä järjestyksessä sektiot läpikäydään
sivuja haettaessa ja minkä esikäsittelyohjelmien läpi lähdetiedostot
ajetaan, joko komentorivioptioiden tai ympäristömuuttujien avulla.
Jos
.I nimi
sisältää / -merkin, yritetään se ensin käsitellä tiedostonimenä,
joten voit kirjoittaa
.B "man ./foo.5"
tai vaikkapa
.B "man /cd/foo/bar.1.gz\fR.\fP"
.SH OPTIOT
.TP
.B \-\^C " config_file"
Määrittele käytettävä man.conf -tiedosto. Oletus on
.BR @man_config_file@ .
(Katso
.BR man.conf (5).)
.TP
.B \-\^M " polku"
Määrittele hakemistolista, joista man-sivuja etsitään.
Jos optiota ei käytetä, katsotaan lista ympäristömuuttujasta
.BR MANPATH .
Jos tällaista ympäristömuuttujaa ei löydy, oletuslista haetaan
tiedostosta
.BR @man_config_file@ .
Jos
.B MANPATH
sisältää tyhjän merkkijonon, käytetään myös tällöin oletuslistaa.
.TP
.B \-\^P " pager"
Määrittele, millä ohjelmalla sivuja katsotaan.
Tämä optio kumoaa
.BR MANPAGER "-ympäristömuuttujan"
vaikutuksen, joka taas löytyessään kumoaa
.BR PAGER "-ympäristömuuttujan"
vaikutuksen. Oletuksena
.B man
käyttää komentoa
.BR @pager@ .
.TP
.B \-\^S " sektiolista"
Sektiolista on kaksoispisteillä eroteltu lista sektioista, jotka
käydään läpi sivua haettaessa.  Tämä optio kumoaa
.BR MANSECT "-ympäristömuuttujan"
vaikutuksen.
.TP
.B \-\^a
Oletuksena
.B man
lopettaa toimintansa näytettyään ensimmäisen löytämänsä
man-sivun.  Tätä optiota käyttämällä
.B man
pakotetaan näyttämään
.I kaikki
täsmäävät man-sivut.
.TP
.B \-\^c
Uudelleenmuotoile lähteenä oleva man-sivu, vaikka päivitetty cat-sivu
löytyisi.  Tämä voi olla käytännöllistä, jos cat-sivu muotoiltiin
näytölle, jolle mahtuu eri määrä kirjaimia.
.TP
.B \-\^d
Älä näytä itse man-sivua, vaan vain debuggaustiedot.
.TP
.B \-\^D
Näytä sekä sivu että debuggaustiedot.
.TP
.B \-\^f
Vastaa komentoa
.BR whatis .
.TP
.B \-\^h
Näytä vain pieni ohje ohjelman käytöstä.
.TP
.B \-\^k
Vastaa komentoa
.BR apropos .
.TP
.B \-\^K
Etsi määriteltyä merkkijonoa *kaikista* man-sivuista.  Varoitus:
tämä on todennäköisesti hyvin hidasta!  Sektion määrittely auttaa.
(Omalla koneellani etsintä kestää minuutin 500 man-sivua kohden)
.TP
.B \-\^m " järjestelmä"
Määrittele etsittäväksi vaihtoehtoinen kokoelma man-sivuja,
pohjautuen annettuun järjestelmänimeen.
.TP
.B \-\^p " merkkijono"
Määrittele esikäsittelijöiden lista, jotka ajetaan ennen
.BR nroff ":ia"
tai
.BR troff ":ia."
Kaikkiin järjestelmiin ei ole asennettu kaikkia esikäsittelyohjelmia.
Jotkin näistä ja niitä vastaavista kirjaimista ovat
eqn (e), grap (g), pic (p), tbl (t), vgrind (v) ja refer (r).
Tämä optio kumoaa
.BR MANROFFSEQ "-ympäristömuuttujan"
vaikutuksen.
.TP
.B \-\^t
Käytä komentoa
.B @troff@
man-sivun muotoiluun ja ohjaa tuloste
.BR vakiotulosteeseen .
Tämä tuloste saatetaan joutua ohjaamaan jonkin filtterin läpi ennen
tulostamista.
.TP
.B \-\^w \fRtai\fP \-\-path
Älä näytä man-sivuja, mutta näytä sijainnit sivuille, jotka
muotoiltaisiin tai näytettäisiin.  Jos mitään parametria ei anneta,
tulostetaan (vakiotulosteeseen) lista hakemistoista, joista
.B man
etsisi sivuja.  Jos
.B manpath
on linkitetty man-ohjelmaan, vastaa "manpath" samaa, kuin "man --path".
.TP
.B \-\^W
Kuten \-\^w, mutta tulosta jokainen tiedostonimi omalle rivilleen ilman
mitään lisätietoja.  Tämä on hyödyllinen komennoissa, kuten
.ft CW
.B "man -aW man | xargs ls -l"
.ft

.SH CAT-SIVUT
Man yrittää tallentaa muotoillut man-sivut säästääkseen
muotoiluun kuluneen ajan seuraavalla kerralla, kun näitä
sivuja tarvitaan.  Perinteisesti muotoillut sivut .../manX:stä
on tallennettu .../catX:ään (... on hakupolku), mutta 
.BR @man_config_file@ ":issa"
voidaan säätää jokin muu hakemistosijoittelu.
Jos tarvittavaa cat-hakemistoa ei löydy, ei cat-sivuja tallenneta.
.PP
On mahdollista asettaa
.BR man "in"
suid:ksi käyttäjä man.  Jos man omistaa cat-hakemiston, jonka
käyttöoikeudet ovat 0755 (vain man-käyttäjän
kirjoitettavissa) ja cat-tiedostojen käyttöoikeudet ovat 0644 tai 0444
(vain man-käyttäjän
tai ei kenenkään kirjoitettavissa), ei tavallinen käyttäjä voi
muuttaa cat-sivuja tai laittaa muita tiedostoja cat-hakemistoon.
Jos
.BR man "ille"
ei ole määritelty suidia, silloin cat-hakemiston
käyttöoikeuksien pitäisi olla 0777,
jolloin jokainen käyttäjä voisi jättää cat-sivuja sinne.
.PP
Optio
.B \-c
pakottaa muotoilemaan sivun uudelleen, vaikka uusi cat-sivu löytyisikin.
.SH YMPÄRISTÖMUUTTUJAT
.TP
.B MANPATH
Jos
.B MANPATH
on asetettu, sen arvoa käytetään polkuna man-sivuja etsittäessä.
.TP
.B MANROFFSEQ
Jos
.B MANROFFSEQ
on asetettu, sen arvoa käytetään määrittelemään esikäsittelijät,
jotka ajetaan ennen
.BR nroff "ia"
tai
.BR troff "ia."
Oletuksena sivut ajetaan
tbl(1)-esikäsittelijän läpi ennen
.BR nroff "ia."
.TP
.B MANSECT
Jos
.B MANSECT
on asetettu, sen arvoa käytetään määrittelemään, mistä sektioista
sivuja etsitään.
.TP
.B MANWIDTH
Jos
.B MANWIDTH
on asetettu, sen arvo kertoo leveyden, jolla sivut näytetään ruudulla.
Muuten sivut näytetään koko ruudun levyisinä.
.TP
.B MANPAGER
Jos
.B MANPAGER
on asetettu, sen arvo kertoo ohjelman nimen, jota käytetään man-sivujen
esittämiseen.  Muuten käytetään ympäristömuuttujaa
.BR PAGER .
Jos sitäkään ei ole asetettu, käytetään komentoa
.BR @pager@ .
.TP
.B LANG
Jos
.B LANG
on asetettu, sen arvo määrittelee alihakemiston nimen, mistä
man etsii ensin sivuja.  Niinpä komento 'LANG=fi man 1 foo'
saa manin etsimään ensin sivua .../fi/man1/foo.1.
Jos tätä ei löydy, etsii man sivua .../man1/foo.1.
Merkit ... tarkoittavat hakupolkua.
.TP
.B "NLSPATH, LC_MESSAGES, LANG"
Ympäristömuuttujat
.B NLSPATH
ja
.B LC_MESSAGES
(tai
.BR LANG ,
jos jälkimmäistä ei ole asetettu) kertovat käytettävän viestikirjaston.
(Englanninkieliset viestit on käännetty ohjelman sisään,
joten ne eivät tarvitse erillistä viestikirjastoa.)
Huomaa, että man saattaa käyttää ohjelmia, kuten col(1), jotka
käyttävät myös esimerkiksi muuttujaa LC_CTYPE.
.TP
.B PATH
.BR PATH ":ia"
käytetään muodostamaan oletushakupolkua man-sivuille.
.TP
.B SYSTEM
.B SYSTEM "-ympäristömuuttujaa"
käytetään vaihtoehtoisen järjestelmän oletusnimeksi (optiota
.B \-m
käytettäessä).
.SH BUGIT
Optio
.B \-t
toimii vain, jos troffin kaltainen ohjelma on asennettu.
.br
Jos näet tavuviivojen tilalla vilkkuvan \e255:n tai <AD>:n,
aseta ympäristömuuttuja 'LESSCHARSET=latin1'.
.SH "KATSO MYÖS"
apropos(1) whatis(1) less(1) groff(1).