
Tervetuloa kyttmn Ionia!

Jos et ole kyttnyt Ionia aiemmin, on hyvin suotiteltavaa, ett opiskelet
Ionin ohjesivun ennen kuin jatkat tt pidemmlle. Se on toistettu alla,
mutta voit aukaista sen mys myhemmin painamalla <F1> ja <Enter>, tai
suorittamalla 'man ion3' komentorivilt. (Tm toimii sill oletuksella,
ett olet asentanut Ionin jrjestelmsssi sellaiseen vakiosijaintin, 
mist sen tykalut osaavat hakea ohjesivuja.)

Jos olet innokas kokeilemaan Ionia nyt heti ja vastoin suosituksia haluat
jtt ohjesivun lukematta tll istumalla, sinun tulisi kuitenkin tiet
ainakin seuraavat nppimet: <F2> kynnist pte-emulaattorin (xterm)
ja <F12> nytt pvalikon.

Jossain vaiheessa, opeteltuasi Ionin perusksitteet ja toiminnot, haluat
varmaan muokata sen asetukset itsellesi sopivammiksi. Thn lydt apua
(englanniksi) Ionin asetus- ja ohjelmointimanuaalista. Se lytyy ainakin
Ionin seittisivulta, johon on linkki alla olevan ohjesivun lopussa.
Huomautettakoon viel, ett Ionin kytn ja perusksitteiden opettelu
on hyvin suositeltvaa ennen asetustiedostojen pariin hyppmist.

---- Ohjesivu seuraa ----


ION(1)                                                                  ION(1)



NIMI
       Ion - X11 ikkunanhallintaohjelma

SELOSTE
       ion3 [valinnat]

KUVAUS
       Ion  on  nppimistkyttji silmllpiten suunniteltu laatoitusta ja
       vlilehti hydyntv ikkunanhallintaohjelma X11:lle.


VALINNAT
       -display kone:palvelin.nytt
              X palvelin, johon ottaa yhteys.

       -conffile asetustiedosto
              Kytettv asetustiedosto.

       -searchdir dir
              Hakupolkuun listtv hakemisto, josta lytyy asetus-  ja  muita
              tiedostoja.

       -oneroot
              Hallitse  vain  oletusnytt  X-palvelimilla, joissa on useampi
              perinteinen  (ei  Xinerama)  nytt/juuri-ikkuna.  Tm   nytt
              voidaan  valita -display parametrill tai DISPLAY ympristmuut-
              tujalla.

       -session session_name
              Istunnon nimi. Tm vaikuttaa talletustiedostojen sijaintiin.

       -xinerama 0|1
              Jos Ion  knnettiin  Xinerama-tuella,  voidaan  Xinerama  tieto
              silti jtt hydyntmtt  asettamalla tm valinta arvoon 0.

       -help  Nyt komentorivin ohje.

       -version
              Nyt Ionin versio.

       -about Nyt tietoja Ionista (versio, tekijnoikeudet).


PERUSKSITTEET
       Tm  kappale  on  katsaus erilaisiin niin kutsuttuihin olioihin, joita
       ilmenee Ionin hallitsemalla X-nytll,  ja  niiden  suhteisiin  taval-
       lisessa kokoonpanossa. Sinun tarvitse ymmrt nm suhteet tietksesi
       milloin   mitkkin    alempana    kuvattavat    nppinsidonnat    ovat
       kytettvisssi.  Jos  kaipaat  viel  tarkempaa  kuvausta, esimerkiksi
       tehdksesi omat asetustiedostot,  katso  Ionin  seittisivulta  saatavaa
       yksityiskohtaisempaa  dokumentaatiota.

       Ylimmn tason olioita, joilla on merkityst tss yhteydess, kutsutaan
       nytiksi. Ne vastaavat fyysisi nyttj. Nytt sisltvt  typyti
       ja   kokoruudun   tilassa  olevia  asiakasikkunoita.  Nm  oliot  ovat
       lomitettu siten, ett vain yksi voi nky kerrallaan.

       Ion tukee tll hetkell kahdentyyppisi typyti: laatoittavia  Ionin
       perinteiseen tapaan ja tavanomaisempia kelluvia typyti PWM:n tapaan.
       Typydt  eivt  ole   nkyvi   olioita,   vaan   lhinn   kokoelmia
       samanaikaisesti nytettvi kehyksi.

       Nyttjen tapaan kehykset lomittavat muita olioita, mutta tss tapauk-
       sessa lhinn asiakasikkunoita. Kehykset  ovat  suurimman  osan  ajasta
       ainut  asia,  mink  net Ionista. Niill voi olla reunakoristukset, ja
       lisksi kehyksiss on vlilehti jokaiselle lomitetulle oliolle.

       Kyselyt ovat nyttjen  tai  kehysten  alaosiin  imestyvi  laatikoita,
       jotka  odottavat sinulta tekstin sytt jonkin siit riippuvan toimin-
       non suorittamiseksi. Useimmat kyselyt tukevat tab-tydennyst.



