.TH VIM 1 "11. april 2006" .SH NAVN vim \- Vi IMproved, en programm�rs teksteditor .SH SYNOPSIS .br .B vim [tilvalg] [fil ..] .br .B vim [tilvalg] \- .br .B vim [tilvalg] \-t tag .br .B vim [tilvalg] \-q [fejlfil] .PP .br .B ex .br .B view .br .B gvim .B gview .B evim .B eview .br .B rvim .B rview .B rgvim .B rgview .SH BESKRIVELSE .B Vim er en teksteditor som er opad kompatibel med Vi. Den kan bruges til at redigere alle slags ren tekst. Den er s�rlig nyttig til at redigere programmer. .PP Der er mange forbedringer over Vi: multiniveau fortryd, multivinduer og -buffere, syntaksfremh�vning, redigering af kommandolinje, fuldf�relse af filnavn, onlinehj�lp, visuel markering, osv. Se ":help vi_diff.txt" for et overblik over forskellene mellem .B Vim og Vi. .PP Mens .B Vim k�rer, kan der indhentes massere af hj�lp fra online-hj�lpesystemet, med ":help"-kommandoen. Se ONLINEHJ�LP-sektionen nedenfor. .PP Oftest startes .B Vim for at redigere en enkelt fil med kommandoen .PP vim fil .PP Mere generelt startes .B Vim med: .PP vim [tilvalg] [filliste] .PP Hvis fillisten mangler, s� startes editoren med en tom buffer. Ellers kan �n af f�lgende fire m�der bruges til at v�lge en eller flere filer som skal redigeres. .TP 12 fil .. En liste over filnavne. Den f�rste bliver den nuv�rende fil og l�ses ind i bufferen. Mark�ren placeres p� den f�rste linje i bufferen. Du kan g� til de andre filer med ":next"-kommandoen. Skriv "\-\-" foran fillisten, for at redigere en fil som begynder med en bindestreg. .TP \- Filen som skal redigeres l�ses fra stdin. Kommandoer l�ses fra stderr, hvilket skal v�re en tty. .TP \-t {tag} Filen som skal redigeres og den indledende mark�rplacering afh�nger af et "tag", en slags g� til-etiket. {tag} opsl�s i tags-filen, den tilknyttede fil bliver den nuv�rende fil og den tilknyttede kommando udf�res. Det bruges mest til C-programmer, hvor {tag} kunne v�re et funktionsnavn. Virkningen er at filen som indeholder funktionen bliver den nuv�rende fil og mark�ren placeres i begyndelsen af funktionen. Se ":help tag\-commands". .TP \-q [fejlfil] Start i quickFix-tilstand. Filen [fejlfil] l�ses og den f�rste fejl vises. Hvis [fejlfil] udelades, s� indhentes filnavnet fra 'errorfile'-valgmuligheden (standard er "AztecC.Err" p� Amiga, "errors.err" p� andre systemer). Der kan hoppes til yderligere fejl med ":cn"-kommandoen. Se ":help quickfix". .PP .B Vim opf�rer sig anderledes, afh�ngig af navnet p� kommandoen (eksekverbaren kan stadig v�re den samme fil). .TP 10 vim Den "normale" m�de, alt er standard. .TP ex Start i Ex-tilstand. G� til normal tilstand med ":vi"-kommandoen. Det kan ogs� g�res med "\-e"-argumentet. .TP view Start i skrivebeskyttet tilstand. Du vil v�re beskyttet mod at skrive filerne. Det kan ogs� g�res med "\-R"-argumentet. .TP gvim gview GUI-versionen. Starter et nyt vindue. Det kan ogs� g�res med "\-g"-argumentet. .TP evim eview GUI-versionen i easy-tilstand. Starter et nyt vindue. Det kan ogs� g�res med "\-y"-argumentet. .TP rvim rview rgvim rgview Som dem ovenfor, men med restriktioner. Det vil ikke v�re muligt at starte skalkommandoer, eller at suspendere .B Vim\c \&. Det kan ogs� g�res med "\-Z"-argumentet. .SH TILVALG Tilvalgene kan gives i vilk�rlig r�kkef�lge, f�r eller efter filnavnene. Tilvalg uden et argument kan kombineres efter en enkelt bindestreg. .TP 12 +[nummer] Ved den f�rste fil, placeres mark�ren p� linje "nummer". Hvis "nummer" mangler, s� placeres mark�ren p� den sidste linje. .TP +/{sti} Ved den f�rste fil, placeres mark�ren p� linjen med den f�rste forekomst af {sti}. Se ":help search\-pattern" for tilg�ngelige s�gem�nstre. .TP +{kommando} .TP \-c {kommando} {kommando} udf�res efter den f�rste fil er blevet l�st. {kommando} fortolkes som en Ex-kommando. Hvis {kommando} indeholder mellemrum, s� skal den omsluttes af dobbelte citationstegn (det afh�nger af den skal der bruges). Eksempel: Vim "+set si" main.c .br Bem�rk: Du kan bruge op til 10 "+"- eller "\-c"-kommandoer. .TP \-S {fil} {fil} bliver sourced efter den f�rste fil er blevet l�st. Det svarer til \-c "source {fil}". {fil} m� ikke begynde med '\-'. Hvis {fil} udelades, s� bruges "Session.vim" (virker kun n�r \-S er det sidste argument). .TP \-\-cmd {kommando} Ligesom at bruge "\-c", men kommandoen udf�res lige inden behandlingen af vimrc-filer. Du kan bruge op til 10 af disse kommandoer, uafh�ngigt af "\-c"-kommandoer. .TP \-A Hvis .B Vim blev kompileret med underst�ttelse af ARABIC til redigering af filer som er orienteret h�jre mod venstre og arabisk tastaturlayout, s� starter tilvalget .B Vim i arabisk tilstand, dvs. 'arabic' s�ttes. Ellers gives en fejlmeddelelse og .B Vim afbrydes. .TP \-b Bin�r tilstand. Der s�ttes nogle f� valgmuligheder som g�r det muligt at redigere en bin�r eller eksekverbar fil. .TP \-C Kompatibel. S�t 'compatible'-valgmuligheden. Det f�r .B Vim til at opf�re sig mest som Vi, selvom der findes en .vimrc-fil. .TP \-d Start i diff-tilstand. Der skal v�re to, tre eller fire filnavneargumenter. .B Vim �bner alle filerne og viser forskellene mellem dem. Virker ligesom vimdiff(1). .TP \-d {enhed} �bn {enhed} til brug som en terminal. Kun p� Amiga. Eksempel: "\-d con:20/30/600/150". .TP \-D Fejlretning. G� til fejlretningstilstand n�r den f�rste kommando udf�res fra et script. .TP \-e Start .B Vim i Ex-tilstand, ligesom hvis "ex"-eksekverbaren blev kaldt. .TP \-E Start .B Vim i forbedret Ex-tilstand, ligesom hvis "exim"-eksekverbaren blev kaldt. .TP \-f Forgrund. I GUI-versionen, vil .B Vim ikke fork'e og frig�re fra skallen som den blev startet i. P� Amiga, genstartes .B Vim ikke for at �bne et nyt vindue. Tilvalget b�r bruges n�r .B Vim udf�res af et program der venter p� at redigeringssession bliver f�rdig (f.eks. mail). P� Amiga virker ":sh"- og ":!"-kommandoerne ikke. .TP \-\-nofork Forgrund. I GUI-versionen, vil .B Vim ikke fork'e og frig�re fra skallen som den blev startet i. .TP \-F Hvis .B Vim blev kompileret med underst�ttelse af FKMAP til redigering af filer som er orienteret h�jre mod venstre og persisk tastaturlayout, s� starter tilvalget .B Vim i persisk tilstand, dvs. 'fkmap' og 'rightleft' s�ttes. Ellers gives en fejlmeddelelse og .B Vim afbrydes. .TP \-g Hvis .B Vim blev kompileret med underst�ttelse af GUI, s� aktiveres GUI'en af denne valgmulighed. Hvis underst�ttelse af GUI ikke blev kompileret ind, s� gives en fejlmeddelelse og .B Vim afbrydes. .TP \-h Giv lidt hj�lp om kommandolinjeargumenterne og tilvalgene. Herefter afsluttes .B Vim\c \&. .TP \-H Hvis .B Vim blev kompileret med underst�ttelse af RIGHTLEFT til redigering af filer som er orienteret h�jre mod venstre og hebraisk tastaturlayout, s� starter tilvalget .B Vim i hebraisk tilstand, dvs. 'hkmap' og 'rightleft' s�ttes. Ellers gives en fejlmeddelelse og .B Vim afbrydes. .TP \-i {viminfo} N�r brug af viminfo-filen er aktiveret, s� s�tter tilvalget det filnavn som skal bruges, i stedet for standarden "~/.viminfo". Det kan ogs� bruges til at springe brugen af .viminfo-filen over, ved at give navnet "NONE". .TP \-L Samme som \-r. .TP \-l Lisp-tilstand. S�tter 'lisp'- og 'showmatch'-valgmulighederne til. .TP \-m �ndring af filer er deaktiveret. Nulstiller 'write'-valgmuligheden. Du kan stadig �ndre bufferen, men det er ikke muligt at skrive en fil. .TP \-M �ndringer tillades ikke. 'modifiable'- og 'write'-valgmulighederne fjernes, s� �ndringer ikke er tilladt og filer ikke kan skrives. Bem�rk at valgmulighederne kan s�ttes for at g�re det muligt at foretage �ndringer. .TP \-N No-compatible-tilstand. Nulstil 'compatible'-valgmuligheden. Det f�r .B Vim til at opf�re sig en smule bedre, men mindre Vi-kompatibel, selvom der ikke findes en .vimrc-fil. .TP \-n Der bruges ingen swap-fil. Det er umuligt at gendanne efter programmet er holdt op med at virke. God hvis du vil redigere en fil p� et meget langsomt medie (f.eks. floppy). Kan ogs� g�res med ":set uc=0". Kan fortrydes med ":set uc=200". .TP \-nb Bliv en editor-server til NetBeans. Se dokumentationen for detaljer. .TP \-o[N] �bn N vinduer stablet. N�r N udelades, s� �bnes �t vindue pr. fil. .TP \-O[N] �bn N vinduer side om side. N�r N udelades, s� �bnes �t vindue pr. fil. .TP \-p[N] �bn N fanebladssider. N�r N udelades, s� �bnes �n fanebladsside pr. fil. .TP \-R Skrivebeskyttet tilstand. \&'readonly'-valgmuligheden s�ttes. Du kan stadig redigere bufferen, men vil v�re forhindret i fejlagtigt at overskrive en fil. Hvis du vil overskrive en fil, s� tilf�j et udr�bstegn til Ex-kommandoen, som i ":w!". \-R-tilvalget indeb�rer ogs� \-n-tilvalget (se ovenfor). \&'readonly'-valgmuligheden kan sl�s fra med ":set noro". Se ":help 'readonly'". .TP \-r Oplist swap-filer, med information om at bruge dem til gendannelse. .TP \-r {fil} Gendannelsestilstand. Swap-filen bruges til at gendanne en redigeringssession som holdt op med at virke. Swap-filen er en fil med det samme filnavn som tekstfilen, med ".swp" tilf�jet i slutningen. Se ":help recovery". .TP \-s Stille tilstand. Kun n�r der startes som "Ex" eller n�r "\-e"-tilvalget blev givet inden "\-s"-tilvalget. .TP \-s {scriptind} Script-filen {scriptind} l�ses. Tegnene i filen fortolkes som havde du skrevet dem. Det samme kan g�res med kommandoen ":source! {scriptind}". Hvis slutningen af filen n�s inden editoren afslutter, s� l�ses yderligere tegn fra tastaturet. .TP \-T {terminal} Fort�ller .B Vim navnet p� terminalen som du bruger. Kr�ves kun n�r den automatisk m�de ikke virker. Skal v�re en terminal som kendes af .B Vim (indbygget) eller defineret i termcap- eller terminfo-filen. .TP \-u {vimrc} Brug kommandoerne i {vimrc}-filen til initialiseringer. Alle de andre initialiseringer springes over. Brug den til at redigere en s�rlig slags filer. Den kan ogs� bruges til at springe alle initialiseringer over, ved at give navnet "NONE". Se ":help initialization" i vim for flere detaljer. .TP \-U {gvimrc} Brug kommandoerne i {gvimrc}-filen til GUI-initialiseringer. Alle de andre GUI-initialiseringer springes over. Den kan ogs� bruges til at springe alle GUI-initialiseringer over, ved at give navnet "NONE". Se ":help gui\-init" i vim for flere detaljer. .TP \-V[N] Uddybende. Giv meddelelser om hvilke filer som er sourced og til l�sning og skrivning af en viminfo-fil. Det valgfrie nummer N er v�rdien af 'verbose'. Standard er 10. .TP \-v Start .B Vim i Vi-tilstand, ligesom eksekverbaren kaldet "vi". Det har kun virkning n�r eksekverbaren kaldes "ex". .TP \-w {scriptud} Alle tegnene som du skrev optages i filen {scriptud}, indtil du afslutter .B Vim\c \&. Det er nyttigt hvis du vil oprette en script-fil som skal bruges med "vim \-s" eller ":source!". Hvis {scriptud}-filen findes, s� tilf�jes tegnene til slutningen. .TP \-W {scriptud} Ligesom \-w, men en eksisterende fil overskrives. .TP \-x Brug kryptering n�r der skrives filer. Sp�rger efter en krypteringsn�gle. .TP \-X Opret ikke forbindelse til X-serveren. Afkorter opstartstiden i en terminal, men vinduets titel og udklipsholder bruges ikke. .TP \-y Start .B Vim i easy-tilstand, ligesom hvis "evim"- eller "eview"-eksekverbarene blev kaldt. F�r .B Vim til at opf�re sig som en klik og skriv-editor. .TP \-Z Restriktiv tilstand. Virker ligesom eksekverbaren som begynder med "r". .TP \-\- Betegner slutningen af tilvalgene. Argumenter efter dette h�ndteres som et filnavn. Det kan bruges til at redigere et filnavn som begynder med et '\-'. .TP \-\-echo\-wid Kun GTK GUI: Ekko vinduets id p� stdout. .TP \-\-help Giv en hj�lpemeddelelse og afslut, ligesom "\-h". .TP \-\-literal Tag filnavnets argumenter bogstaveligt, udvid ikke jokertegn. Det har ingen virkning i Unix hvor skallen udvidder jokertegn. .TP \-\-noplugin Spring indl�sning af plugins over. Indeb�res af \-u NONE. .TP \-\-remote Opret forbindelse til en Vim-server og f� den til at redigere filerne som gives i resten af argumenterne. Hvis der ikke findes nogen server, s� gives der en advarsel og filerne redigeres i den nuv�rende Vim. .TP \-\-remote\-expr {udtryk} Opret forbindelse til en Vim-server, evaluer {udtryk} i den og udskriv resultatet p� stdout. .TP \-\-remote\-send {n�gler} Opret forbindelse til en Vim-server and send {n�gler} til den. .TP \-\-remote\-silent Som \-\-remote, men uden advarslen n�r der ikke findes nogen server. .TP \-\-remote\-wait Som \-\-remote, men Vim afslutter ikke f�r filerne er blevet redigeret. .TP \-\-remote\-wait\-silent Som \-\-remote\-wait, men uden advarslen n�r der ikke findes nogen server. .TP \-\-serverlist Oplist navnene p� alle Vim-servere som der kan findes. .TP \-\-servername {navn} Brug servernavnet {navn}. Bruges til den nuv�rende Vim, medmindre det bruges med et \-\-remote-argument, s� er det navnet p� serveren som der skal oprettes forbindelse til. .TP \-\-socketid {id} Kun GTK GUI: Brug GtkPlug-mekanismen til at k�re gvim i et andet vindue. .TP \-\-version Udskriv versionsinformation og afslut. .SH ONLINEHJ�LP Skriv ":help" i .B Vim for at begynde. Skriv ":help emne" for at f� hj�lp til et bestemt emne. F.eks.: ":help ZZ" for at f� hj�lpe til "ZZ"-kommandoen. Brug <Tab> og CTRL-D for at fuldf�re emner (":help cmdline\-completion"). Tags findes til at hoppe fra et sted til et andet (en slags hypertekst-links, se ":help"). Alle dokumentationsfiler kan vises p� denne m�de, f.eks. ":help syntax.txt". .SH FILER .TP 15 /usr/local/lib/vim/doc/*.txt .B Vim\c -dokumentationsfilerne. Brug ":help doc\-file\-list" for at f� den fulde liste. .TP /usr/local/lib/vim/doc/tags Tags-filen som bruges til at finde information i dokumentationsfilerne. .TP /usr/local/lib/vim/syntax/syntax.vim Systembrede syntaksinitialiseringer. .TP /usr/local/lib/vim/syntax/*.vim Syntaksfiler til diverse sprog. .TP /usr/local/lib/vim/vimrc Systembrede .B Vim\c -initialiseringer. .TP ~/.vimrc Dine personlige .B Vim\c -initialiseringer. .TP /usr/local/lib/vim/gvimrc Systembrede gvim-initialiseringer. .TP ~/.gvimrc Dine personlige gvim-initialiseringer. .TP /usr/local/lib/vim/optwin.vim Script som bruges til ":options"-kommandoen, en god m�de til at vise og s�tte valgmuligheder. .TP /usr/local/lib/vim/menu.vim Systembrede menu-initialiseringer til gvim. .TP /usr/local/lib/vim/bugreport.vim Script til at generere en fejlrapport. Se ":help bugs". .TP /usr/local/lib/vim/filetype.vim Script til at registrere filtypen ud fra navnet. Se ":help 'filetype'". .TP /usr/local/lib/vim/scripts.vim Script til at registrere filtypen ud fra indholdet. Se ":help 'filetype'". .TP /usr/local/lib/vim/print/*.ps Filer som bruges til PostScript-udskrivning. .PP L�s VIM-hjemmesiden for seneste info: .br <URL:http://www.vim.org/> .SH SE OGS� vimtutor(1) .SH FORFATTER Det meste af .B Vim blev lavet af Bram Moolenaar, med en masse hj�lp fra andre. Se ":help credits" i .B Vim\c \&. .br .B Vim er baseret p� Stevie, arbejdet p� af: Tim Thompson, Tony Andrews og G.R. (Fred) Walter. Selvom der n�sten ikke er noget af den originale kode tilbage. .SH FEJL Formodentligt. Se ":help todo" for en liste over kendte problemer. .PP Bem�rk at flere ting som af nogle kan anses som v�rende fejl, faktisk er pga. en for n�r reproduktion af Vi's opf�rsel. Og hvis du t�nker at andre ting er fejl "fordi Vi g�r det anderledes", s� kig n�rmere p� vi_diff.txt-filen (eller skriv :help vi_diff.txt i Vim). Se ogs� 'compatible'- og 'cpoptions'-valgmulighederne.