@@ -0,0 +1,489 @@
.TH VIM 1 "2002 Feb 22"
.SH ИМЯ
vim \- Vi IMproved (Улучшенный Vi), текстовый редактор для программистов
.SH КОМАНДНАЯ С Т Р О К А
.br
.B vim
[ключи] [файл ..]
.br
.B vim
[ключи] -
.br
.B vim
[ключи] \- t метка
.br
.B vim
[ключи] \- q [файл ошибок]
.PP
.br
.B ex
.br
.B view
.br
.B gvim
.B gview
.br
.B rvim
.B rview
.B rgvim
.B rgview
.SH ОПИСАНИЕ
.B Vim
-- текстовый редактор, обратно-совместимый с
Он может быть использован для правки всех видов простого текста.
Особенно он хорош для правки исходных текстов программ.
.PP
По сравнению с
.B Vim
имеет много усовершенствований: многократная отмена операций,
множественность окон и буферов, подсветка синтаксиса, правка командной строки,
автодополнение имён файлов, встроенная справка, визуальное выделение и т.п.
См. ":help vi_diff.txt" для получения полного списка различий между
.B Vim
и Vi.
.PP
В о
.B Vim
можно получить справку с
См. раздел "ВСТРОЕННАЯ СПРАВКА" ниже по тексту.
.PP
Чаще всего
.B Vim
запускают для правки одного файла при помощи команды
.PP
vim файл
.PP
В
.B Vim
выглядит так:
.PP
vim [ключи] [список файлов]
.PP
Если список файлов отсутствует, редактор начнёт работу с
В
.TP 12
файл ..
Список имён файлов.
Первый файл будет объявлен активным и загружен в буфер. К у р с о р
в первой строке буфера. Доступ к другим файлам может быть осуществлён при
помощи команды ":next". Чтобы править файл, имя которого начинается с
"дефис" (-), перед списком файлов необходимо поставить "--".
.TP
-
Файл будет прочитан из потока стандартного ввода. Команды будут считываться
из стандартного потока диагностики (stderr), который должен быть
терминалом.
.TP
-t {метка}
Имя файла и начальная позиция курсора зависят от "метки", похожей на метку goto.
{метка} ищется в файле меток, соответствующий файл становится активным, а
соответствующая команда исполняется.
Чаще всего используется в программах на языке Си, где {метка} может быть именем
функции.
Файл, содержащий функцию, становится активным, а
См. ":help tag-commands".
.TP
-q [файл ошибок]
Начать работу в режиме быстрого исправления.
При этом считывается [файл ошибок] и первая ошибка выводится на экран.
Если [файл ошибок] не указан, имя файла берётся из значения опции 'errorfile'
(по умолчанию: "AztecC.Err" для Amiga, "errors.err" для других систем).
К
См. ":help quickfix".
.PP
.B Vim
ведёт себя по-разному в зависимости от имени команды (исполняемый файл может
быть одним и тем же).
.TP 10
vim
"Нормальный" запуск, всё по умолчанию.
.TP
ex
Запуск в режиме Ex. Для перехода в нормальный режим
необходимо выполнить команду ":vi". Режим Ex включает
также ключ "-e".
.TP
view
Запуск в режиме "только для чтения". Вы будете защищены от случайной записи
файла. Т о
.TP
gvim gview
Версия с
Т о с
.TP
rvim rview rgvim rgview
Как и предыдущие команды, но с
или приостанавливать работу
.B Vim.
Вместо приставки "r" можно использовать ключ "-Z".
.SH КЛЮЧИ
Ключи могут быть указаны в любом порядке, до или после имён
файлов. Ключи без аргументов могут быть объединены под одним
дефисом.
.TP 12
+[номер]
В с
Если "номер" не указан, курсор будет помещён на последнюю строку.
.TP
+/{шаблон}
В
с
списка допустимых шаблонов.
.TP
+{команда}
.TP
-c {команда}
{команда} исполняется после загрузки первого файла как команда Ex.
Если {команда} содержит пробелы, то она должна быть заключена в
двойные кавычки (в зависимости от используемой оболочки).
Пример: vim "+set si" main.c
.br
Примечание: Можно указывать до десяти команд "+" или "-c".
.TP
--cmd {команда}
Как "-c", но команда исполняется перед обработкой любого файла
настроек (vimrc).
Можно указывать до десяти таких команд, независимо от количества
команд "-c".
.TP
-A
Если
.B Vim
был собран с
набранных справа налево, и с
этот ключ запускает
.B Vim
в арабском режиме, с В
случае
.B Vim
завершает работу с
.TP
-b
Двоичный режим.
Производится настройка некоторых опций, делающих возможной правку
двоичного или исполняемого файла.
.TP
-C
Режим совместимости. Включает опцию 'compatible'.
.B Vim
будет работать почти как Vi, даже если существует файл .vimrc.
.TP
-d
Режим поиска различий.
Должно быть указано два или три имени файла.
.B Vim
откроет все файлы и покажет различия между ними
(как vimdiff(1)).
.TP
-d {устройство}
Открыть {устройство} для использования в качестве терминала (только на Amiga).
Пример:
"\- d con:20/30/600/150".
.TP
-e
Запустить
.B Vim
в режиме Ex, как будто исполняемый файл имеет имя "ex".
.TP
-f
Режим активного приложения. Версия
.B Vim
с
от запустившей её оболочки. Н а
.B Vim
не будет создавать новое окно. Этот ключ нужно использовать,
когда
.B Vim
запускается программой, которая должна ждать завершения
сеанса правки (например, программа для работы с
Н а
.TP
--nofork
Режим активного приложения. Версия
.B Vim
с
от запустившей её оболочки.
.TP
-F
Если
.B Vim
был собран с
и настроек клавиатуры для языка фарси, этот ключ запускает
.B Vim
в режиме фарси, иначе говоря, с
'fkmap' и 'rightleft'.
В
.B Vim
завершает работу с о б
.TP
-g
Если
.B Vim
был собран с
включает графический интерфейс. В
.B Vim
завершает работу с о б
.TP
-h
Выводит краткую информацию о б
После этого
.B Vim
завершает работу.
.TP
-H
Если
.B Vim
был собран с
и настроек клавиатуры для иврита, этот ключ запускает
.B Vim
в режиме иврита, иначе говоря, с
В
.B Vim
завершает работу с о б
.TP
-i {viminfo}
Если используется файл viminfo, то этот ключ задаёт имя такого файла (вместо
"~/.viminfo" по умолчанию). Можно также избежать использования файла viminfo
путём указания имени "NONE".
.TP
-L
Т о
.TP
-l
Режим Lisp. Включаются опции 'lisp' и 'showmatch'.
.TP
-m
Изменение файлов запрещено. При этом отключается опция 'write', поэтому
запись файлов становится невозможной.
.TP
-N
Режим неполной совместимости. Отключается 'compatible'.
.B Vim
будет работать лучше, но не будет полностью совместим с
отсутствует файл сценария настроек (.vimrc).
.TP
-n
Н е с б о е
Удобно для правки файла на очень медленном носителе (например, гибком диске).
Т о
.TP
-o[N]
Открыть N окон, разделённых по горизонтали. Если N не указано, то открывается
по одному окну на каждый файл.
.TP
-O[N]
Открыть N окон, разделённых по вертикали. Если N не указано, то открывается
по одному окну на каждый файл.
.TP
-R
Режим "только для чтения". Включается опция 'readonly'.
Файл в буфере доступен для редактирования, но е г о
случайно перезаписать. Для сохранения файла необходимо добавить восклицательный
знак к соответствующей команде Ex (например, ":w!").
Ключ "-R" подразумевает также, что используется и ключ "-n" (см. выше).
Опция 'readonly' может быть выключена по команде ":set noro".
См. ":help 'readonly'".
.TP
-r
Вывести список своп-файлов и информацию о б
.TP
-r {файл}
Режим восстановления.
Для восстановления после сбоя будет использован своп-файл.
Своп-файл имеет то же имя, что и текстовый файл, но с
См. ":help recovery".
.TP
-s
Тихий режим. Только при запуске как "Ex" или если перед "-s" указан ключ "-e".
.TP
-s {scriptin}
Считывается файл сценария {scriptin}. При этом, содержимое файла воспринимается
в виде команд, как если бы они были набраны на консоли.
Т о
Если конец файла считывается до завершения работы редактора, то в дальнейшем
ввод осуществляется с
.TP
-T {terminal}
Сообщает
.B Vim
тип используемого терминала. Необходимо только в тех ситуациях, когда
автоматическое определение терминала не работает. Имя терминала должно быть
известно
.B Vim
(встроено в него) или определено в файлах termcap или terminfo.
.TP
-u {vimrc}
Использовать команды из файла сценария {vimrc} для настройки.
В с е
Удобно для редактирования специальных типов файлов.
Чтобы избежать использования сценариев настроек вообще, можно использовать
имя "NONE". См. ":help initialization".
.TP
-U {gvimrc}
Использовать команды из файла сценария {gvimrc} для настройки графического
интерфейса.
В с е
Чтобы избежать использования сценариев настроек графического интерфейса вообще,
можно использовать имя "NONE". См. ":help gui-init".
.TP
-V
"Болтливый" режим. Выводить сообщения о о
чтении-записи файла viminfo.
.TP
-v
Запустить
.B Vim
в режиме Vi, как будто исполняемый файл имеет имя "vi". Имеет смысл только если
исполняемый файл имеет имя "ex".
.TP
-w {scriptout}
В с е с
записываются в файл {scriptout}.
Удобно в том случае, когда вы хотите создать файл сценария для последующего
использования с
то новые символы будут добавляются в конец файла.
.TP
-W {scriptout}
Как "-w", но уже существующий файл будет перезаписан.
.TP
-x
Шифровать записываемые файлы. Будет выдано приглашение ввести пароль.
.TP
-X
Н е
использование заголовка окна и буфера обмена.
.TP
-Z
Ограниченный режим. Работает так же, как и программы, начинающиеся с
.TP
--
Конец ключей. В с е
Может быть использовано для правки файлов, имена которых начинаются с
.TP
--help
Вывести краткую справку и завершить работу. Т о
.TP
--version
Вывести информацию о
.TP
--remote
Подключиться к серверу Vim и заставить е г о
последующих аргументах. Если сервер не найден, выводится предупреждение,
а
.TP
--remote-expr {выражение}
Подключиться к серверу Vim и вычислить на нём указанное {выражение}.
Результат вычисления будет выведен в поток стандартного вывода (stdout).
.TP
--remote-send {ключи}
Подключиться к серверу Vim и передать ему указанные {ключи}.
.TP
--remote-silent
Как "--remote", но без вывода предупреждения, если сервер не найден.
.TP
--remote-wait
Как "--remote", но Vim не будет завершать работу до тех пор, пока не будет
выполнена правка всех файлов.
.TP
--remote-wait-silent
Как "--remote-wait", но без вывода предупреждения, если сервер не найден.
.TP
--serverlist
Вывести список всех доступных серверов Vim.
.TP
--servername {имя}
Использовать указанное {имя} в качестве имени сервера. Если ключ
"--remote" не указан, то {имя} присваивается данной копии Vim,
в противном случае указывает на имя сервера, к которому следует
подключиться.
.TP
--socketid {id}
Только для графического интерфейса GTK: использовать механизм GtkPlug для
запуска gvim в отдельном окне.
.TP
--echo-wid
Только для графического интерфейса GTK: вывести идентификатор окна (Window ID)
в поток стандартного вывода (stdout).
.SH ВСТРОЕННАЯ СПРАВКА
Для начала, наберите команду ":help".
Введите ":help тема", чтобы получить справку по конкретной теме.
Например, команда ":help ZZ" выведет информацию о
Используйте <Tab> и CTRL-D для автоматического дополнения
названий тем (":help cmdline-completion").
Для быстрого перемещения по справочнику используются метки (что-то
вроде гипертекстовых ссылок, см. ":help"). Таким образом можно
просматривать все файлы справки, например ":help syntax.txt".
.SH ФАЙЛЫ
.TP 15
/usr/local/lib/vim/doc/*.txt
Файлы справочника
.B Vim.
См. ":help doc-file-list" для получения полного списка.
.TP
/usr/local/lib/vim/doc/tags
Файл меток, используемый для поиска информации в файлах справки.
.TP
/usr/local/lib/vim/syntax/syntax.vim
Системные настройки синтаксиса.
.TP
/usr/local/lib/vim/syntax/*.vim
Файлы синтаксиса для разных языков.
.TP
/usr/local/lib/vim/vimrc
Системные настройки
.B Vim.
.TP
/usr/local/lib/vim/gvimrc
Системный настройки графического интерфейса.
.TP
/usr/local/lib/vim/optwin.vim
Сценарий, используемый при выполнении команды ":options".
Хороший способ просматривать и изменять настройки.
.TP
/usr/local/lib/vim/menu.vim
Системные настройки меню для gvim.
.TP
/usr/local/lib/vim/bugreport.vim
Сценарий для создания отчёта о б
.TP
/usr/local/lib/vim/filetype.vim
Сценарий для определения типа файла по имени. См. ":help 'filetype'".
.TP
/usr/local/lib/vim/scripts.vim
Сценарий для определения типа файла по содержимому. См. ":help 'filetype'".
.TP
/usr/local/lib/vim/*.ps
Файлы для печати PostScript.
.PP
Более свежая информация -- на сайте VIM:
.br
<URL:http://www.vim.org/>
.SH СМОТРИ ТАКЖЕ
vimtutor(1)
.SH АВТОРЫ
Большая часть
.B Vim
создана Брамом Мооленааром (Bram Moolenaar), которому помогает огромное
количество людей. См. ":help credits" в
.B Vim.
.br
.B Vim
базируется на коде редактора Stevie, написанного Тимом Томпсоном (Tim Thompson),
Тони Эндрюсом (Tony Andrews) и Г. Р
Однако, в настоящее время в Vim почти не осталось ничего от исторического кода
е г о
.br
Русская локализация
.B Vim
выполняется в рамках проекта "РуВим" ,
см. <URL:http://sourceforge.net/projects/ruvim/>.
.SH ГЛЮКИ
Скорее всего есть.
См. ":help todo" -- список известных проблем.
.PP
Заметим, что многие вещи, которые считаются глюками, на самом деле
являются результатом слишком полного воспроизведения поведения Vi.
Если вы думаете, что что-то является ошибкой только потому, что
"Vi делает это по-другому", внимательно прочитайте файл vi_diff.txt
(или наберите ":help vi_diff.txt" в Vim) и используйте опции 'compatible'
и 'cpoptions'.
Bram Moolenaar