vim

VIM(1)                     Käyttäjän sovellusohjelmat                     VIM(1)



NIMI
       vim - Vi IMproved, ohjelmoijan tekstieditori

YLEISKATSAUS
       vim [valitsimet] [tiedosto ..]
       vim [valitsimet] -
       vim [valitsimet] -t tagi
       vim [valitsimet] -q [virhetiedosto]

       ex
       view
       gvim gview
       rvim rview rgvim rgview

KUVAUS
       Vim on tekstieditori, joka on ylöspäin yhteensopiva Vi:n kanssa.  Sitä
       voidaan käyttää muokkaamaan mitä tahansa ASCII-tekstiä.  Se on erityisen
       hyödyllinen ohjelmien muokkauksessa.

       Useita parannuksia on tehty verrattuna Vi:hin: usean tason kumous, monta
       ikkunaa ja puskuria, syntaksin väritys, komentorivimuokkaus,
       tiedostonimien täydennys, pika-apu, visuaalinen valinta jne.  Katso
       ":help vi_diff", jos tarvitset tiivistelmää Vim:n ja Vi:n eroista.

       Vim:ssä löydät apua pika-apujärjestelmästä, komento ":help".  Katso ON-
       LINE HELP kohta alempana.

       Useinmiten Vim käynnistetään muokkaamaan yhtä tiedostoa komennolla:

            vim tiedosto

       Yleisesti Vim käynnistetään komennolla:

            vim [valitsimet] [tiedostolista]

       Jos tiedostolista puuttuu, editori tekee tyhjän puskurin.  Muissa
       tapauksissa tarkalleen yhtä tapaa seuraavista neljästä voidaan käyttää
       valitsemaan muokattavat tiedostot.

       tiedosto .. lista tiedostonimistä.  Alussa ensimmäisenä annettu tiedosto
                   luetaan puskuriin muokattavaksi.  Kursori asetetaan puskurin
                   ensimmäiselle riville.  Pääset muokkaamaan muita tiedostoja
                   ":next"-komennolla.  Muokataksesi tiedostoa, jonka nimi alkaa
                   viivalla, aloita tiedostolista "--":lla.

       -           Tiedosto, joka luetaan vakiosyötteestä. Komennot luetaan
                   vakiovirheestä, jonka pitää olla tty.

       -t {tag}    Muokkattava tiedosto ja kursorin paikka riippuu "tag"ista,
                   joka on jonkinlainen hyppy johonkin merkkiin.  {tag} etsitään
                   tagitiedostosta, yhteenkuuluva tiedosto tulee tämänhetkiseksi
                   tiedostoksi ja yhteenkuuluvat komennot suoritetaan.
                   Enimmäkseen tämä on käytössä C-ohjelmissa, sillä tässä
                   tapauksessa {tag} voi olla funktion nimi.  Vaikutus on, että
                   tiedosto, joka sisältää funktion, tulee tämänhetkiseksi
                   tiedostoksi ja kursori asetetaan funktion alkuun.  Katso
                   ":help tag_commands".

       -q [virhetiedosto]
                   Aloita pikakorjausmoodissa.  Tiedosto [virhetiedosto] luetaan
                   ja ensimmäinen virhe näytetään.  Jos [virhetiedosto] ei ole
                   annettu, tiedostonimi otetaan 'virhetiedosto'-valitsimesta
                   (oletuksena "AztecC.Err" Amigoissa, "errors.vim" muissa
                   järjestelmissä).  Seuraaviin virheisiin voidaan hypätä
                   ":cn"-komennolla.  Katso ":help quickfix".

       Vim käyttäytyy eri tavoin, riippuen komennon nimestä (ohjelman nimi voi
       olla silti sama).

       vim       "Normaali" tapa, kaikki on oletusarvoissansa.

       ex        Käynnistyy Ex-tilassa.  Mene normaalitilaan ":vi"-komennolla.
                 Voidaan tehdä myös "-e"-parametrilla.

       view      Käynnistä ainoastaan lukutilassa. Sinua estetään kirjoittamasta
                 tiedostoon.  Sama vaikutus saadaan myös käynnistämällä
                 valitsimen "-R" kanssa.

       gvim gview
                 GUI-versio.  Tekee uuden ikkunan.  Voidaan myös tehdä
                 "-g"-parametrillä.

       rvim rview rgvim rgview
                 Kuten yllä, mutta muutamin rajoituksin. Ei ole mahdollista
                 käynnistää komentotulkkikomentoja taikka siirtää Vimiä
                 taustalle.  Voidaan myös tehdä "-Z"-parametrilla.

