blob: 97e06a02b19c4880015c1d50293f0674c88690ae [file] [log] [blame]
Bram Moolenaarb477af22018-07-15 20:20:18 +02001.TH VIM 1 "11. april 2006"
2.SH NAVN
3vim \- Vi IMproved, en programmørs teksteditor
4.SH SYNOPSIS
5.br
6.B vim
7[tilvalg] [fil ..]
8.br
9.B vim
10[tilvalg] \-
11.br
12.B vim
13[tilvalg] \-t tag
14.br
15.B vim
16[tilvalg] \-q [fejlfil]
17.PP
18.br
19.B ex
20.br
21.B view
22.br
23.B gvim
24.B gview
25.B evim
26.B eview
27.br
28.B rvim
29.B rview
30.B rgvim
31.B rgview
32.SH BESKRIVELSE
33.B Vim
34er en teksteditor som er opad kompatibel med Vi.
35Den kan bruges til at redigere alle slags ren tekst.
36Den er særlig nyttig til at redigere programmer.
37.PP
38Der er mange forbedringer over Vi: multiniveau fortryd,
39multivinduer og -buffere, syntaksfremhævning, redigering af kommandolinje,
40fuldførelse af filnavn, onlinehjælp, visuel markering, osv.
41Se ":help vi_diff.txt" for et overblik over forskellene mellem
42.B Vim
43og Vi.
44.PP
45Mens
46.B Vim
47kører, kan der indhentes massere af hjælp fra online-hjælpesystemet, med
48":help"-kommandoen.
49Se ONLINEHJÆLP-sektionen nedenfor.
50.PP
51Oftest startes
52.B Vim
53for at redigere en enkelt fil med kommandoen
54.PP
55 vim fil
56.PP
57Mere generelt startes
58.B Vim
59med:
60.PP
61 vim [tilvalg] [filliste]
62.PP
63Hvis fillisten mangler, så startes editoren med en tom buffer.
64Ellers kan én af følgende fire måder bruges til at vælge en eller
65flere filer som skal redigeres.
66.TP 12
67fil ..
68En liste over filnavne.
69Den første bliver den nuværende fil og læses ind i bufferen.
70Markøren placeres på den første linje i bufferen.
71Du kan gå til de andre filer med ":next"-kommandoen. Skriv "\-\-" foran
72fillisten, for at redigere en fil som begynder med en bindestreg.
73.TP
74\-
75Filen som skal redigeres læses fra stdin. Kommandoer læses fra stderr, hvilket
76skal være en tty.
77.TP
78\-t {tag}
79Filen som skal redigeres og den indledende markørplacering afhænger af
80et "tag", en slags gå til-etiket.
81{tag} opslås i tags-filen, den tilknyttede fil bliver den nuværende
82fil og den tilknyttede kommando udføres.
83Det bruges mest til C-programmer, hvor {tag} kunne være et
84funktionsnavn.
85Virkningen er at filen som indeholder funktionen bliver den nuværende fil
86og markøren placeres i begyndelsen af funktionen.
87Se ":help tag\-commands".
88.TP
89\-q [fejlfil]
90Start i quickFix-tilstand.
91Filen [fejlfil] læses og den første fejl vises.
92Hvis [fejlfil] udelades, så indhentes filnavnet fra 'errorfile'-valgmuligheden
93(standard er "AztecC.Err" på Amiga, "errors.err" på andre
94systemer).
95Der kan hoppes til yderligere fejl med ":cn"-kommandoen.
96Se ":help quickfix".
97.PP
98.B Vim
99opfører sig anderledes, afhængig af navnet på kommandoen (eksekverbaren kan
100stadig være den samme fil).
101.TP 10
102vim
103Den "normale" måde, alt er standard.
104.TP
105ex
106Start i Ex-tilstand.
107Gå til normal tilstand med ":vi"-kommandoen.
108Det kan også gøres med "\-e"-argumentet.
109.TP
110view
111Start i skrivebeskyttet tilstand. Du vil være beskyttet mod at skrive filerne.
112Det kan også gøres med "\-R"-argumentet.
113.TP
114gvim gview
115GUI-versionen.
116Starter et nyt vindue.
117Det kan også gøres med "\-g"-argumentet.
118.TP
119evim eview
120GUI-versionen i easy-tilstand.
121Starter et nyt vindue.
122Det kan også gøres med "\-y"-argumentet.
123.TP
124rvim rview rgvim rgview
125Som dem ovenfor, men med restriktioner. Det vil ikke være muligt at starte
126skalkommandoer, eller at suspendere
127.B Vim\c
128\&.
129Det kan også gøres med "\-Z"-argumentet.
130.SH TILVALG
131Tilvalgene kan gives i vilkårlig rækkefølge, før eller efter filnavnene.
132Tilvalg uden et argument kan kombineres efter en enkelt bindestreg.
133.TP 12
134+[nummer]
135Ved den første fil, placeres markøren på linje "nummer".
136Hvis "nummer" mangler, så placeres markøren på den sidste linje.
137.TP
138+/{sti}
139Ved den første fil, placeres markøren på linjen med den
140første forekomst af {sti}.
141Se ":help search\-pattern" for tilgængelige søgemønstre.
142.TP
143+{kommando}
144.TP
145\-c {kommando}
146{kommando} udføres efter den første fil er blevet læst.
147{kommando} fortolkes som en Ex-kommando.
148Hvis {kommando} indeholder mellemrum, så skal den omsluttes af
149dobbelte citationstegn (det afhænger af den skal der bruges).
Bram Moolenaar2547aa92020-07-26 17:00:44 +0200150Eksempel: vim "+set si" main.c
Bram Moolenaarb477af22018-07-15 20:20:18 +0200151.br
152Bemærk: Du kan bruge op til 10 "+"- eller "\-c"-kommandoer.
153.TP
154\-S {fil}
155{fil} bliver sourced efter den første fil er blevet læst.
156Det svarer til \-c "source {fil}".
157{fil} må ikke begynde med '\-'.
158Hvis {fil} udelades, så bruges "Session.vim" (virker kun når \-S er det sidste
159argument).
160.TP
161\-\-cmd {kommando}
162Ligesom at bruge "\-c", men kommandoen udføres lige inden
163behandlingen af vimrc-filer.
164Du kan bruge op til 10 af disse kommandoer, uafhængigt af "\-c"-kommandoer.
165.TP
166\-A
167Hvis
168.B Vim
169blev kompileret med understøttelse af ARABIC til redigering af filer som er
170orienteret højre mod venstre og arabisk tastaturlayout, så starter tilvalget
171.B Vim
172i arabisk tilstand, dvs. 'arabic' sættes.
173Ellers gives en fejlmeddelelse og
174.B Vim
175afbrydes.
176.TP
177\-b
178Binær tilstand.
179Der sættes nogle få valgmuligheder som gør det muligt at redigere en
180binær eller eksekverbar fil.
181.TP
182\-C
183Kompatibel. Sæt 'compatible'-valgmuligheden.
184Det får
185.B Vim
186til at opføre sig mest som Vi, selvom der findes en .vimrc-fil.
187.TP
188\-d
189Start i diff-tilstand.
190Der skal være to, tre eller fire filnavneargumenter.
191.B Vim
192åbner alle filerne og viser forskellene mellem dem.
193Virker ligesom vimdiff(1).
194.TP
195\-d {enhed}
196Åbn {enhed} til brug som en terminal.
197Kun på Amiga.
198Eksempel:
199"\-d con:20/30/600/150".
200.TP
201\-D
202Fejlretning. Gå til fejlretningstilstand når den første kommando udføres fra
203et script.
204.TP
205\-e
206Start
207.B Vim
208i Ex-tilstand, ligesom hvis "ex"-eksekverbaren blev kaldt.
209.TP
210\-E
211Start
212.B Vim
213i forbedret Ex-tilstand, ligesom hvis "exim"-eksekverbaren blev kaldt.
214.TP
215\-f
216Forgrund. I GUI-versionen, vil
217.B Vim
218ikke fork'e og frigøre fra skallen som den blev startet i.
219På Amiga, genstartes
220.B Vim
221ikke for at åbne et nyt vindue.
222Tilvalget bør bruges når
223.B Vim
224udføres af et program der venter på at redigeringssession
225bliver færdig (f.eks. mail).
226På Amiga virker ":sh"- og ":!"-kommandoerne ikke.
227.TP
228\-\-nofork
229Forgrund. I GUI-versionen, vil
230.B Vim
231ikke fork'e og frigøre fra skallen som den blev startet i.
232.TP
233\-F
234Hvis
235.B Vim
236blev kompileret med understøttelse af FKMAP til redigering af filer som er
237orienteret højre mod venstre og persisk tastaturlayout, så starter tilvalget
238.B Vim
239i persisk tilstand, dvs. 'fkmap' og 'rightleft' sættes.
240Ellers gives en fejlmeddelelse og
241.B Vim
242afbrydes.
243.TP
244\-g
245Hvis
246.B Vim
247blev kompileret med understøttelse af GUI, så aktiveres GUI'en af
248denne valgmulighed. Hvis understøttelse af GUI ikke blev kompileret ind,
249så gives en fejlmeddelelse og
250.B Vim
251afbrydes.
252.TP
253\-h
254Giv lidt hjælp om kommandolinjeargumenterne og tilvalgene.
255Herefter afsluttes
256.B Vim\c
257\&.
258.TP
259\-H
260Hvis
261.B Vim
262blev kompileret med understøttelse af RIGHTLEFT til redigering af filer som er
263orienteret højre mod venstre og hebraisk tastaturlayout, så starter tilvalget
264.B Vim
265i hebraisk tilstand, dvs. 'hkmap' og 'rightleft' sættes.
266Ellers gives en fejlmeddelelse og
267.B Vim
268afbrydes.
269.TP
270\-i {viminfo}
271Når brug af viminfo-filen er aktiveret, så sætter tilvalget det
272filnavn som skal bruges, i stedet for standarden "~/.viminfo".
273Det kan også bruges til at springe brugen af .viminfo-filen over,
274ved at give navnet "NONE".
275.TP
276\-L
277Samme som \-r.
278.TP
279\-l
280Lisp-tilstand.
281Sætter 'lisp'- og 'showmatch'-valgmulighederne til.
282.TP
283\-m
284Ændring af filer er deaktiveret.
285Nulstiller 'write'-valgmuligheden.
286Du kan stadig ændre bufferen, men det er ikke muligt at skrive en fil.
287.TP
288\-M
289Ændringer tillades ikke. 'modifiable'- og 'write'-valgmulighederne fjernes,
290så ændringer ikke er tilladt og filer ikke kan skrives. Bemærk at
291valgmulighederne kan sættes for at gøre det muligt at foretage ændringer.
292.TP
293\-N
294No-compatible-tilstand. Nulstil 'compatible'-valgmuligheden.
295Det får
296.B Vim
297til at opføre sig en smule bedre, men mindre Vi-kompatibel, selvom der ikke
298findes en .vimrc-fil.
299.TP
300\-n
301Der bruges ingen swap-fil.
302Det er umuligt at gendanne efter programmet er holdt op med at virke.
303God hvis du vil redigere en fil på et meget langsomt medie (f.eks. floppy).
304Kan også gøres med ":set uc=0".
305Kan fortrydes med ":set uc=200".
306.TP
307\-nb
308Bliv en editor-server til NetBeans. Se dokumentationen for detaljer.
309.TP
310\-o[N]
311Åbn N vinduer stablet.
312Når N udelades, så åbnes ét vindue pr. fil.
313.TP
314\-O[N]
315Åbn N vinduer side om side.
316Når N udelades, så åbnes ét vindue pr. fil.
317.TP
318\-p[N]
319Åbn N fanebladssider.
320Når N udelades, så åbnes én fanebladsside pr. fil.
321.TP
322\-R
323Skrivebeskyttet tilstand.
Bram Moolenaard47d5222018-12-09 20:43:55 +0100324\&'readonly'-valgmuligheden sættes.
Bram Moolenaarb477af22018-07-15 20:20:18 +0200325Du kan stadig redigere bufferen, men vil være forhindret i
326fejlagtigt at overskrive en fil.
327Hvis du vil overskrive en fil, så tilføj et
328udråbstegn til Ex-kommandoen, som i ":w!".
329\-R-tilvalget indebærer også \-n-tilvalget (se ovenfor).
Bram Moolenaard47d5222018-12-09 20:43:55 +0100330\&'readonly'-valgmuligheden kan slås fra med ":set noro".
Bram Moolenaarb477af22018-07-15 20:20:18 +0200331Se ":help 'readonly'".
332.TP
333\-r
334Oplist swap-filer, med information om at bruge dem til gendannelse.
335.TP
336\-r {fil}
337Gendannelsestilstand.
338Swap-filen bruges til at gendanne en redigeringssession som holdt
339op med at virke. Swap-filen er en fil med det samme filnavn som tekstfilen,
340med ".swp" tilføjet i slutningen.
341Se ":help recovery".
342.TP
343\-s
344Stille tilstand. Kun når der startes som "Ex" eller
345når "\-e"-tilvalget blev givet inden "\-s"-tilvalget.
346.TP
347\-s {scriptind}
348Script-filen {scriptind} læses.
349Tegnene i filen fortolkes som havde du skrevet dem.
350Det samme kan gøres med kommandoen ":source! {scriptind}".
351Hvis slutningen af filen nås inden editoren afslutter,
352så læses yderligere tegn fra tastaturet.
353.TP
354\-T {terminal}
355Fortæller
356.B Vim
357navnet på terminalen som du bruger.
358Kræves kun når den automatisk måde ikke virker.
359Skal være en terminal som kendes af
360.B Vim
361(indbygget) eller defineret i termcap- eller terminfo-filen.
362.TP
363\-u {vimrc}
364Brug kommandoerne i {vimrc}-filen til initialiseringer.
365Alle de andre initialiseringer springes over.
366Brug den til at redigere en særlig slags filer.
367Den kan også bruges til at springe alle initialiseringer over,
368ved at give navnet "NONE". Se ":help initialization" i vim for flere detaljer.
369.TP
370\-U {gvimrc}
371Brug kommandoerne i {gvimrc}-filen til GUI-initialiseringer.
372Alle de andre GUI-initialiseringer springes over.
373Den kan også bruges til at springe alle GUI-initialiseringer over,
374ved at give navnet "NONE". Se ":help gui\-init" i vim for flere detaljer.
375.TP
376\-V[N]
377Uddybende. Giv meddelelser om hvilke filer som er sourced og til læsning og
378skrivning af en viminfo-fil. Det valgfrie nummer N er værdien af 'verbose'.
379Standard er 10.
380.TP
381\-v
382Start
383.B Vim
384i Vi-tilstand, ligesom eksekverbaren kaldet "vi". Det har kun virkning når
385eksekverbaren kaldes "ex".
386.TP
387\-w {scriptud}
388Alle tegnene som du skrev optages i filen {scriptud}, indtil du afslutter
389.B Vim\c
390\&.
391Det er nyttigt hvis du vil oprette en script-fil som skal bruges med
392"vim \-s" eller ":source!".
393Hvis {scriptud}-filen findes, så tilføjes tegnene til slutningen.
394.TP
395\-W {scriptud}
396Ligesom \-w, men en eksisterende fil overskrives.
397.TP
398\-x
399Brug kryptering når der skrives filer. Spørger efter en krypteringsnøgle.
400.TP
401\-X
402Opret ikke forbindelse til X-serveren. Afkorter opstartstiden i en terminal,
403men vinduets titel og udklipsholder bruges ikke.
404.TP
405\-y
406Start
407.B Vim
408i easy-tilstand, ligesom hvis "evim"- eller "eview"-eksekverbarene blev kaldt.
409Får
410.B Vim
411til at opføre sig som en klik og skriv-editor.
412.TP
413\-Z
414Restriktiv tilstand. Virker ligesom eksekverbaren som begynder med "r".
415.TP
416\-\-
417Betegner slutningen af tilvalgene.
418Argumenter efter dette håndteres som et filnavn.
419Det kan bruges til at redigere et filnavn som begynder med et '\-'.
420.TP
421\-\-echo\-wid
422Kun GTK GUI: Ekko vinduets id på stdout.
423.TP
424\-\-help
425Giv en hjælpemeddelelse og afslut, ligesom "\-h".
426.TP
427\-\-literal
428Tag filnavnets argumenter bogstaveligt, udvid ikke jokertegn.
429Det har ingen virkning i Unix hvor skallen udvidder jokertegn.
430.TP
431\-\-noplugin
432Spring indlæsning af plugins over. Indebæres af \-u NONE.
433.TP
434\-\-remote
435Opret forbindelse til en Vim-server og få den til at redigere filerne
436som gives i resten af argumenterne. Hvis der ikke findes nogen server,
437så gives der en advarsel og filerne redigeres i den nuværende Vim.
438.TP
439\-\-remote\-expr {udtryk}
440Opret forbindelse til en Vim-server, evaluer
441{udtryk} i den og udskriv resultatet på stdout.
442.TP
443\-\-remote\-send {nøgler}
444Opret forbindelse til en Vim-server and send {nøgler} til den.
445.TP
446\-\-remote\-silent
447Som \-\-remote, men uden advarslen når der ikke findes nogen server.
448.TP
449\-\-remote\-wait
450Som \-\-remote, men Vim afslutter ikke før filerne er blevet redigeret.
451.TP
452\-\-remote\-wait\-silent
453Som \-\-remote\-wait, men uden advarslen når der ikke findes nogen server.
454.TP
455\-\-serverlist
456Oplist navnene på alle Vim-servere som der kan findes.
457.TP
458\-\-servername {navn}
459Brug servernavnet {navn}. Bruges til den nuværende Vim,
460medmindre det bruges med et \-\-remote-argument,
461så er det navnet på serveren som der skal oprettes forbindelse til.
462.TP
463\-\-socketid {id}
464Kun GTK GUI: Brug GtkPlug-mekanismen til at køre gvim i et andet vindue.
465.TP
466\-\-version
467Udskriv versionsinformation og afslut.
468.SH ONLINEHJÆLP
469Skriv ":help" i
470.B Vim
471for at begynde.
472Skriv ":help emne" for at få hjælp til et bestemt emne.
473F.eks.: ":help ZZ" for at få hjælpe til "ZZ"-kommandoen.
474Brug <Tab> og CTRL-D for at fuldføre emner (":help cmdline\-completion").
475Tags findes til at hoppe fra et sted til et andet (en slags hypertekst-links,
476se ":help").
477Alle dokumentationsfiler kan vises på denne måde, f.eks.
478":help syntax.txt".
479.SH FILER
480.TP 15
481/usr/local/lib/vim/doc/*.txt
482.B Vim\c
483-dokumentationsfilerne.
484Brug ":help doc\-file\-list" for at få den fulde liste.
485.TP
486/usr/local/lib/vim/doc/tags
487Tags-filen som bruges til at finde information i dokumentationsfilerne.
488.TP
489/usr/local/lib/vim/syntax/syntax.vim
490Systembrede syntaksinitialiseringer.
491.TP
492/usr/local/lib/vim/syntax/*.vim
493Syntaksfiler til diverse sprog.
494.TP
495/usr/local/lib/vim/vimrc
496Systembrede
497.B Vim\c
498-initialiseringer.
499.TP
500~/.vimrc
501Dine personlige
502.B Vim\c
503-initialiseringer.
504.TP
505/usr/local/lib/vim/gvimrc
506Systembrede gvim-initialiseringer.
507.TP
508~/.gvimrc
509Dine personlige gvim-initialiseringer.
510.TP
511/usr/local/lib/vim/optwin.vim
512Script som bruges til ":options"-kommandoen,
513en god måde til at vise og sætte valgmuligheder.
514.TP
515/usr/local/lib/vim/menu.vim
516Systembrede menu-initialiseringer til gvim.
517.TP
518/usr/local/lib/vim/bugreport.vim
519Script til at generere en fejlrapport. Se ":help bugs".
520.TP
521/usr/local/lib/vim/filetype.vim
522Script til at registrere filtypen ud fra navnet. Se ":help 'filetype'".
523.TP
524/usr/local/lib/vim/scripts.vim
525Script til at registrere filtypen ud fra indholdet. Se ":help 'filetype'".
526.TP
527/usr/local/lib/vim/print/*.ps
528Filer som bruges til PostScript-udskrivning.
529.PP
530Læs VIM-hjemmesiden for seneste info:
531.br
532<URL:http://www.vim.org/>
533.SH SE OGSÅ
534vimtutor(1)
535.SH FORFATTER
536Det meste af
537.B Vim
538blev lavet af Bram Moolenaar, med en masse hjælp fra andre.
539Se ":help credits" i
540.B Vim\c
541\&.
542.br
543.B Vim
544er baseret på Stevie, arbejdet på af: Tim Thompson,
545Tony Andrews og G.R. (Fred) Walter.
546Selvom der næsten ikke er noget af den originale kode tilbage.
547.SH FEJL
548Formodentligt.
549Se ":help todo" for en liste over kendte problemer.
550.PP
551Bemærk at flere ting som af nogle kan anses som værende fejl,
552faktisk er pga. en for nær reproduktion af Vi's opførsel.
553Og hvis du tænker at andre ting er fejl "fordi Vi gør det anderledes",
554så kig nærmere på vi_diff.txt-filen (eller skriv :help vi_diff.txt i Vim).
555Se også 'compatible'- og 'cpoptions'-valgmulighederne.