.\" 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     Nin se oli sotin sivuillakin..
.\" TERM manual_page ohjesivu
.\" TERM section osasto        Osasto kuvaa melko hyvin manin luonnetta
.\" TERM pager nytinohjelma   Tulee ihan IBM ja sen nyttimet mieleen...
.\" TERM debugging_info,debugging_information debuggaustiedot
.\" TERM preprocessor esiksittelyohjelma,esiksittelij Mik olisi parempi?
.\" TERM message_catalog viestikirjasto
.\" TERM search_path hakupolku
.\" TERM owner_mode kyttoikeudet
.\" TERM suid suid
.\" TERM arguments parametrit
.\"
.TH MAN 1 "4. Keskuuta 1998" "Linux" "Kyttjn sovellusohjelmat"
.LO 1
.SH NIMI
man \- muotoile ja nyt on-line -ohjesivuja
.br
manpath \- mrit kyttjn hakupolku man-sivuihin
.SH "YLEISKATSAUS"
man [\-acdfhkKtwW] [\-m jrjestelm] [\-p merkkijono] [\-C konfiguraatiotiedosto] [\-M polku]
[\-P selausohjelma] [\-S sektiolista] [sektio] nimi ...
.SH KUVAUS
.B man
muotoilee ja nytt on-line -ohjesivuja. Tm versio tuntee
ympristmuuttujat
.B MANPATH
ja
.BR "(MAN)PAGER" ,
joten sinulla voi olla oma(t) kokoelmasi man-sivuja ja voit valita mink tahansa
ohjelman nyttmn muotoillut sivut. Jos
.I sektio
on annettu,
.B man
etsii sivuja vain siit sektiosta.
Voit mys mritell, miss jrjestyksess sektiot lpikydn
sivuja haettaessa ja mink esiksittelyohjelmien lpi lhdetiedostot
ajetaan, joko komentorivioptioiden tai ympristmuuttujien avulla.
Jos
.I nimi
sislt / -merkin, yritetn se ensin ksitell 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"
Mrittele kytettv man.conf -tiedosto. Oletus on
.BR @man_config_file@ .
(Katso
.BR man.conf (5).)
.TP
.B \-\^M " polku"
Mrittele hakemistolista, joista man-sivuja etsitn.
Jos optiota ei kytet, katsotaan lista ympristmuuttujasta
.BR MANPATH .
Jos tllaista ympristmuuttujaa ei lydy, oletuslista haetaan
tiedostosta
.BR @man_config_file@ .
Jos
.B MANPATH
sislt tyhjn merkkijonon, kytetn mys tllin oletuslistaa.
.TP
.B \-\^P " pager"
Mrittele, mill ohjelmalla sivuja katsotaan.
Tm optio kumoaa
.BR MANPAGER "-ympristmuuttujan"
vaikutuksen, joka taas lytyessn kumoaa
.BR PAGER "-ympristmuuttujan"
vaikutuksen. Oletuksena
.B man
kytt komentoa
.BR @pager@ .
.TP
.B \-\^S " sektiolista"
Sektiolista on kaksoispisteill eroteltu lista sektioista, jotka
kydn lpi sivua haettaessa.  Tm optio kumoaa
.BR MANSECT "-ympristmuuttujan"
vaikutuksen.
.TP
.B \-\^a
Oletuksena
.B man
lopettaa toimintansa nytettyn ensimmisen lytmns
man-sivun.  Tt optiota kyttmll
.B man
pakotetaan nyttmn
.I kaikki
tsmvt man-sivut.
.TP
.B \-\^c
Uudelleenmuotoile lhteen oleva man-sivu, vaikka pivitetty cat-sivu
lytyisi.  Tm voi olla kytnnllist, jos cat-sivu muotoiltiin
nytlle, jolle mahtuu eri mr kirjaimia.
.TP
.B \-\^d
l nyt itse man-sivua, vaan vain debuggaustiedot.
.TP
.B \-\^D
Nyt sek sivu ett debuggaustiedot.
.TP
.B \-\^f
Vastaa komentoa
.BR whatis .
.TP
.B \-\^h
Nyt vain pieni ohje ohjelman kytst.
.TP
.B \-\^k
Vastaa komentoa
.BR apropos .
.TP
.B \-\^K
Etsi mritelty merkkijonoa *kaikista* man-sivuista.  Varoitus:
tm on todennkisesti hyvin hidasta!  Sektion mrittely auttaa.
(Omalla koneellani etsint kest minuutin 500 man-sivua kohden)
.TP
.B \-\^m " jrjestelm"
Mrittele etsittvksi vaihtoehtoinen kokoelma man-sivuja,
pohjautuen annettuun jrjestelmnimeen.
.TP
.B \-\^p " merkkijono"
Mrittele esiksittelijiden lista, jotka ajetaan ennen
.BR nroff ":ia"
tai
.BR troff ":ia."
Kaikkiin jrjestelmiin ei ole asennettu kaikkia esiksittelyohjelmia.
Jotkin nist ja niit vastaavista kirjaimista ovat
eqn (e), grap (g), pic (p), tbl (t), vgrind (v) ja refer (r).
Tm optio kumoaa
.BR MANROFFSEQ "-ympristmuuttujan"
vaikutuksen.
.TP
.B \-\^t
Kyt komentoa
.B @troff@
man-sivun muotoiluun ja ohjaa tuloste
.BR vakiotulosteeseen .
Tm tuloste saatetaan joutua ohjaamaan jonkin filtterin lpi ennen
tulostamista.
.TP
.B \-\^w \fRtai\fP \-\-path
l nyt man-sivuja, mutta nyt sijainnit sivuille, jotka
muotoiltaisiin tai nytettisiin.  Jos mitn 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
mitn listietoja.  Tm on hydyllinen komennoissa, kuten
.ft CW
.B "man -aW man | xargs ls -l"
.ft