OPTIOT
       Valitsimet voidaan antaa missä tahansa järjestyksessä, ennen tai jälkeen
       tiedostonimien.  Valitsimet ilman parametriä voidaan muodostaa yhden
       viivan perään.

       +[num]      Ensimmäistä tiedostoa avattaessa kursori siirretään riville
                   "num".  Jos "num" puuttuu, kursori siirretään viimeiselle
                   riville.

       +/{pat}     Ensimmäisessä tiedostossa kursori asetetaan ensimmäisen
                   {pat}:n esiintymiskohtaan.  Katso ":help search_pattern"
                   saadaksesi tietoja mahdollisista hakukuvioista.

       +{komento}

       -c {komento}
                   {komento} suoritetaan heti, kun ensimmäinen tiedosto on
                   luettu.  {command} tulkitaan kuten Ex-komento.  Jos {komento}
                   sisältää välilyöntejä, sen täytyy olla lainausmerkkien
                   ympäröimä (tämä riippuu käytettävästä komentotulkista).
                   Esimerkki: Vim "+set si" main.c
                   Huomaa: Voit käyttää korkeintaan 10 "+"- tai "-c"-komentoa.

       -b          Binääritila.  Muutamat valitsimet asetetaan, että
                   binääritiedoston tai suoritettavan ohjelman muokkaaminen
                   olisi mahdollista.

       -C          Yhteensopivuus. Asetetaan 'compatible'-valitsin.  Tämä
                   laittaa Vim:n toimimaan enimmäkseen Vi:n tavoin, vaikka
                   .vimrc olisikin olemassa.

       -d {laite}  Avaa {laite} käytettäväksi päätteenä.  Ainoastaan Amigalle.
                   Esimerkki: "-d con:20/30/600/150".

       -e          Käynnistää Vim:n Ex-moodissa, aivan kuten "ex"-ohjelma.

       -f          Edustalle. GUI-versiolle: Vim ei haaraudu tai mene taustalle
                   komentotulkista, jossa se käynnistettiin.  Amigoissa: Vim ei
                   uudelleenkäynnisty avatakseen uutta ikkunaa.  Tätä valitsinta
                   pitäisi käyttää, kun Vim on käynnistetty ohjelmasta, joka
                   odottaa muokkauksen lopetusta ennen (esim.  mail).  Amigassa
                   komennot ":sh" ja ":!" eivät toimi.

       -F          Jos Vim on käännetty FKMAP-tuella oikealta-vasemmalle-
                   kirjoitettujen tiedostojen muokkaukseen ja Farsi-
                   näppäimistöasettelulla, tämä valitsin käynnistää Vim:n
                   Farsitilassa, siis 'fkmap' ja 'rightleft' on asetettuja.
                   Muulloin tulostetaan virheilmoitus ja Vim keskeyttää.

       -g          Jos Vim on käännetty GUI-tuella, tämä valitsin lisää GUIn.
                   Jos GUI-tukea ei ole käännetty mukaan, virheilmoitus annetaan
                   ja Vim keskeyttää.

       -h          Antaa lyhyen ohjeen komentoriviparametreistä ja
                   -valitsimista.  Sen jälkeen Vim:stä poistutaan.

       -H          Jos Vim on käännetty RIGHTLEFT-tuella, oikealta-vasemmalle-
                   kirjoitettujen tiedostojen tuella ja heprealaisella
                   näppäimistöasettelulla, tämä valitsin käynnistää Vim:n
                   heprealaistilassa, siis 'hkmap' ja 'rightleft' asetetaan.
                   Muulloin tulostetaan virheilmoitus ja Vim keskeyttää.

       -i {viminfo}
                   Kun viminfo-tiedoston käyttö on päällä, tämä valitsin asettaa
                   käytettävän tiedostonimen oletuksena olevan
                   "~/.viminfo"-tiedoston tilalle.  Tätä voidaan käyttää
                   ohittamaan .viminfo-tiedoston käyttö antamalla nimeksi
                   "NONE".

       -L          Sama kuin -r.

       -l          Lisp-moodi.  Asettaa 'lisp'- ja 'showmatch'-valitsimet
                   päälle.

       -N          Epäyhteensopivuusmoodi. Nollaa 'compatible'-valitsimen.  Tämä
                   tekee Vim:stä" hiukan paremman, mutta vähemmän Vi-
                   yhteensopivan, vaikka .vimrc tiedosto ei olisikaan olemassa

       -n          Heittovaihtotiedostoa ei käytetä.  Palautus kaatumisen
                   jälkeen on mahdotonta.  Kätevä, jos haluat muokata tiedostoa,
                   joka sijaitsee hitaalla medialla (vaikkapa levyke).  Voit
                   myös käyttää komentoa ":set uc=0".  Voidaan palauttaa
                   komennolla ":set uc=200".

       -o[N]       Avaa N ikkunaa.  Kun N on annettu, avataan yksi ikkuna
                   jokaiselle tiedostolle.

       -R          Ainoastaan-luku-moodi.  Voit edelleen muokata puskuria, mutta
                   sinua estetään äkkinäisesti ylikirjoittamasta tiedostoa.  Jos
                   haluat ylikirjoittaa tiedoston, lisää huutomerkki Ex-
                   komentoon, ":w!".  Valitsimesta -R seuraa myös valitsin -n
                   (katso alla).  Katso ":help 'readonly'".

       -r          Listaa heittovaihtotiedostot palautustilastojen kanssa.

       -r {tiedosto}
                   Palautustila.  Heittovaihtotiedostoa käytetään palauttamaan
                   keskeytynyt muokkausistunto.  Heittovaihtotiedosto on
                   tiedosto, jonka tiedostonimen perään on lisätty ".swp".
                   Katso ":help recovery".

       -s          Hiljainen tila. Ainoastaan, kun käynnistetty "Ex":nä tai, kun
                   "-e"-parametri annettiin ennen "-s"-parametria.

       -s {skripti}
                   Skriptitiedosto {skripti} luetaan.  Tiedostossa olevat merkit
                   tulkitaan aivan kuin olisit kirjoittanut ne.  Sama voidaan
                   tehdä komennolla ":source! {skripti}".  Jos tiedoston loppu
                   saavutetaan ennen kuin editori suljetaan, lisää merkkejä
                   luetaan näppäimistöltä.

       -T {terminal}
                   Kertoo Vim:lle päätteen nimen, jota käytät.  Tätä tarvitaan
                   ainoastaan, kun automaattinen tapa ei toimi.  Päätteen
                   pitäisi olla Vim:n tuntema päätetyyppi (builtin) tai termcap-
                   tai terminfo-tiedostossa määritelty.

       -u {vimrc}  Käyttää {vimrc}-tiedoston komentoja alustuksiin.  Kaikki muut
                   alustukset ohitetaan.  Käytä tätä muokataksesi erikoisempia
                   tiedostoja.  Voidaan myös ohittaa kaikki alustukset antamalla
                   tiedostonimeksi "NONE".  Katso komennolla ":help
                   initialization" vimmissä tarkemmat yksityiskohdat.

       -U {gvimrc} Käytä {gvimrc}-tiedoston komentoja GUI-alustuksiin.  Kaikki
                   muut GUI-alustukset ohitetaan.  Voidaan myös ohittaa kaikki
                   GUI-alustukset antamalla tiedostonimeksi "NONE".  Katso
                   komennolla ":help gui_init" vimmissä tarkemmat
                   yksityiskohdat.

       -V          Informatiivinen. Antaa viestejä tiedostoista, jotka ovat
                   lähteenä ja viminfo tiedostoon/tiedostosta kirjoittamisesta
                   ja lukemisesta.

       -v          Käynnistää Vim:n Vi-moodissa, kuten ohjelma nimeltä "vi".
                   Tällä on vaikutusta ainoastaan, kun ohjelman nimi on "ex".

       -w {scriptout}
                   Kaikki merkit, jotka kirjoitat tallennetaan tiedostoon
                   {scriptout}, kunnes suljet Vim:n.  Tämä on kätevä, jos haluat
                   tehdä skriptitiedoston, jota käytetään "vim -s"-komennolla
                   tai ":source!"-komennolla.  Jos {scriptout} tiedosto on jo
                   olemassa, merkit lisätään tiedoston loppuun.

       -W {scriptout}
                   Kuten -w, mutta ennestään olemassa olevat tiedostot
                   ylikirjoitetaan.

       -x          Salattu suodatin tiedostojen lukemiseen ja kirjoittamiseen.
                   Tätä ei ole vielä toteutettu.

       -Z          Rajoittunut tila. Toimii kuten ohjelma "r".

       --          Tarkoittaa valitsimien loppumista.  Parametrit tämän jälkeen
                   käsitellään tiedostoniminä.  Tätä voidaan käyttää '-':lla
                   alkavien tiedostonimien muokkaamiseen.

