VIM(1)

NAMA PERINTAH/PROGRAM
vim - Vi IMproved, teks editor

RINGKASAN
vim [option] [file ..]
vim [option] -
vim [option] -t tag
vim [option] -q [errorfile]

ex
view
gvim gview
rvim rview rgvim rgview

PENJELASAN
Vim adalah sebuah teks editor yang merupakan peningkatan dari program Vi. Vim dapat digunakan untuk mengedit teks ASCII dan terutama sangat berguna untuk pengeditan program.

Ada banyak perbaikan yang telah dilakukan pada program Vi yaitu multi level undo, multi windows dan buffer, sintaks highlighting, command line editing, filename completion, on-line help, visual selection, dsb... Lihat ":help vi_diff" untuk melihat rangkuman mengenai perbedaan antara Vim dan Vi.

Saat program Vim berjalan, help dapat dipanggil dari on-line help system dengan mengetik perintah ":help". Lihat section ON-LINE HELP dibawah.

Vim digunakan untuk mengedit sebuah file tunggal dengan perintah

    vim file

Secara umum Vim dijalankan dengan perintah:

    vim [option] [filelist]

Bila filelist tidak ditulis, editor ini akan memulainya dengan buffer kosong. Sebaliknya satu dari empat yang berikut ini pasti akan digunakan untuk memilih satu atau lebih file yang di edit.

file ..
    Nama-nama file. File pertama akan menjadi file aktif dan dibaca kedalam buffer. Kursor akan berada pada posisi baris pertama buffer. Anda bisa melihat file-file lainnya dengan mengetik perintah ":next". Untuk mengedit sebuah file yang mempunyai awalan dash, sebelum filelist diberi tanda "--".

-   File yang di edit dibaca dari stdin. Perintah-perintah dibaca dari stderr, yang merupakan sebuah tty.

-t {tag}
    File yang di edit dan posisi kursor bergantung pada sebuah "tag", label goto pendek. {tag} ditemukan dalam file tag, file yang berhubungan menjadi file aktif dan perintah yang berhubungan di eksekusi. Kebanyakan ini digunakan untuk program-program bahasa C, dalam kasus ini {tag} dapat berupa sebuah nama fungsi. Pengaruhnya adalah bahwa file yang mengandung fungsi tersebut menjadi file aktif dan kursor berada diposisi awal dari fungsi tersebut. Lihat ":help tag_commands".

-q [errorfile]
    Menjalankan mode quickFix. File [errorfile] dibaca dan kesalahan pertama ditampilkan. Bila [errorfile] dihilangkan, filename dihasilkan dari option 'errorfile' (defaultnya "AztecC.Err" untuk Amiga, "errors.vim" untuk sistem lainnya). Kesalahan lebih lanjut dapat di ambil dengan menggunakan perintah ":cn". Lihat ":help quickfix".

Vim berjalan secara berbeda tergantung nama perintah.

vim Cara "normal" untuk menjalankannya, ini adalah defaultnya.

ex  Menjalankan mode Ex. Kembali ke mode Normal dengan perintah ":vi". Dapat juga dilakukan dengan argumen "-e".

view
    mode read-only. File hanya dapat dibaca saja. Dapat juga dilakukan dengan argumen "-R".

gvim gview
    Versi GUI. Dijalankan membuka window baru. Dapat juga dilakukan dengan argumen "-g".

rvim rview rgvim rgview
    Seperti diatas tapi dengan pembatasan-pembatasan. Tidak memungkinkan untuk menjalankan shell command atau menghentikan Vim. Dapat juga dilakukan dengan argumen "-Z".

OPTION
Option-option dapat diberikan sebelum atau setelah nama file. Option-option tanpa argumen dapat digabung setelah dash tunggal.

+[num]
    Untuk file pertama kursor akan diletakkan diposisi baris "num". Bila "num" tidak ditulis, kursor diletakkan diposisi baris yang terakhir.

+/{pat}
    Untuk file pertama kursor akan diletakkan diposisi yang terdapat {pat} pertama. Lihat ":help search_pattern" untuk search pattern.

+{command}

-c {command}
    {command} akan dieksekusi setelah file pertama sudah dibaca. {command} diterjemahkan sebagai sebuah perintah Ex. Bila {command} mengandung spasi maka harus ditutup dengan tanda petik (tergantung pada shell yang digunakan). Contohnya: Vim "+set si" main.c
    Catatan: Anda dapat mennggunakan sampai 10 perintah "+" atau "-c".

