blob: e2308e341edc92e093e39bd91ffdfe750d6c078f [file] [log] [blame]
RestorerZ12333ba2024-08-20 19:57:00 +02001.TH VIM 1 "12 августа 2024"
2.SH НАЗНАЧЕНИЕ
3Программа Vim \[em] это Vi IMproved (Улучшенный Vi), текстовый редактор для
4программистов.
5.SH КРАТКИЙ ОБЗОР
Bram Moolenaar2e4096b2005-03-20 22:25:45 +00006.br
7.B vim
RestorerZ12333ba2024-08-20 19:57:00 +02008[аргументы] [файл ...]
Bram Moolenaar2e4096b2005-03-20 22:25:45 +00009.br
10.B vim
RestorerZ12333ba2024-08-20 19:57:00 +020011[аргументы] \-
Bram Moolenaar2e4096b2005-03-20 22:25:45 +000012.br
13.B vim
RestorerZ12333ba2024-08-20 19:57:00 +020014[аргументы] \-t индекс
Bram Moolenaar2e4096b2005-03-20 22:25:45 +000015.br
16.B vim
RestorerZ12333ba2024-08-20 19:57:00 +020017[аргументы] \-q [файл результатов]
Bram Moolenaar2e4096b2005-03-20 22:25:45 +000018.PP
19.br
20.B ex
21.br
22.B view
23.br
24.B gvim
25.B gview
RestorerZ12333ba2024-08-20 19:57:00 +020026.B evim
27.B eview
Bram Moolenaar2e4096b2005-03-20 22:25:45 +000028.br
29.B rvim
30.B rview
31.B rgvim
32.B rgview
33.SH ОПИСАНИЕ
RestorerZ12333ba2024-08-20 19:57:00 +020034Программа
Bram Moolenaar2e4096b2005-03-20 22:25:45 +000035.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +020036\[em] это текстовый редактор, совместимый с редактором Vi.
37Она может быть использована для правки всех видов обычных текстовых документов.
38Особенно полезна она будет для редактирования исходных текстов программ.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +000039.PP
RestorerZ12333ba2024-08-20 19:57:00 +020040По сравнению с редактором Vi, в редакторе
Bram Moolenaar2e4096b2005-03-20 22:25:45 +000041.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +020042представлено много усовершенствований: многократная отмена операций,
Bram Moolenaar2e4096b2005-03-20 22:25:45 +000043множественность окон и буферов, подсветка синтаксиса, правка командной строки,
RestorerZ12333ba2024-08-20 19:57:00 +020044подстановка наименований файлов, встроенная документация, визуальное выделение
45и прочее.
46См. ":help vi_diff.txt" чтобы ознакомиться с полным перечнем различий между
47редактором
Bram Moolenaar2e4096b2005-03-20 22:25:45 +000048.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +020049и редактором Vi.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +000050.PP
RestorerZ12333ba2024-08-20 19:57:00 +020051Чтобы получить полезную информацию о работе с редактором
52.B Vim,
53можно воспользоваться встроенной в программу документацией, набрав в редакторе
54команду ":help".
55См. раздел "ВСТРОЕННАЯ ДОКУМЕНТАЦИЯ" далее в тексте.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +000056.PP
RestorerZ12333ba2024-08-20 19:57:00 +020057Чаще всего редактор
Bram Moolenaar2e4096b2005-03-20 22:25:45 +000058.B Vim
59запускают для правки одного файла при помощи команды
60.PP
61 vim файл
62.PP
RestorerZ12333ba2024-08-20 19:57:00 +020063В общем виде команда запуска редактора
Bram Moolenaar2e4096b2005-03-20 22:25:45 +000064.B Vim
65выглядит так:
66.PP
RestorerZ12333ba2024-08-20 19:57:00 +020067 vim [аргументы] [файлы]
Bram Moolenaar2e4096b2005-03-20 22:25:45 +000068.PP
RestorerZ12333ba2024-08-20 19:57:00 +020069Если файлы не указаны, редактор будет запущен с доступным для редактирования
70пустым буфером.
71Наименования файлов могут быть указаны одним из следующих четырёх способов:
Bram Moolenaar2e4096b2005-03-20 22:25:45 +000072.TP 12
RestorerZ12333ba2024-08-20 19:57:00 +020073файл ...
74Перечень наименований файлов.
75Первый файл из перечня будет объявлен активным и загружен в буфер, а каретка
76установлена на первой строке этого буфера. Доступ к другим файлам из этого
77перечня может быть осуществлён при помощи команды ":next". Чтобы править файл,
78наименование которого начинается с символа "дефис" (\-), перед перечнем файлов
79необходимо указать символы "\-\-".
Bram Moolenaar2e4096b2005-03-20 22:25:45 +000080.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +010081\-
RestorerZ12333ba2024-08-20 19:57:00 +020082Текст для правки будет считан из потока стандартного ввода. Команды будут
83считываться из стандартного потока диагностики (stderr), который должен
84предоставляться терминалом.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +000085.TP
RestorerZ12333ba2024-08-20 19:57:00 +020086\-t {индекс}
87Файла для правки и начальная позиция каретки зависят от значения "индекса",
88являющийся своего рода меткой goto. Поиск самого {индекса} выполняется в файле
89индексов, а сопоставленный с ним файл будет открыт в редакторе и выполнена
90связанная с этим {индексом} команда.
91Чаще всего этот способ используется для программ на языке Си, где {индекс} может
92быть наименованием функции.
93Файл, содержащий такую функцию, становится активным, а каретка помещается
94в начало этой функции.
95См. ":help tag\-commands".
Bram Moolenaar2e4096b2005-03-20 22:25:45 +000096.TP
RestorerZ12333ba2024-08-20 19:57:00 +020097\-q [файл результатов]
98Начать работу редактора в цикле быстрого исправления текста программ.
99Будет считан [файл результатов] и отображена первая запись из этого файла.
100Если [файл результатов] не указан, то его наименование берётся из значения
101параметра 'errorfile' (по умолчанию для ОС Amiga это "AztecC.Err", а для других
102систем \[em] "errors.err").
103К следующей записи в файле результатов можно перейти по команде ":cn".
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000104См. ":help quickfix".
105.PP
RestorerZ12333ba2024-08-20 19:57:00 +0200106Программа
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000107.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200108ведёт себя по-разному в зависимости от указанной в командной строке команды
109вызова редактора (исполняемый файл при этом может быть одним и тем же).
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000110.TP 10
111vim
RestorerZ12333ba2024-08-20 19:57:00 +0200112Это "нормальный" запуск редактора, всё по умолчанию.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000113.TP
114ex
RestorerZ12333ba2024-08-20 19:57:00 +0200115Запуск редактора в Ex-режиме. Для переключения в обычный режим, необходимо
116набрать команду ":vi".
117Ex-режим также может быть активирован через аргумент "\-e".
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000118.TP
119view
RestorerZ12333ba2024-08-20 19:57:00 +0200120Запуск редактора в режиме "только для чтения". В этом режиме есть некоторая
121защита от случайной перезаписи файлов.
122То же самое можно сделать через указание аргумента "\-R".
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000123.TP
124gvim gview
RestorerZ12333ba2024-08-20 19:57:00 +0200125Запуск редактора с графическим интерфейсом. Для этого будет открыто новое окно.
126То же самое можно сделать при запуске с аргументом "\-g".
127.TP
128evim eview
129Упрощённый вариант редактора с графическим интерфейсом. Запускается в новом окне.
130То же самое можно сделать через аргумент "\-y".
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000131.TP
132rvim rview rgvim rgview
RestorerZ12333ba2024-08-20 19:57:00 +0200133Как и предыдущие команды, но с некоторыми ограничениями в функциональности.
134Нельзя запускать команды оболочки или приостанавливать работу редактора
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000135.B Vim.
RestorerZ12333ba2024-08-20 19:57:00 +0200136Вместо приставки "r" можно использовать аргумент командной строки "\-Z".
137.SH АРГУМЕНТЫ КОМАНДНОЙ СТРОКИ
138Аргументы могут быть указаны в любом порядке, до или после наименований файлов.
139Аргументы, не требующие значений, могут быть объединены с указанием только
140одного дефиса.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000141.TP 12
142+[номер]
RestorerZ12333ba2024-08-20 19:57:00 +0200143Установка каретки на [номер] строки.
144В первом открытом файле каретка будет установлена на строку с указанным номером.
145Если "номер" не задан, каретка устанавливается на последней строке файла.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000146.TP
147+/{шаблон}
RestorerZ12333ba2024-08-20 19:57:00 +0200148Установка каретки на найденной строке.
149В открытом файле каретка будет установлена в строке первого совпадения
150с указанным шаблоном. См. ":help search\-pattern" для ознакомления с допустимыми
151шаблонами.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000152.TP
153+{команда}
154.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100155\-c {команда}
RestorerZ12333ba2024-08-20 19:57:00 +0200156Исполнение указанной {команды}.
157После загрузки первого файла будет исполнена указанная {команда} как Ex-команда.
158Если в тексте {команда} есть пробелы, то она должна быть заключена в
159двойные кавычки зависимости от используемой командной оболочки).
160Пример:
161vim "+set si" main.c
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000162.br
RestorerZ12333ba2024-08-20 19:57:00 +0200163Примечание. Можно указывать до десяти команд "+" или "\-c".
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000164.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100165\-A
RestorerZ12333ba2024-08-20 19:57:00 +0200166Запуск программы с поддержкой арабской письменности.
167Если программа
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000168.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200169была собрана с поддержкой правки текста с написанием справа налево
170и с поддержкой клавиатуры для арабского языка, то будет выполнен запуск
171редактора
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000172.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200173в режиме работы с арабской письменностью, т. е. установлен параметр 'arabic'.
174В противном случае редактор
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000175.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200176завершит работу с сообщением об ошибке.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000177.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100178\-b
RestorerZ12333ba2024-08-20 19:57:00 +0200179Запуск программы в режиме работы с двоичными данными.
180Производится настройка некоторых параметров, делающих возможной правку
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000181двоичного или исполняемого файла.
182.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100183\-C
RestorerZ12333ba2024-08-20 19:57:00 +0200184Работа в варианте совместимости с редактором Vi.
185Будет установлен параметр 'compatible', и редактор
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000186.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200187будет работать почти как редактор Vi, даже если существует файл ".vimrc".
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000188.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100189\-d
RestorerZ12333ba2024-08-20 19:57:00 +0200190Режим сравнения различий.
191Может быть указано от двух до восьми наименований файлов. В редакторе
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000192.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200193будут открыты все файлы и показаны различия между ними (как vimdiff(1)).
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000194.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200195\-d {устройство}, \-dev {устройство}
196Использовать {устройство} для операций ввода-вывода.
197Открыть {устройство} для использования в качестве терминала (только в ОС Amiga).
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000198Пример:
199"\-d con:20/30/600/150".
200.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200201\-D
202Запуск программы в режиме диагностики.
203Переключение в режим отладки при исполнении первой команды из командного файла.
204.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100205\-e
RestorerZ12333ba2024-08-20 19:57:00 +0200206Запуск программы в Ex-режиме.
207Редактор
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000208.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200209будет работоать в Ex-режиме, тоже, что в командной строке оболочки набрать
210команду "ex".
211.TP
212\-E
213Запуск программы в улучшенном Ex-режиме.
214Редактор
215.B Vim
216будет работать в улучшенном Ex-режиме, это аналогично набору в командной
217оболочке команды "exim".
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000218.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100219\-f
RestorerZ12333ba2024-08-20 19:57:00 +0200220Режим активного приложения.
221Редактор
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000222.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200223с графическим интерфейсом не будет наследоваться и отключаться от командной
224оболочки, в которой выполнена команда его запуска.
225На платформе Amiga редактор
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000226.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200227не будет перезапускаться для создания нового окна. Этот аргумент командной
228строки нужно использовать, когда редактор
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000229.B Vim
230запускается программой, которая должна ждать завершения
231сеанса правки (например, программа для работы с электронной почтой).
RestorerZ12333ba2024-08-20 19:57:00 +0200232На платформе Amiga в этом случае команды ":sh" и ":!" не будут работать.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000233.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100234\-F
RestorerZ12333ba2024-08-20 19:57:00 +0200235Запуск программы с поддержкой персидской письменности.
236Если программа
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000237.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200238была собрана с поддержкой правки текста с написанием справа налево
239и с поддержкой клавиатуры для персидского языка, то будет выполнен запуск
240редактора
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000241.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200242в режиме работы с персидской письменностью, т. е. установлены параметры 'fkmap'
243и 'rightleft'.
244В противном случае редактор
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000245.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200246завершит работу с сообщением об ошибке.
247.br
248Примечание. Поддержка персидской письменности была удалена в версии 8.1.0932.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000249.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100250\-g
RestorerZ12333ba2024-08-20 19:57:00 +0200251Запуск программы с графическим интерфейсом.
252Если программа
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000253.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200254была собрана с поддержкой графического интерфейса, то будет выполнен запуск
255графического интерфейса пользователя.
256В противном случае редактор
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000257.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200258завершит работу с сообщением об ошибке.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000259.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100260\-H
RestorerZ12333ba2024-08-20 19:57:00 +0200261Запуск программы с поддержкой еврейской письменности.
262Если программа
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000263.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200264была собрана с поддержкой правки текста с написанием справа налево
265и с поддержкой клавиатуры для еврейского языка, то будет выполнен запуск
266редактора
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000267.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200268в режиме работы с еврейской письменностью, т. е. установлены параметры 'hkmap'
269и 'rightleft'.
270В противном случае редактор
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000271.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200272завершит работу с сообщением об ошибке.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000273.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200274\-i {файл}
275Использовать в качестве файла подкачки указанный {файл}.
276Через этот аргумент задаётся наименование viminfo-файла (вместо принятого
277по умолчанию ".viminfo"). Здесь же можно отключить использование viminfo-файла
278через указание слова "NONE" (прописными буквами).
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000279.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100280\-l
RestorerZ12333ba2024-08-20 19:57:00 +0200281Запуск программы в режиме Lisp.
282Выполняется установка параметров 'lisp' и 'showmatch'.
283.TP
284\-L
285То же, что и аргумент командной строки \-r.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000286.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100287\-m
RestorerZ12333ba2024-08-20 19:57:00 +0200288Работа без возможности сохранения изменений.
289Выполняется сброс параметра 'write', поэтому становится невозможным записать
290в файл изменения, внесённые в буфер.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000291.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200292\-M
293Работа без возможности внесения изменений в текст.
294Параметры 'modifiable' и 'write' будут отключены, так что изменения будут
295запрещены, и файлы не смогут быть записаны.
296Обратите внимание, что после начала работы редактора, эти параметры можно
297включить, чтобы разрешить внесение изменений.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000298.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100299\-n
RestorerZ12333ba2024-08-20 19:57:00 +0200300Работа без создания файла подкачки.
301В этом случае восстановление при сбое в работе редактора будет невозможно.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000302Удобно для правки файла на очень медленном носителе (например, гибком диске).
RestorerZ12333ba2024-08-20 19:57:00 +0200303То же самое можно сделать командой ":set uc=0". Включение файла подкачки \[em]
304":set uc=200".
305.TP
306\-N
307Работа в варианте неполной совместимости с редактором Vi.
308Будет сброшен параметр 'compatible'.
309Редактор
310.B Vim
311будет работать лучше, но не будет полностью совместим с редактором Vi, даже если
312отсутствует файл начальных настроек (".vimrc").
313.TP
314\-nb
315Назначить программу Vim сервером редактора для ИСР NetBeans. Подробности
316смотрите в документации.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000317.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100318\-o[N]
RestorerZ12333ba2024-08-20 19:57:00 +0200319Создать для N файлов отдельные окна, расположенные по горизонтали.
320Если N не указано, то создаётся по одному окну на каждый файл.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000321.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100322\-O[N]
RestorerZ12333ba2024-08-20 19:57:00 +0200323Создать для N файлов отдельные окна, расположенные по вертикали.
324Если N не указано, то создаётся по одному окну на каждый файл.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000325.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200326\-p[N]
327Создать для N файлов отдельные вкладки.
328Если N не указано, то создаётся по одной вкладке на каждый файл.
329.TP
330\-P {заголовок окна}
331Открыть программу в многодокументном приложении.
332Только для ГИП в MS Windows. Задаёт заголовок окна родительского приложения.
333Если возможно, то программа Vim будет запущена внутри окна многодокументного
334приложения. Многодокументное приложение должно иметь указанный {заголовок окна}.
335Убедитесь, что этот {заголовок окна} уникален для приложения. Обращаем внимание,
336что реализация данного функционала всё ещё не до конца отработана. Внедрение
337программы возможно не во все приложения и не поддерживается меню окна.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000338.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100339\-r
RestorerZ12333ba2024-08-20 19:57:00 +0200340Вывод перечня файлов подкачки и завершение работы.
341Будут показаны доступные файлы подкачки и информация об их использовании
342для восстановления в случае сбоя.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000343.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100344\-r {файл}
RestorerZ12333ba2024-08-20 19:57:00 +0200345Восстановление аварийно завершённого сеанса.
346Для восстановления после сбоя в работе будет использован указанный файл подкачки.
347Файл подкачки имеет то же наименование, что и редактируемый текстовый файл,
348но с добавлением расширения ".swp".
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000349См. ":help recovery".
350.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200351\-R
352Работа в варианте только для чтения.
353Будет установлен параметр 'readonly'.
354Файл в буфере доступен для редактирования, но его копию на диске нельзя
355случайно перезаписать. Для сохранения файла необходимо добавить восклицательный
356знак к соответствующей Ex-команде (например, ":w!").
357При задании аргумента "\-R" также подразумевается, что используется и аргумент
358"\-n" (см. выше).
359Параметр 'readonly' может быть сброшен по команде ":set noro".
360См. ":help 'readonly'".
361.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100362\-s
RestorerZ12333ba2024-08-20 19:57:00 +0200363Тихий режим.
364Только при запуске в командной оболочке как программы "ex" или если перед
365аргументом "\-s" указан аргумент "\-e".
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000366.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200367\-s {командный файл}
368Считывание команд режима команд из {командного файла}.
369Содержимое файла воспринимается в виде команд, как если бы они были набраны
370непосредственно в редакторе.
371То же самое достигается командой ":source! {командный файл}".
372Если после исполнения всех команд из {командного файла} работа редактора
373продолжается, то дальнейший ввод команд и текста ожидается с клавиатуры.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000374.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200375\-S {файл}
376Исполнение указанного {файла}.
377После загрузки в буфер первого файла, будет исполнен указанный командный {файл}.
378Это аналогично команде в командной строке \-c "source {файл}".
379Наименование {файла} не может начинаться с символа '\-'.
380Если не указан {файл}, то будет исполнен файл "Session.vim" (это будет работать
381только если аргумент \-S является последним в командной строке).
382.TP
383\-T {терминал}
384Назначить указанный тип {терминала}.
385Редактору
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000386.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200387будет передан тип используемого терминала.
388Необходимо только в тех ситуациях, когда автоматическое определение терминала
389не работает. Наименование терминала должно быть известно редактору
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000390.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200391(предопределено в редакторе) либо указано в базе termcap или terminfo.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000392.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200393\-u {файл}
394Использовать для начальной настройки указанный командный {файл}.
395Все остальные файлы настроек игнорируются.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000396Удобно для редактирования специальных типов файлов.
RestorerZ12333ba2024-08-20 19:57:00 +0200397Через этот аргумент можно также отключить обработку всех файлов начальной
398настройки, используйте для этого слово "NONE" (прописными буквами).
399См. ":help initialization".
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000400.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200401\-U {файл}
402Использовать для начальной настройки графического интерфейса указанный
403командный {файл}.
404Все остальные файлы настроек для графического интерфейса игнорируются.
405Через этот аргумент можно также отключить обработку всех файлов настройки
406графического интерфейса, используйте для этого слово "NONE" (прописными буквами).
407См. ":help gui\-init".
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000408.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100409\-v
RestorerZ12333ba2024-08-20 19:57:00 +0200410Запуск программы в режиме Vi.
411Редактор
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000412.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200413будет работать в режиме редактора Vi, как будто исполняемый файл называется "vi".
414Имеет смысл только если исполняемый файл называется "ex".
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000415.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200416\-V[N]
417Режим подробного вывода.
418Будут выводиться сообщения о том, какие командные файлы исполняются, и какая
419информация считывается и записывается в viminfo-файле. Необязательное число N
420задаёт уровень детализации информации. По умолчанию это значение установлено
421равным 10.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000422.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200423\-V[N]{файл}
424Аналогично аргументу \-V, а также выполняется установка параметру 'verbosefile'
425значение {файл}. Как результат, сообщения будут записываться в {файл}, а не
426отображаться на экране. Наименование {файла} не может начинаться с какой-либо
427цифры.
428.TP
429\-w{число}
430Для параметра 'window' будет установлено значение, равное указанному {числу}.
431.TP
432\-w {файл}
433Добавление всех введённых команд в {файл}.
434Все символы, введённые с клавиатуры вплоть до момента завершения работы
435редактора, записываются в {файл}.
436Удобно в том случае, когда вы хотите создать командный файл для последующего
437его использования в командной строке "vim \-s" или в команде ":source!".
438Если {файл} уже существует, то набранный текст будет добавляются в конец файла.
439.TP
440\-W {файл}
441Запись всех введённых команд в {файл}.
442Как аргумент "\-w", но существующий {файл} будет перезаписан.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000443.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100444\-x
RestorerZ12333ba2024-08-20 19:57:00 +0200445Редактирование шифрованных файлов.
446Если редактор
447.B Vim
448был собран с поддержкой шифрования, то выполнять шифрование при записи файлов.
449Будет выдано приглашение ввести пароль.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000450.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100451\-X
RestorerZ12333ba2024-08-20 19:57:00 +0200452Запуск программы без подключения к X-серверу.
453Ускоряет загрузку в консоли, но делает невозможным использование заголовка окна
454и буфера обмена.
455.TP
456\-y
457Работа в упрощённом варианте.
458Редактор
459.B Vim
460будет работать в упрощённом варианте, как будто исполняемый файл имеет название
461"evim" или "eview".
462Поведение редактора
463.B Vim
464будет походить на редакторы, созданные по безрежимному принципу работы.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000465.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100466\-Z
RestorerZ12333ba2024-08-20 19:57:00 +0200467Работа с ограничением функциональности.
468Работает так же, как и запуск исполняемого файла, наименование которого
469начинается с буквы "r".
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000470.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100471\-\-
RestorerZ12333ba2024-08-20 19:57:00 +0200472Означает окончание ввода аргументов.
473Все что указано после этого в командной строке, считается наименованиями файлов.
474Может быть использовано для правки файлов, наименования которых начинаются с
475дефиса.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000476.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200477\-\-clean
478При работе редактора не использовать пользовательскую конфигурацию (файлы vimrc,
479подключаемые модули и т. п.). Полезно для проверки, что проблема в работе
480редактора не возникнет с предустановленными настройками программы Vim.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000481.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200482\-\-cmd {команда}
483Как аргумент "\-c", но команда исполняется перед обработкой любого файла
484настроек (vimrc).
485Можно указывать до десяти таких команд, независимо от количества команд "\-c".
486.TP
487\-\-echo\-wid
488Только для графического интерфейса GTK. Отобразить идентификатор окна
489(Window ID) в поток стандартного вывода (stdout).
490.TP
491\-\-gui\-dialog\-file {файл}
492При работе редактора в графическом интерфейсе пользователя, заголовок
493и сообщение диалогового окна будут записаны в {файл} без отображения на экране.
494Если указанный {файл} не существует, то он будет создан, а при его наличии
495сообщения будут дописываться в этот {файл}. Данный аргумент полезен только для
496тестирования работы редактора, чтобы избежать остановки программы, так как
497отображаемое диалоговое окно может быть скрыто. Если не поддерживается
498графический интерфейс пользователя, то этот аргумент игнорируется программой.
499.TP
500\-\-help, \-h, \-?
501Будет показана краткая информация об аргументах и параметрах командной строки.
502После этого редактор
503.B Vim
504завершит работу.
505.TP
506\-\-literal
507Данный аргумент указывает, что требуется воспринимать наименования файлов
508буквально, и не выполнять разбор подстановочных символов.
509Этот аргумент командной строки неприменим в Unix-подобных системах, где разбор
510подстановочных символов выполняется командной оболочкой.
511.TP
512\-\-log {файл}
513Будет выполнена запись протокола работы с этапа инициализации программы.
514Если при сборке программы
515.B Vim
516были включены компоненты "eval" и "channel", будет выполняться протоколирование
517работы с самой ранней стадии запуска программы, а журнал записываться в {файл}.
518Это работает аналогично вызову функции
519.I ch_logfile({filename}, 'ao')
520.TP
521\-\-nofork
522Режим активного приложения.
523Редактор
524.B Vim
525с графическим интерфейсом не будет наследоваться и отключаться
526от командной оболочки, в которой выполнена команда его запуска.
527.TP
528\-\-noplugin
529Будет выполнен запуск программы без загрузки внешних подключаемых модулей.
530Это же подразумевается при указании аргумента \-u NONE.
531.TP
532\-\-not\-a\-term
533Не сообщать об отсутствии терминала для ввода-вывода.
534Через этот аргумент указывается, что операции ввода-вывода осуществляются не
535на терминал. Это позволяет избежать предупреждающего сообщения и двухсекундной
536задержки, которые могли бы возникнуть.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000537.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100538\-\-remote
RestorerZ12333ba2024-08-20 19:57:00 +0200539Будет выполнено подключение к Vim-серверу и передача для правки файлов,
540указанных в последующих аргументах. Если сервер не найден, выводится
541предупреждение, а правка файлов выполняется в текущей копии редактора Vim.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000542.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100543\-\-remote\-expr {выражение}
RestorerZ12333ba2024-08-20 19:57:00 +0200544Будет выполнено подключение к Vim-серверу и передача указанного {выражение} для
545вычисления.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000546Результат вычисления будет выведен в поток стандартного вывода (stdout).
547.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200548\-\-remote\-send {код клавиши}
549Будет выполнено подключение к Vim-серверу и передача указанных {кодов клавиш}.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000550.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100551\-\-remote\-silent
552Как "\-\-remote", но без вывода предупреждения, если сервер не найден.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000553.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100554\-\-remote\-wait
RestorerZ12333ba2024-08-20 19:57:00 +0200555Как "\-\-remote", но редактор Vim не будет завершать работу до тех пор,
556пока не будет выполнена правка всех файлов.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000557.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100558\-\-remote\-wait\-silent
559Как "\-\-remote\-wait", но без вывода предупреждения, если сервер не найден.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000560.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100561\-\-serverlist
RestorerZ12333ba2024-08-20 19:57:00 +0200562Будет выведен перечень всех доступных Vim-серверов.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000563.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200564\-\-servername {название}
565Использовать указанное {название} в качестве наименования сервера. Если аргумент
566"\-\-remote" не указан, то {название} присваивается данной копии редактора Vim,
567в противном случае указывает на сервер, к которому следует подключиться.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000568.TP
Bram Moolenaar8f3f58f2010-01-06 20:52:26 +0100569\-\-socketid {id}
RestorerZ12333ba2024-08-20 19:57:00 +0200570Только для графического интерфейса GTK. Будет использован механизм GtkPlug для
571запуска редактора gVim в отдельном окне.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000572.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200573\-\-startuptime {файл}
574Будет выполнена запись хронометража запуска программы в {файл}.
575.TP
576\-\-ttyfail
577Будт сразу же завершена работа, если ввод-вывод получен не с терминала (tty).
578.TP
579\-\-version
580Будет выведена информация о версии программы и завершена работа.
581.TP
582\-\-windowid {ИД}
583Только для графического интерфейса в MS Windows. Редактор gVim будет
584использовать окно с указанным {ИД} в качестве родительского, чтобы попытаться
585выполнить запуск внутри этого окна.
586.SH ВСТРОЕННАЯ ДОКУМЕНТАЦИЯ
587Для начала работы с документацией, наберите в редакторе
588.B Vim
589команду ":help".
590Введите ":help тема", чтобы получить справку по интересующей теме.
591Например, по команде ":help ZZ" будет выведена информация о команде "ZZ".
592Используйте клавиши <TAB> и CTRL+D для подстановки нужного названия темы
593(см. ":help cmdline\-completion").
594Для быстрого перемещения по документации используются индексы (что-то
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000595вроде гипертекстовых ссылок, см. ":help"). Таким образом можно
RestorerZ12333ba2024-08-20 19:57:00 +0200596переходить от одного файла документации к другому, например, ":help syntax.txt".
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000597.SH ФАЙЛЫ
598.TP 15
RestorerZ12333ba2024-08-20 19:57:00 +0200599/usr/local/share/vim/vim??/doc/*.txt
600Файлы документации редактора
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000601.B Vim.
RestorerZ12333ba2024-08-20 19:57:00 +0200602См. ":help doc\-file\-list" для получения полного перечня файлов.
603.br
604Здесь и далее
605.I "vim??"
606означает сокращённую запись номера версии, например, vim91 для версии редактора
607.B Vim 9.1
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000608.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200609/usr/local/share/vim/vim??/doc/tags
610Файл индексов, используемый для поиска информации в файлах документации.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000611.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200612/usr/local/share/vim/vim??/syntax/syntax.vim
613Общесистемные настройки распознавания и подсветки синтаксиса.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000614.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200615/usr/local/share/vim/vim??/syntax/*.vim
616Файлы распознавания и подсветки синтаксиса для различных языков программирования.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000617.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200618/usr/local/share/vim/vimrc
619Общесистемный файл начальной настройки для консольного редактора
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000620.B Vim.
621.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200622~/.vimrc, ~/.vim/vimrc, $XDG_CONFIG_HOME/vim/vimrc
623Пользовательские файлы начальной настройки для консольного редактора
624.B Vim
625(будет использован первый найденный файл из указанных).
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000626.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200627/usr/local/share/vim/gvimrc
628Общесистемный файл начальной настройки для редактора с графическим интерфейсом
629.B gVim.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000630.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200631~/.gvimrc, ~/.vim/gvimrc, $XDG_CONFIG_HOME/vim/gvimrc
632Пользовательские файлы начальной настройки для редактора с графическим
633интерфейсом
634.B gVim
635(будет использован первый найденный файл из указанных).
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000636.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200637/usr/local/share/vim/vim??/optwin.vim
638Командный файл, используемый при выполнении команды ":options".
639По этой команде предоставляется удобный способ просмотра и изменения настроек.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000640.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200641/usr/local/share/vim/vim??/menu.vim
642Системные настройки меню для графического интерфейса редактора
643.B gVim.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000644.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200645/usr/local/share/vim/vim??/bugreport.vim
646Командный файл для создания отчёта об обнаруженных ошибках. См. ":help bugs".
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000647.TP
RestorerZ12333ba2024-08-20 19:57:00 +0200648/usr/local/share/vim/vim??/filetype.vim
649Командный файл для распознавания типов файлов по наименованию.
650См. ":help 'filetype'".
651.TP
652/usr/local/share/vim/vim??/scripts.vim
653Командный файл для распознавания типов файлов по содержимому.
654См. ":help 'filetype'".
655.TP
656/usr/local/share/vim/vim??/print/*.ps
657Файлы, используемые для печати через интерфейс PostScript.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000658.PP
RestorerZ12333ba2024-08-20 19:57:00 +0200659Всю последнюю информацию о редакторе можно получить на веб-странице VIM:
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000660.br
661<URL:http://www.vim.org/>
RestorerZ12333ba2024-08-20 19:57:00 +0200662.SH СМОТРИТЕ ТАКЖЕ
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000663vimtutor(1)
664.SH АВТОРЫ
RestorerZ12333ba2024-08-20 19:57:00 +0200665Большая часть редактора
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000666.B Vim
RestorerZ12333ba2024-08-20 19:57:00 +0200667была создана Брамом Моленаром (Bram Moolenaar), которому помогало огромное
668количество людей. См. ":help credits" в редакторе
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000669.B Vim.
670.br
RestorerZ12333ba2024-08-20 19:57:00 +0200671Редактор
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000672.B Vim
673базируется на коде редактора Stevie, написанного Тимом Томпсоном (Tim Thompson),
674Тони Эндрюсом (Tony Andrews) и Г. Р. (Фредом) Уолтером (G.R. (Fred) Walter).
RestorerZ12333ba2024-08-20 19:57:00 +0200675Однако, в настоящее время в программе Vim почти ничего не осталось
676от исторического кода его предшественника.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000677.br
RestorerZ12333ba2024-08-20 19:57:00 +0200678Русская локализация редактора
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000679.B Vim
680выполняется в рамках проекта "РуВим",
RestorerZ12333ba2024-08-20 19:57:00 +0200681см. <URL:https://github.com/restorerz/ruvim/>.
682.SH ОШИБКИ
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000683Скорее всего есть.
RestorerZ12333ba2024-08-20 19:57:00 +0200684См. ":help todo" \[em] перечень известных ошибок в работе.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000685.PP
RestorerZ12333ba2024-08-20 19:57:00 +0200686Заметим, что многие вещи, которые считаются ошибками, на самом деле
687являются результатом слишком полного воспроизведения поведения редактора Vi.
Bram Moolenaar2e4096b2005-03-20 22:25:45 +0000688Если вы думаете, что что-то является ошибкой только потому, что
689"Vi делает это по-другому", внимательно прочитайте файл vi_diff.txt
RestorerZ12333ba2024-08-20 19:57:00 +0200690(или наберите ":help vi_diff.txt" в редакторе Vim) и посмотрите параметры
691 'compatible' и 'cpoptions'.