AJONAIKAISET OHJEET
       Kirjoita ":help" Vim:ssä päästäksesi alkuun.  Kirjoita ":help aihe"
       saadaksesi apua tietystä aiheesta.  Esimerkkinä: ":help ZZ" antaa apua
       "ZZ"-komennosta. Voit käyttää näppäimiä <Tab> ja CTRL-D täydentääksesi
       aiheita (":help komentorivitäydennys"). Esiintyviä tageja voidaan käyttää
       hyppäämään paikasta toiseen (jonkinlaisia hypertekstilinkkejä, katso
       ":help"). Kaikkia ohjetiedostoja voidaan katsoa tällä tavalla,
       esimerkiksi ":help syntax.txt".

TIEDOSTOT
       /usr/doc/vim/*.txt.gz
                      Vim:n ohjetiedostot. Kirjoita ":help doc-file-list"
                      saadaksesi täydellisen listan.

       /usr/doc/vim/tags
                      Tagitiedostot, joita käytetään etsimään tietoa
                      ohjetiedostoista.

       /etc/vimrc     Koko järjestelmää koskevat Vim:n alustukset.

       /etc/gvimrc    Koko järjestelmää koskevat gim-alustukset.

       /etc/menu.vim  Koko järjestelmää koskevat menualustukset gvimmille.

       /usr/lib/vim/syntax/syntax.vim
                      Koko järjestelmää koskevat kielioppialustukset.

       /usr/lib/vim/syntax/*.vim
                      Kielioppitiedostot useille kielille.

       Uudempaa tietoa löytyy VIM:n kotisivulta:
       <URL:http://www.vim.org/>

TEKIJÄ
       Suurimman osan Vim:stä on tehnyt Bram Moolenaar, saaden kuitenkin apua
       muilta.  Katso ":help credits".
       Vim perustuu Stevieen, jonka tekijät ovat Tim Thompson, Tony Andrews ja
       G.R. (Fred) Walter. Alkuperäistä koodia tuskin on yhtään jäljellä.

BUGIT
       Todennäköisesti niitä on.  Katso "todo"-tiedosto, joka tulee
       jakelupaketin mukana.

       Huomaa, että useat asiat, jotka voivat olla bugeja joidenkin mielestä,
       ovat todellisuudessa liian tuskaisia toteuttaa kuten Vi:ssä.  Ihmiset
       voivat luulla, että jotkut asiat ovat bugeja, "koska Vi toimii eri
       tavalla". Heidän pitäisi lukea ajatuksella vi_diff.txt-tiedosto (tai
       kirjoittaa :help vi_diff.txt Vimmissä). Katso myös 'compatible'
       (yhteensopivuus) -valitsinta.



                               19. Helmikuuta 1998                        VIM(1)