-b  Mode binary. Beberapa option akan di set dan membuatnya memungkinkan untuk mengedit sebuah file binary atau file executable.

-C  Compatible. Mengeset option 'compatible'. Ini akan membuat Vim berjalan seperti Vi, sekalipun terdapat file .vimrc.

-d {device}
    Membuka {device} untuk digunakan sebagai sebuah terminal. Hanya pada Amiga. Contohnya: "-d con:20/30/600/150".

-e  Menjalankan Vim dalam mode Ex, sama dengan menjalankan "ex".

-f  Foreground. Untuk versi GUI, Vim tidak akan bercabang dan lepas dari shell dimana dia dijalankan. Pada Amiga, Vim tidak membuka window baru saat dijalankan ulang. Option ini digunakan saat Vim diekseksi oleh sebuah program yang menunggu waktu edit selesai (misalnya mail). Pada Amiga perintah-perintah ":sh" dan ":!" tidak akan bekerja.

-F  Bila Vim telah di-compile dengan dukungan FKMAP untuk pengeditan file-file berorientasi right-to-left dan Farsi keyboard mapping maka option menjalankan Vim dalam mode Farsi, misal 'fkmap' dan 'rightleft' di set. Sebaliknya pesan kesalahan ditampilkan dan Vim dibatalkan.

-g  Bila Vim telah di-compile dengan dukungan GUI maka option meng-enable GUI. Bila dukungan GUI tidak di-compile maka pesan kesalahan akan ditampilkan dan Vim dibatakalkan.

-h  Menampilkan cara penggunaan program atau help. Setelah itu exit dari program Vim.

-H  Bila Vim telah di-compile dengan dukungan RIGHTLEFT untuk pengeditan file-file berorientasi right-to-left dan Hebrew keyboard mapping maka option menjalaknkan Vim dalam mode Hebrew, misal 'hkmap' dan 'rightleft' di set. Selain itu pesan kesalahan ditampilkan dan program Vim dibatalkan.

-i {viminfo}
    Saat menggunakan file viminfo yang di-enable-kan maka option mengeset filename untuk menggunakan default "~/.viminfo". Ini juga dapat digunakan untuk melewati penggunaan file .viminfo dengan memberi nama "NONE".

-L  Sama dengan -r.

-l  Mode lisp. Mengeset option 'lisp' dan 'showmatch' menjadi on.

-N  Mode no-compatible. Mereset option 'compatible'. Ini akan membuat Vim menjadi berjalan sedikit lebih baik tapi sedikit kurang kompatibel dengan Vi meskipun tidak terdapat file .vimrc.

-n  Tidak ada swap file yang akan digunakan. Tidak dimungkinankan melalukan recovery setelah terjadi crash. Lakukan dengan hati-hati bila Anda mengedit sebuah file pad media yang sangat lambat (misal disket). Juga dapat dilakukan dengan ":set uc=0". Dapat dibatalkan dengan ":set uc=200".

-o[N]
    Membuka N window. Bila N dihilangkan, setiap file membuka satu window.

-R  Mode read-only. Option 'readonly' akan di set. Anda masih dapat mengedit buffer, tapi akan dicegah dari kecelakaan penimpaan file. Bila Anda ingin menimpa sebuah file, tambahkan tanda seru pada pada perintah Ex, seperti ini ":w!". Option -R juga menunjukan option -n (lihat dibawah). Option 'readonly' dapat di reset dengan ":set noro". Lihat ":help 'readonly'".

-r  Menampilkan swap file, dengan informasi mengenai penggunaannya untuk recovery.

-r {file}
    mode recovery. File swap digunakan untuk recover saat terjadi crash. File swap adalah sebuah file dengan nama sama dengan file teksnya dengan tambahan ".swp". Lihat ":help recovery".

-s  mode silent. Hanya jika dijalankan dengan "Ex" atau option "-e" diberikan sebelum option "-s".

-s {scriptin}
    File script {scriptin} dibaca. Karakter-karakter dalam file tersebut diterjemahkan seperti bila Anda mengetiknya. Hal yang sama dapat dilakukan dengan perintah ":source! {scriptin}". Bila akhir dari file telah dicapai sebelum editor keluar, karakter-karakter selanjutnya dibaca dari keyboard.

-T {terminal}
    Memberitahu Vim nama terminal yang sedang Anda gunakan. Hanya diperlukan bila cara otomatis tidak bekerja. Sebaiknya sebuah terminal diketahui Vim (builtin) atau didefinisikan dalam termcap atau file terminfo.