.SH CAT-SIVUT
Man yritt tallentaa muotoillut man-sivut sstkseen
muotoiluun kuluneen ajan seuraavalla kerralla, kun nit
sivuja tarvitaan.  Perinteisesti muotoillut sivut .../manX:st
on tallennettu .../catX:n (... on hakupolku), mutta 
.BR @man_config_file@ ":issa"
voidaan st jokin muu hakemistosijoittelu.
Jos tarvittavaa cat-hakemistoa ei lydy, ei cat-sivuja tallenneta.
.PP
On mahdollista asettaa
.BR man "in"
suid:ksi kyttj man.  Jos man omistaa cat-hakemiston, jonka
kyttoikeudet ovat 0755 (vain man-kyttjn
kirjoitettavissa) ja cat-tiedostojen kyttoikeudet ovat 0644 tai 0444
(vain man-kyttjn
tai ei kenenkn kirjoitettavissa), ei tavallinen kyttj voi
muuttaa cat-sivuja tai laittaa muita tiedostoja cat-hakemistoon.
Jos
.BR man "ille"
ei ole mritelty suidia, silloin cat-hakemiston
kyttoikeuksien pitisi olla 0777,
jolloin jokainen kyttj voisi jtt cat-sivuja sinne.
.PP
Optio
.B \-c
pakottaa muotoilemaan sivun uudelleen, vaikka uusi cat-sivu lytyisikin.
.SH YMPRISTMUUTTUJAT
.TP
.B MANPATH
Jos
.B MANPATH
on asetettu, sen arvoa kytetn polkuna man-sivuja etsittess.
.TP
.B MANROFFSEQ
Jos
.B MANROFFSEQ
on asetettu, sen arvoa kytetn mrittelemn esiksittelijt,
jotka ajetaan ennen
.BR nroff "ia"
tai
.BR troff "ia."
Oletuksena sivut ajetaan
tbl(1)-esiksittelijn lpi ennen
.BR nroff "ia."
.TP
.B MANSECT
Jos
.B MANSECT
on asetettu, sen arvoa kytetn mrittelemn, mist sektioista
sivuja etsitn.
.TP
.B MANWIDTH
Jos
.B MANWIDTH
on asetettu, sen arvo kertoo leveyden, jolla sivut nytetn ruudulla.
Muuten sivut nytetn koko ruudun levyisin.
.TP
.B MANPAGER
Jos
.B MANPAGER
on asetettu, sen arvo kertoo ohjelman nimen, jota kytetn man-sivujen
esittmiseen.  Muuten kytetn ympristmuuttujaa
.BR PAGER .
Jos sitkn ei ole asetettu, kytetn komentoa
.BR @pager@ .
.TP
.B LANG
Jos
.B LANG
on asetettu, sen arvo mrittelee alihakemiston nimen, mist
man etsii ensin sivuja.  Niinp komento 'LANG=fi man 1 foo'
saa manin etsimn ensin sivua .../fi/man1/foo.1.
Jos tt ei lydy, etsii man sivua .../man1/foo.1.
Merkit ... tarkoittavat hakupolkua.
.TP
.B "NLSPATH, LC_MESSAGES, LANG"
Ympristmuuttujat
.B NLSPATH
ja
.B LC_MESSAGES
(tai
.BR LANG ,
jos jlkimmist ei ole asetettu) kertovat kytettvn viestikirjaston.
(Englanninkieliset viestit on knnetty ohjelman sisn,
joten ne eivt tarvitse erillist viestikirjastoa.)
Huomaa, ett man saattaa kytt ohjelmia, kuten col(1), jotka
kyttvt mys esimerkiksi muuttujaa LC_CTYPE.
.TP
.B PATH
.BR PATH ":ia"
kytetn muodostamaan oletushakupolkua man-sivuille.
.TP
.B SYSTEM
.B SYSTEM "-ympristmuuttujaa"
kytetn vaihtoehtoisen jrjestelmn oletusnimeksi (optiota
.B \-m
kytettess).
.SH BUGIT
Optio
.B \-t
toimii vain, jos troffin kaltainen ohjelma on asennettu.
.br
Jos net tavuviivojen tilalla vilkkuvan \e255:n tai <AD>:n,
aseta ympristmuuttuja 'LESSCHARSET=latin1'.
.SH "KATSO MYS"
apropos(1) whatis(1) less(1) groff(1).