SIDONNAT
       Nm ovat oletusarvoiset nppin- ja osoitinsidonnat.  Nppinmuunninta
       (Mod1)  vastaava  nppin  riippuu  jrjestelmstsi. PC-tietokoneilla,
       joissa on XFree86 se  on  todennkisesti  vasen  Alt-nppin  (Alt_L).
       Suneilla  se  on luultavasti sidottu timanttinppimiin. Kyt komentoa
       xmodmap(1x) selvittksesi asian tarkemmin.

       Otsikkojen perss hakasuluissa oleva  merkkijono  ilmoittaa  moduulin,
       jonka asetustiedosto mrittelee alla olevat sidonnat.


   Yleisesti saatavilla olevat sidonnat
       Mod1+1, Mod1+2, Mod1+3, Mod1+4, Mod1+5, Mod1+6, Mod1+7, Mod1+8, Mod1+9,
       Mod1+0
              Siirry n:teen tmnhetkisen nytn lomittamaan olioon (typyt,
              kokoruudun asiakasikkuna).

       Mod1+comma, Mod1+period
              Siirry seuraavaan/edelliseen  tmnhetkisen  nytn  lomittamaan
              olioon.

       Mod1+K K
              Mene edelliseen aktiiviseen olioon.

       Mod1+K T
              Poista kaikki merkinnt.

       Mod1+Shift+1, Mod1+Shift+2
              Siirry nytlle n usean nytn jrjestelmss.

       Mod1+Shift+comma, Mod1+Shift+period
              Mene     seuraavalle/edelliselle     nytlle    usean    nytn
              jrjestelmss.

       Mod1+F9
              Luo uusi typyt ennalta asetettua tyyppi.

       F12, Button3 painallus
              Nyt pvalikko.

       Button2 painallus
              Nyt ikkunavalikko.




       Mod1+C Sulje aktiivinen olio.

       Mod1+L Tnise aktiivista asiakasikkunaa. Tm saattaa auttaa joidenkin
              ohjelmien koko-ongelmien kanssa.

       Mod1+Return
              Kytke aktiivisen asiakasikkunan kokoruudun tila plle/pois.

       Mod1+K C
              Tapa aktiivisen asiakasikkunan omistava ohjelma.

       Mod1+K Q
              Lhet  seuraava nppinpainallus aktiiviselle asiakasikkunalle.
              Kaikki ohjelmat eivt vlttmtt salli tt oletuksena.

       F1     Kysy ohjesivua nytettvksi.

       Mod1+F1
              Nyt Ionin ohjesivu.

       F2     Kynnist pte-emulaattori.

       F3     Kysy komentorivi suoritettavaksi.

       Mod1+F3
              Kysy Lua-koodia ajettavaksi.

       F4     Ota SSH-yhteys kyseltvn koneeseen.

       F5     Kysy tiedostoa muokattavaksi.

       F6     Kysy tiedostoa nytettvksi.

       F9     Kysy typyt jolle siirty, tai luo uusi.

       Mod1+G Kysy asiakasikkunaa, johon siirty.



   Kehyksi, sek niiden lapsia ksittelevt sidonnat
       Mod1+T Merkitse kehyksen tll hetkell nyttm olio.

       Mod1+K 1, Mod1+K 2, Mod1+K 3, Mod1+K 4, Mod1+K 5, Mod1+K 6,  Mod1+K  7,
       Mod1+K 8, Mod1+K 9, Mod1+K 0
              Siirry n:teen kehyksen jakavaan olioon.

       Mod1+K N, Mod1+K P
              Siirry seuraavaan/edelliseen kehyksen jakavaan olioon.

       Mod1+K comma, Mod1+K period
              Siirr  kehyksess  tll  hetkell  nytettv  oliota  vasem-
              malle/oikealle.

       Mod1+K H, Mod1+K V
              Maksimoi kehys vaaka/pystysuunnassa.

       Mod1+K A
              Liit merkityt oliot thn kehykseen.

       Mod1+A Kysy asiakasikkunaa liitettvksi kehykseen.

       Mod1+M, Button3 painallus
              Nyt kehyksen kontekstivalikko.

       Mod1+R Aloita siirto ja koonmuutostila.

       Button1 napsautus osassa tab, Button2 napsautus osassa tab
              Vaihda kehys nyttmn vlilehden ilmoittama olio.

       Button1 raahaus osassa border, Mod1+Button3 raahaus
              Muuta kehyksen kokoa.

       Mod1+Button1 raahaus
              Siirr kehyst.

       Button1 raahaus osassa tab, Button2 raahaus osassa tab
              Siirr  olioita  kehysten  vlill  raahaamalla  ja pudottamalla
              vlilehti.



   Siirto ja koonmuutostilan sidonnat
       Escape Peruuta tilasta.

       Return Siirry tilasta pois.

       Left, Right, Up, Down, F, B, P, N
              Kasvata vastaavaan suuntaan.

       Shift+Left,  Shift+Right,  Shift+Up,  Shift+Down,   Shift+F,   Shift+B,
       Shift+P, Shift+N
              Kutista vastaavaan suuntaan.

       Mod1+Left, Mod1+Right,  Mod1+Up,  Mod1+Down,  Mod1+F,  Mod1+B,  Mod1+P,
       Mod1+N
              Liiku vastaavaan suuntaan.



   Laatoitettavien typytien sidonnat [mod_ionws]
       Mod1+S Halkaise tmnhetkinen kehys pystysuunnassa.

       Mod1+P, Mod1+N, Mod1+Tab, Mod1+K Tab
              Siirry tmnhetkisen kehyksen yll/alla/vasemmalle/oikealla ole-
              vaan kehykseen.

       Mod1+K S
              Halkaise tmnhetkinen kehys vaakasuunnassa.

       Mod1+K X
              Tuhoa tmnhetkinen kehys.



   Kelluvien typytien ja kehyksien sidonnat [mod_floatws]
       Mod1+Tab
              Kierrt fokusta ja nosta uudelleen fokusoitu kehys.

       Mod1+K Tab
              Kierrt fokusta taaksepin ja nosta fokusoitu kehys.

       Mod1+P, Mod1+N
              Nosta/alenna aktiivinen kehys.



       Button1 kaksoisnapsautus osassa tab
              Kytke litistys plle/pois.

       Button1   painallus   osassa  tab,  Button1  painallus  osassa  border,
       Mod1+Button1 napsautus
              Nosta kehys.

       Mod1+Button3 napsautus
              Alenna kehyst.

       Button1 raahaus osassa tab
              Siirr kehyst.



   Kysely- ja viestilaatikoiden sidonnat [mod_query]
       Escape, Control+G, Control+C
              Sulje kysely/viesti suorittamatta sidottuja toimintoja.

       Control+U, Control+V, Page_Up, Page_Down
              Vierit viesti tai tydennyksi yls/alas.



   Sidonnat tekstinmuokkaukseen kyselyiss [mod_query]
       Nm   nppinsidonnat   vastaavat   tekstieditorin  joe(1)  sidontoja.
       Leikkaus ja liimaus toimii kuitenkin tavanomaisemmin, joskin  nppimet
       ovat vastaavat.


       Control+F, Control+B, Right, Left
              Siirry yksi merkki eteen/taakse.

       Control+E, Control+A, End, Home
              Mene rivin alkuun/loppuun.

       Control+X, Control+Z
              Ohita yksi sana eteen/taaksepin

       Control+D, Delete
              Poista seuraava merkki.

       BackSpace, Control+H
              Tuhoa edellinen merkki.

       Control+W, Control+O
              Tuhoa yksi sana eteen/taakse.

       Control+J
              Tuhoa merkit rivin loppuun saakka.

       Control+Y
              Tuhoa koko rivi.

       Control+P, Control+N, Up, Down, Control+Up, Control+Down
              Nyt seuraava/edellinen vastaus muistista.

       Button2 napsautus, Control+K C
              Liimaa teksti leikelaudalta.

       Control+K B
              Aloita tekstin valinta.

       Control+K Y
              Leikkaa valittu teksti.

       Control+K K
              Kopioi valittu teksti.

       Control+K G
              Lopeta tekstin valinta.

       Tab, Control+Tab, Shift+Tab
              Yrit tydent sytetty teksti tai selaa tydennyksi.

       Control+M, Return, KP_Enter
              Sulje kysely ja suorita sidottu toiminta.



   Valikoiden sidonnat [mod_menu]
       Escape, Control+G, Control+C, Left
              Sulje valikko.

       Return, KP_Enter, Control+M, Right
              Suorita valinta.

       Control+N, Control+P, Up, Down
              Siirry seuraavaan/edelliseen valintaan.

       BackSpace
              Tyhj valikon hakupuskuri.




TIEDOSTOT JA HAKEMISTOT
       /usr/pkg/etc/ion3/cfg_ion.lua
              Jrjestelmn oletusarvoinen pasetustiedosto.

       /usr/pkg/etc/ion3/cfg_*.lua
              Muita asetustiedostoja.

       /usr/pkg/etc/ion3/look_*.lua
              Ulkonn asetustiedostoja.

       ~/.ion3/
              Kyttjn asetustiedostot.

       ~/.ion3/cfg_ion.lua
              Kyttjn oletusarvoinen pasetustiedosto.


KATSO MYS
       Ionin kotisivu, http://iki.fi/tuomov/ion/ (englanniksi).

       Dokumentti  "Ion:  Configuring  and  extending  with Lua" (englanniksi)
       nhtviss Ionin kotisivulla.

       /usr/pkg/share/doc/ion3/

       X(7x), pwm3(1), joe(1)


TEKIJ
       Ionin on kirjoittanut Tuomo Valkonen <tuomov at iki.fi>.



                                                                        ION(1)
