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 ykhtä 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 tiedosotoa, 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, 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] on annettu, tiedostonimi otetaan "errors.vim" muissa järjestelmissä). Further errors can be jumped to with the ":cn" command. Katso ":help quickfix".

Vim käyttäytyy eritavalla, 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" mahdollisista hakuavaruuksista.

+{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. Muutamati valitsimet asetetaan, että binääritiedoston tai suoritettavan ohjelman muokkimen olisi mahdollista.

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

-d {laite}
    Avaa {laite}:en 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. has been compiled with GUI support, this option enables the GUI. Jos GUI-tukea ei ole käännetty mukaan, virheilmoitus annetaan ja Vim keskeyttää.

-h  Antaa lyhyen avustuksen 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 oletus "~/.viminfo" 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 palautus tilastojen kanssa.

-r {file}
    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 {scriptin}
    Skriptitiedosto {scriptin} luetaan. Tiedostossa olevat merkit tulkitaan aivan kuin olisit kirjoittanut ne. Sama voidaan tehdä komennolla ":source! {scriptin}". Jos tiedoston loppu saavutetaan ennenkuin editori suljetaan, lisää merkkejä luetaan näppäimistöltä.

-T {terminal}
    Kertoo Vim :lle terminaalin nimen, jota käytät. Tätä tarvitaan ainoastaan, kun automaattinen tapa ei toimi. Pitäisi olla Vim :n tuntema terminaali (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 ":help initialization" vimmissä tarkemmista yksityiskohdista.

-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 ":help gui_init" vimmissä tarkemmista yksityiskohdista.

-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.

ON-LINE HELP
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ää <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 etä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 eritavalla". Heidän pitäisi lukea ajatuksella vi_diff.txt-tiedosto (tai kirjoittaa :help vi_diff.txt Vimmissä). Kaso myös 'compatible' (yhteensopivuus) valitsinta.