| .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 |
| -- текстовый редактор, обратно-совместимый с Vi. |
| Он может быть использован для правки всех видов простого текста. |
| Особенно он хорош для правки исходных текстов программ. |
| .PP |
| По сравнению с Vi, |
| .B Vim |
| имеет много усовершенствований: многократная отмена операций, |
| множественность окон и буферов, подсветка синтаксиса, правка командной строки, |
| автодополнение имён файлов, встроенная справка, визуальное выделение и т.п. |
| См. ":help vi_diff.txt" для получения полного списка различий между |
| .B Vim |
| и Vi. |
| .PP |
| Во время работы в |
| .B Vim |
| можно получить справку с помощью системы встроенной справки (команда ":help"). |
| См. раздел "ВСТРОЕННАЯ СПРАВКА" ниже по тексту. |
| .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" для других систем). |
| К следующим ошибкам можно перейти по команде ":cn". |
| См. ":help quickfix". |
| .PP |
| .B Vim |
| ведёт себя по-разному в зависимости от имени команды (исполняемый файл может |
| быть одним и тем же). |
| .TP 10 |
| vim |
| "Нормальный" запуск, всё по умолчанию. |
| .TP |
| ex |
| Запуск в режиме Ex. Для перехода в нормальный режим |
| необходимо выполнить команду ":vi". Режим Ex включает |
| также ключ "-e". |
| .TP |
| view |
| Запуск в режиме "только для чтения". Вы будете защищены от случайной записи |
| файла. То же самое можно сделать ключом "-R". |
| .TP |
| gvim gview |
| Версия с графическим интерфейсом. Запускается в новом окне. |
| То же самое можно сделать при запуске с ключом "-g". |
| .TP |
| rvim rview rgvim rgview |
| Как и предыдущие команды, но с ограничениями. Нельзя запускать команды оболочки |
| или приостанавливать работу |
| .B Vim. |
| Вместо приставки "r" можно использовать ключ "-Z". |
| .SH КЛЮЧИ |
| Ключи могут быть указаны в любом порядке, до или после имён |
| файлов. Ключи без аргументов могут быть объединены под одним |
| дефисом. |
| .TP 12 |
| +[номер] |
| В первом файле курсор будет помещён на строку с указанным номером. |
| Если "номер" не указан, курсор будет помещён на последнюю строку. |
| .TP |
| +/{шаблон} |
| В первом файле курсор будет помещён на место первого совпадения |
| с указанным шаблоном. См. ":help search-pattern" для получения |
| списка допустимых шаблонов. |
| .TP |
| +{команда} |
| .TP |
| -c {команда} |
| {команда} исполняется после загрузки первого файла как команда Ex. |
| Если {команда} содержит пробелы, то она должна быть заключена в |
| двойные кавычки (в зависимости от используемой оболочки). |
| Пример: vim "+set si" main.c |
| .br |
| Примечание: Можно указывать до десяти команд "+" или "-c". |
| .TP |
| --cmd {команда} |
| Как "-c", но команда исполняется перед обработкой любого файла |
| настроек (vimrc). |
| Можно указывать до десяти таких команд, независимо от количества |
| команд "-c". |
| .TP |
| -A |
| Если |
| .B Vim |
| был собран с поддержкой арабского языка для правки файлов, |
| набранных справа налево, и с поддержкой арабской клавиатуры, |
| этот ключ запускает |
| .B Vim |
| в арабском режиме, с включенной опцией 'arabic'. В противном |
| случае |
| .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 |
| с графическим интерфейсом не будет ветвиться и отключаться |
| от запустившей её оболочки. На платформе Amiga |
| .B Vim |
| не будет создавать новое окно. Этот ключ нужно использовать, |
| когда |
| .B Vim |
| запускается программой, которая должна ждать завершения |
| сеанса правки (например, программа для работы с электронной почтой). |
| На платформе Amiga команды ":sh" и ":!" не будут работать. |
| .TP |
| --nofork |
| Режим активного приложения. Версия |
| .B Vim |
| с графическим интерфейсом не будет ветвиться и отключаться |
| от запустившей её оболочки. |
| .TP |
| -F |
| Если |
| .B Vim |
| был собран с поддержкой FKMAP для правки текста справа налево |
| и настроек клавиатуры для языка фарси, этот ключ запускает |
| .B Vim |
| в режиме фарси, иначе говоря, с включёнными опциями |
| 'fkmap' и 'rightleft'. |
| В противном случае |
| .B Vim |
| завершает работу с сообщением об ошибке. |
| .TP |
| -g |
| Если |
| .B Vim |
| был собран с поддержкой графического интерфейса, этот ключ |
| включает графический интерфейс. В противном случае |
| .B Vim |
| завершает работу с сообщением об ошибке. |
| .TP |
| -h |
| Выводит краткую информацию об аргументах и ключах командной строки. |
| После этого |
| .B Vim |
| завершает работу. |
| .TP |
| -H |
| Если |
| .B Vim |
| был собран с поддержкой правки текста справа налево |
| и настроек клавиатуры для иврита, этот ключ запускает |
| .B Vim |
| в режиме иврита, иначе говоря, с включёнными опциями 'hkmap' и 'rightleft'. |
| В противном случае |
| .B Vim |
| завершает работу с сообщением об ошибке. |
| .TP |
| -i {viminfo} |
| Если используется файл viminfo, то этот ключ задаёт имя такого файла (вместо |
| "~/.viminfo" по умолчанию). Можно также избежать использования файла viminfo |
| путём указания имени "NONE". |
| .TP |
| -L |
| То же, что и -r. |
| .TP |
| -l |
| Режим Lisp. Включаются опции 'lisp' и 'showmatch'. |
| .TP |
| -m |
| Изменение файлов запрещено. При этом отключается опция 'write', поэтому |
| запись файлов становится невозможной. |
| .TP |
| -N |
| Режим неполной совместимости. Отключается 'compatible'. |
| .B Vim |
| будет работать лучше, но не будет полностью совместим с Vi, даже если |
| отсутствует файл сценария настроек (.vimrc). |
| .TP |
| -n |
| Не использовать своп-файл. Восстановление при сбое в работе будет невозможно. |
| Удобно для правки файла на очень медленном носителе (например, гибком диске). |
| То же самое можно сделать командой ":set uc=0". Отмена -- ":set uc=200". |
| .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 {файл} |
| Режим восстановления. |
| Для восстановления после сбоя будет использован своп-файл. |
| Своп-файл имеет то же имя, что и текстовый файл, но с добавлением расширения ".swp". |
| См. ":help recovery". |
| .TP |
| -s |
| Тихий режим. Только при запуске как "Ex" или если перед "-s" указан ключ "-e". |
| .TP |
| -s {scriptin} |
| Считывается файл сценария {scriptin}. При этом, содержимое файла воспринимается |
| в виде команд, как если бы они были набраны на консоли. |
| То же самое достигается командой ":source! {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}. |
| Удобно в том случае, когда вы хотите создать файл сценария для последующего |
| использования с "vim -s" или ":source!". Если файл {scriptout} уже существует, |
| то новые символы будут добавляются в конец файла. |
| .TP |
| -W {scriptout} |
| Как "-w", но уже существующий файл будет перезаписан. |
| .TP |
| -x |
| Шифровать записываемые файлы. Будет выдано приглашение ввести пароль. |
| .TP |
| -X |
| Не подключаться к X-серверу. Ускоряет загрузку на консоли, но делает невозможным |
| использование заголовка окна и буфера обмена. |
| .TP |
| -Z |
| Ограниченный режим. Работает так же, как и программы, начинающиеся с "r". |
| .TP |
| -- |
| Конец ключей. Все остальные аргументы рассматриваются как имена файлов. |
| Может быть использовано для правки файлов, имена которых начинаются с дефиса. |
| .TP |
| --help |
| Вывести краткую справку и завершить работу. То же, что и "-h". |
| .TP |
| --version |
| Вывести информацию о версии программы и завершить работу. |
| .TP |
| --remote |
| Подключиться к серверу Vim и заставить его править файлы, указанные в |
| последующих аргументах. Если сервер не найден, выводится предупреждение, |
| а файлы правятся в местной копии 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" выведет информацию о команде "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 |
| Сценарий для создания отчёта об обнаруженных глюках. См. ":help bugs". |
| .TP |
| /usr/local/lib/vim/filetype.vim |
| Сценарий для определения типа файла по имени. См. ":help 'filetype'". |
| .TP |
| /usr/local/lib/vim/scripts.vim |
| Сценарий для определения типа файла по содержимому. См. ":help 'filetype'". |
| .TP |
| /usr/local/lib/vim/print/*.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) и Г. Р. (Фредом) Уолтером (G.R. (Fred) Walter). |
| Однако, в настоящее время в 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'. |