-u {vimrc}
    Menggunakan perintah-perintah dalam file {vimrc} untuk inisialisasi. Seluruh inisialisasi lainnya di lewati. Digunakan untuk mengedit file-file khusus. Juga dapat digunakan untuk melewati seluruh inisialisasi dengan memberi nama "NONE". Lihat ":help initialization" untuk keterangan lebih jelas.

-U {gvimrc}
    Menggunakan perintah dalam file {gvimrc} untuk inisialisasi GUI. Seluruh inisialisasi GUI yang lain dilewati. Untuk melewati inisialisasi-inisialisasi GUI dapat dilakukan juga dengan memberi nama "NONE". Lihat ":help gui_init" untuk keterangan lebih jelas.

-V  Verbose. Menampilkan pesan mengenai file-file sumber dan untuk pembacaan serta penulisan file viminfo.

-v  Menjalankan Vim dalam mode Vi, sama seperti mengeksekusi perintah "vi". Ini hanya berpengaruh bila menjalankan "ex".

-w {scriptout}
    Seluruh karakter yang Anda ketik akan dicatat dalam file {scriptout}, sampai Anda exit atau keluar dari Vim. Ini berguna bila Anda ingin membuat sebuah file script untuk dipakai dengan "vim -s" atau ":source!". Bila file {scriptout} telah ada, karakter-karakter di tambahkan.

-W {scriptout}
    Seperti -w, tapi file yang telah ada akan ditimpa.

-x  Filter read dan penulisan file melalui crypt. Belum diimplementasikan.

-Z  Mode restricted. Bekerja seperti menjalakan "r".

--  Merupakan akhir dari option-option. Argumen-argumen setelah ini akan diperlakukan sebagai sebuah nama file. Ini dapat digunakan untuk mengedit nama file yang diawali '-'.

ON-LINE HELP
Ketik ":help" dalam Vim untuk menjalankannya. Ketik ":help subject" untuk menampilkan help untuk subyek tertentu. Contohnya: ":help ZZ" menampilkan help untuk perintah "ZZ". Gunakan <Tab> dan CTRL-D untuk melengkapi subyek (":help cmdline_completion"). Tag adalah tanda untuk melompat dari satu tempat ke tempat lain (kependekan dari link-link hypertext, lihat ":help"). File-file dokumentasi dapat dilihat dengan cara ini, contohnya ":help syntax.txt".

FILE-FILE

/var/tmp/vim-root/usr/share/vim/doc/*.txt
    File dokumentasi program Vim . Gunakan ":help doc-file-list" untuk mendapatkan dokumentasinya secara lengkap.

/var/tmp/vim-root/usr/share/vim/doc/tags
    File tags digunakan untuk menemukan informasi dalam file dokumentasi.

/var/tmp/vim-root/usr/share/vim/syntax/syntax.vim
    Inisialisasi sintaks system wide.

/var/tmp/vim-root/usr/share/vim/syntax/*.vim
    File-file sintaks untuk berbagai bahasa.

/var/tmp/vim-root/usr/share/vim/vimrc
    Inisialisasi-inisialisasi system wide Vim

/var/tmp/vim-root/usr/share/vim/gvimrc
    Inisialisasi system wide gvim.

/var/tmp/vim-root/usr/share/vim/menu.vim
    Inisialisasi system wide menu untuk gvim.

/var/tmp/vim-root/usr/share/vim/bugreport.vim
    Script untuk membuat bug report. Lihat ":help bugs".

Untuk informasi terbaru kunjungi home page VIM:
<URL:http://www.vim.org/>

PEMBUAT
Vim dibuat oleh Bram Moolenaar, dengan bantuan beberapa orang lain. Lihat ":help credits".
Vim didasarkan pada Stevie, dikerjakan oleh: Tim Thompson, Tony Andrews dan G.R. (Fred) Walter.

BUG
Mungkin ada. Lihat file "todo" yang disertakan bersama distribusi ini.

Ada sejumlah hal yang mungkin sebagai bug diketahui seseorang adalah kenyataan yang disebabkan suatu kepercayaan berlebih pada reproduksi Vi. Dan bila Anda pikir sesuatu itu adalah bug "karena Vi melakukannya secara berbeda" maka Anda sebaiknya membaca lebih cermat file vi_diff.txt (atau ketik :help vi_diff.txt saat ada di Vim). Juga lihat option-option 'compatible' dan 'cpoptions'.

PENTERJEMAH
Rizqy Syarief <rizqy@rad.net.id>