diff options
Diffstat (limited to '')
| -rw-r--r-- | runtime/doc/vim-ru.1 | 794 |
1 files changed, 498 insertions, 296 deletions
diff --git a/runtime/doc/vim-ru.1 b/runtime/doc/vim-ru.1 index dfcb3ec..4aa4887 100644 --- a/runtime/doc/vim-ru.1 +++ b/runtime/doc/vim-ru.1 @@ -1,19 +1,20 @@ -.TH VIM 1 "2002 Feb 22" -.SH ИМЯ -vim \- Vi IMproved (Улучшенный Vi), текстовый редактор для программистов -.SH КОМАНДНАЯ СТРОКА +.TH VIM 1 "12 августа 2024" +.SH НАЗНАЧЕНИЕ +Программа Vim \[em] это Vi IMproved (Улучшенный Vi), текстовый редактор для +программистов. +.SH КРАТКИЙ ОБЗОР .br .B vim -[ключи] [файл ..] +[аргументы] [файл ...] .br .B vim -[ключи] \- +[аргументы] \- .br .B vim -[ключи] \-t метка +[аргументы] \-t индекс .br .B vim -[ключи] \-q [файл ошибок] +[аргументы] \-q [файл результатов] .PP .br .B ex @@ -22,468 +23,669 @@ vim \- Vi IMproved (Улучшенный Vi), текстовый редактор для программистов .br .B gvim .B gview +.B evim +.B eview .br .B rvim .B rview .B rgvim .B rgview .SH ОПИСАНИЕ +Программа .B Vim --- текстовый редактор, обратно-совместимый с Vi. -Он может быть использован для правки всех видов простого текста. -Особенно он хорош для правки исходных текстов программ. +\[em] это текстовый редактор, совместимый с редактором Vi. +Она может быть использована для правки всех видов обычных текстовых документов. +Особенно полезна она будет для редактирования исходных текстов программ. .PP -По сравнению с Vi, +По сравнению с редактором Vi, в редакторе .B Vim -имеет много усовершенствований: многократная отмена операций, +представлено много усовершенствований: многократная отмена операций, множественность окон и буферов, подсветка синтаксиса, правка командной строки, -автодополнение имён файлов, встроенная справка, визуальное выделение и т.п. -См. ":help vi_diff.txt" для получения полного списка различий между +подстановка наименований файлов, встроенная документация, визуальное выделение +и прочее. +См. ":help vi_diff.txt" чтобы ознакомиться с полным перечнем различий между +редактором .B Vim -и Vi. +и редактором Vi. .PP -Во время работы в -.B Vim -можно получить справку с помощью системы встроенной справки (команда ":help"). -См. раздел "ВСТРОЕННАЯ СПРАВКА" ниже по тексту. +Чтобы получить полезную информацию о работе с редактором +.B Vim, +можно воспользоваться встроенной в программу документацией, набрав в редакторе +команду ":help". +См. раздел "ВСТРОЕННАЯ ДОКУМЕНТАЦИЯ" далее в тексте. .PP -Чаще всего +Чаще всего редактор .B Vim запускают для правки одного файла при помощи команды .PP vim файл .PP -В общем виде команда запуска +В общем виде команда запуска редактора .B Vim выглядит так: .PP - vim [ключи] [список файлов] + vim [аргументы] [файлы] .PP -Если список файлов отсутствует, редактор начнёт работу с пустым буфером. -В противном случае имя файла должно быть указано одним из следующих четырёх способов: +Если файлы не указаны, редактор будет запущен с доступным для редактирования +пустым буфером. +Наименования файлов могут быть указаны одним из следующих четырёх способов: .TP 12 -файл .. -Список имён файлов. -Первый файл будет объявлен активным и загружен в буфер. Курсор будет помещён -в первой строке буфера. Доступ к другим файлам может быть осуществлён при -помощи команды ":next". Чтобы править файл, имя которого начинается с символа -"дефис" (-), перед списком файлов необходимо поставить "--". +файл ... +Перечень наименований файлов. +Первый файл из перечня будет объявлен активным и загружен в буфер, а каретка +установлена на первой строке этого буфера. Доступ к другим файлам из этого +перечня может быть осуществлён при помощи команды ":next". Чтобы править файл, +наименование которого начинается с символа "дефис" (\-), перед перечнем файлов +необходимо указать символы "\-\-". .TP \- -Файл будет прочитан из потока стандартного ввода. Команды будут считываться -из стандартного потока диагностики (stderr), который должен быть -терминалом. -.TP -\-t {метка} -Имя файла и начальная позиция курсора зависят от "метки", похожей на метку goto. -{метка} ищется в файле меток, соответствующий файл становится активным, а -соответствующая команда исполняется. -Чаще всего используется в программах на языке Си, где {метка} может быть именем -функции. -Файл, содержащий функцию, становится активным, а курсор помещается в начало функции. -См. ":help tag-commands". -.TP -\-q [файл ошибок] -Начать работу в режиме быстрого исправления. -При этом считывается [файл ошибок] и первая ошибка выводится на экран. -Если [файл ошибок] не указан, имя файла берётся из значения опции 'errorfile' -(по умолчанию: "AztecC.Err" для Amiga, "errors.err" для других систем). -К следующим ошибкам можно перейти по команде ":cn". +Текст для правки будет считан из потока стандартного ввода. Команды будут +считываться из стандартного потока диагностики (stderr), который должен +предоставляться терминалом. +.TP +\-t {индекс} +Файла для правки и начальная позиция каретки зависят от значения "индекса", +являющийся своего рода меткой goto. Поиск самого {индекса} выполняется в файле +индексов, а сопоставленный с ним файл будет открыт в редакторе и выполнена +связанная с этим {индексом} команда. +Чаще всего этот способ используется для программ на языке Си, где {индекс} может +быть наименованием функции. +Файл, содержащий такую функцию, становится активным, а каретка помещается +в начало этой функции. +См. ":help tag\-commands". +.TP +\-q [файл результатов] +Начать работу редактора в цикле быстрого исправления текста программ. +Будет считан [файл результатов] и отображена первая запись из этого файла. +Если [файл результатов] не указан, то его наименование берётся из значения +параметра 'errorfile' (по умолчанию для ОС Amiga это "AztecC.Err", а для других +систем \[em] "errors.err"). +К следующей записи в файле результатов можно перейти по команде ":cn". См. ":help quickfix". .PP +Программа .B Vim -ведёт себя по-разному в зависимости от имени команды (исполняемый файл может -быть одним и тем же). +ведёт себя по-разному в зависимости от указанной в командной строке команды +вызова редактора (исполняемый файл при этом может быть одним и тем же). .TP 10 vim -"Нормальный" запуск, всё по умолчанию. +Это "нормальный" запуск редактора, всё по умолчанию. .TP ex -Запуск в режиме Ex. Для перехода в нормальный режим -необходимо выполнить команду ":vi". Режим Ex включает -также ключ "\-e". +Запуск редактора в Ex-режиме. Для переключения в обычный режим, необходимо +набрать команду ":vi". +Ex-режим также может быть активирован через аргумент "\-e". .TP view -Запуск в режиме "только для чтения". Вы будете защищены от случайной записи -файла. То же самое можно сделать ключом "\-R". +Запуск редактора в режиме "только для чтения". В этом режиме есть некоторая +защита от случайной перезаписи файлов. +То же самое можно сделать через указание аргумента "\-R". .TP gvim gview -Версия с графическим интерфейсом. Запускается в новом окне. -То же самое можно сделать при запуске с ключом "\-g". +Запуск редактора с графическим интерфейсом. Для этого будет открыто новое окно. +То же самое можно сделать при запуске с аргументом "\-g". +.TP +evim eview +Упрощённый вариант редактора с графическим интерфейсом. Запускается в новом окне. +То же самое можно сделать через аргумент "\-y". .TP rvim rview rgvim rgview -Как и предыдущие команды, но с ограничениями. Нельзя запускать команды оболочки -или приостанавливать работу +Как и предыдущие команды, но с некоторыми ограничениями в функциональности. +Нельзя запускать команды оболочки или приостанавливать работу редактора .B Vim. -Вместо приставки "r" можно использовать ключ "\-Z". -.SH КЛЮЧИ -Ключи могут быть указаны в любом порядке, до или после имён -файлов. Ключи без аргументов могут быть объединены под одним -дефисом. +Вместо приставки "r" можно использовать аргумент командной строки "\-Z". +.SH АРГУМЕНТЫ КОМАНДНОЙ СТРОКИ +Аргументы могут быть указаны в любом порядке, до или после наименований файлов. +Аргументы, не требующие значений, могут быть объединены с указанием только +одного дефиса. .TP 12 +[номер] -В первом файле курсор будет помещён на строку с указанным номером. -Если "номер" не указан, курсор будет помещён на последнюю строку. +Установка каретки на [номер] строки. +В первом открытом файле каретка будет установлена на строку с указанным номером. +Если "номер" не задан, каретка устанавливается на последней строке файла. .TP +/{шаблон} -В первом файле курсор будет помещён на место первого совпадения -с указанным шаблоном. См. ":help search-pattern" для получения -списка допустимых шаблонов. +Установка каретки на найденной строке. +В открытом файле каретка будет установлена в строке первого совпадения +с указанным шаблоном. См. ":help search\-pattern" для ознакомления с допустимыми +шаблонами. .TP +{команда} .TP \-c {команда} -{команда} исполняется после загрузки первого файла как команда Ex. -Если {команда} содержит пробелы, то она должна быть заключена в -двойные кавычки (в зависимости от используемой оболочки). -Пример: vim "+set si" main.c +Исполнение указанной {команды}. +После загрузки первого файла будет исполнена указанная {команда} как Ex-команда. +Если в тексте {команда} есть пробелы, то она должна быть заключена в +двойные кавычки (в зависимости от используемой командной оболочки). +Пример: +vim "+set si" main.c .br -Примечание: Можно указывать до десяти команд "+" или "\-c". -.TP -\-\-cmd {команда} -Как "\-c", но команда исполняется перед обработкой любого файла -настроек (vimrc). -Можно указывать до десяти таких команд, независимо от количества -команд "\-c". +Примечание. Можно указывать до десяти команд "+" или "\-c". .TP \-A -Если +Запуск программы с поддержкой арабской письменности. +Если программа .B Vim -был собран с поддержкой арабского языка для правки файлов, -набранных справа налево, и с поддержкой арабской клавиатуры, -этот ключ запускает +была собрана с поддержкой правки текста с написанием справа налево +и с поддержкой клавиатуры для арабского языка, то будет выполнен запуск +редактора .B Vim -в арабском режиме, с включенной опцией 'arabic'. В противном -случае +в режиме работы с арабской письменностью, т. е. установлен параметр 'arabic'. +В противном случае редактор .B Vim -завершает работу с ошибкой. +завершит работу с сообщением об ошибке. .TP \-b -Двоичный режим. -Производится настройка некоторых опций, делающих возможной правку +Запуск программы в режиме работы с двоичными данными. +Производится настройка некоторых параметров, делающих возможной правку двоичного или исполняемого файла. .TP \-C -Режим совместимости. Включает опцию 'compatible'. +Работа в варианте совместимости с редактором Vi. +Будет установлен параметр 'compatible', и редактор .B Vim -будет работать почти как Vi, даже если существует файл .vimrc. +будет работать почти как редактор Vi, даже если существует файл ".vimrc". .TP \-d -Режим поиска различий. -Должно быть указано два или три имени файла. +Режим сравнения различий. +Может быть указано от двух до восьми наименований файлов. В редакторе .B Vim -откроет все файлы и покажет различия между ними -(как vimdiff(1)). +будут открыты все файлы и показаны различия между ними (как vimdiff(1)). .TP -\-d {устройство} -Открыть {устройство} для использования в качестве терминала (только на Amiga). +\-d {устройство}, \-dev {устройство} +Использовать {устройство} для операций ввода-вывода. +Открыть {устройство} для использования в качестве терминала (только в ОС Amiga). Пример: "\-d con:20/30/600/150". .TP +\-D +Запуск программы в режиме диагностики. +Переключение в режим отладки при исполнении первой команды из командного файла. +.TP \-e -Запустить +Запуск программы в Ex-режиме. +Редактор +.B Vim +будет работоать в Ex-режиме, тоже, что в командной строке оболочки набрать +команду "ex". +.TP +\-E +Запуск программы в улучшенном Ex-режиме. +Редактор .B Vim -в режиме Ex, как будто исполняемый файл имеет имя "ex". +будет работать в улучшенном Ex-режиме, это аналогично набору в командной +оболочке команды "exim". .TP \-f -Режим активного приложения. Версия +Режим активного приложения. +Редактор .B Vim -с графическим интерфейсом не будет ветвиться и отключаться -от запустившей её оболочки. На платформе Amiga +с графическим интерфейсом не будет наследоваться и отключаться от командной +оболочки, в которой выполнена команда его запуска. +На платформе Amiga редактор .B Vim -не будет создавать новое окно. Этот ключ нужно использовать, -когда +не будет перезапускаться для создания нового окна. Этот аргумент командной +строки нужно использовать, когда редактор .B Vim запускается программой, которая должна ждать завершения сеанса правки (например, программа для работы с электронной почтой). -На платформе Amiga команды ":sh" и ":!" не будут работать. -.TP -\-\-nofork -Режим активного приложения. Версия -.B Vim -с графическим интерфейсом не будет ветвиться и отключаться -от запустившей её оболочки. +На платформе Amiga в этом случае команды ":sh" и ":!" не будут работать. .TP \-F -Если +Запуск программы с поддержкой персидской письменности. +Если программа .B Vim -был собран с поддержкой FKMAP для правки текста справа налево -и настроек клавиатуры для языка фарси, этот ключ запускает +была собрана с поддержкой правки текста с написанием справа налево +и с поддержкой клавиатуры для персидского языка, то будет выполнен запуск +редактора .B Vim -в режиме фарси, иначе говоря, с включёнными опциями -\&'fkmap' и 'rightleft'. -В противном случае +в режиме работы с персидской письменностью, т. е. установлены параметры 'fkmap' +и 'rightleft'. +В противном случае редактор .B Vim -завершает работу с сообщением об ошибке. +завершит работу с сообщением об ошибке. +.br +Примечание. Поддержка персидской письменности была удалена в версии 8.1.0932. .TP \-g -Если +Запуск программы с графическим интерфейсом. +Если программа .B Vim -был собран с поддержкой графического интерфейса, этот ключ -включает графический интерфейс. В противном случае +была собрана с поддержкой графического интерфейса, то будет выполнен запуск +графического интерфейса пользователя. +В противном случае редактор .B Vim -завершает работу с сообщением об ошибке. -.TP -\-h -Выводит краткую информацию об аргументах и ключах командной строки. -После этого -.B Vim -завершает работу. +завершит работу с сообщением об ошибке. .TP \-H -Если +Запуск программы с поддержкой еврейской письменности. +Если программа .B Vim -был собран с поддержкой правки текста справа налево -и настроек клавиатуры для иврита, этот ключ запускает +была собрана с поддержкой правки текста с написанием справа налево +и с поддержкой клавиатуры для еврейского языка, то будет выполнен запуск +редактора .B Vim -в режиме иврита, иначе говоря, с включёнными опциями 'hkmap' и 'rightleft'. -В противном случае +в режиме работы с еврейской письменностью, т. е. установлены параметры 'hkmap' +и 'rightleft'. +В противном случае редактор .B Vim -завершает работу с сообщением об ошибке. +завершит работу с сообщением об ошибке. .TP -\-i {viminfo} -Если используется файл viminfo, то этот ключ задаёт имя такого файла (вместо -"~/.viminfo" по умолчанию). Можно также избежать использования файла viminfo -путём указания имени "NONE". -.TP -\-L -То же, что и \-r. +\-i {файл} +Использовать в качестве файла подкачки указанный {файл}. +Через этот аргумент задаётся наименование viminfo-файла (вместо принятого +по умолчанию ".viminfo"). Здесь же можно отключить использование viminfo-файла +через указание слова "NONE" (прописными буквами). .TP \-l -Режим Lisp. Включаются опции 'lisp' и 'showmatch'. +Запуск программы в режиме Lisp. +Выполняется установка параметров 'lisp' и 'showmatch'. +.TP +\-L +То же, что и аргумент командной строки \-r. .TP \-m -Изменение файлов запрещено. При этом отключается опция 'write', поэтому -запись файлов становится невозможной. +Работа без возможности сохранения изменений. +Выполняется сброс параметра 'write', поэтому становится невозможным записать +в файл изменения, внесённые в буфер. .TP -\-N -Режим неполной совместимости. Отключается 'compatible'. -.B Vim -будет работать лучше, но не будет полностью совместим с Vi, даже если -отсутствует файл сценария настроек (.vimrc). +\-M +Работа без возможности внесения изменений в текст. +Параметры 'modifiable' и 'write' будут отключены, так что изменения будут +запрещены, и файлы не смогут быть записаны. +Обратите внимание, что после начала работы редактора, эти параметры можно +включить, чтобы разрешить внесение изменений. .TP \-n -Не использовать своп-файл. Восстановление при сбое в работе будет невозможно. +Работа без создания файла подкачки. +В этом случае восстановление при сбое в работе редактора будет невозможно. Удобно для правки файла на очень медленном носителе (например, гибком диске). -То же самое можно сделать командой ":set uc=0". Отмена -- ":set uc=200". +То же самое можно сделать командой ":set uc=0". Включение файла подкачки \[em] +":set uc=200". +.TP +\-N +Работа в варианте неполной совместимости с редактором Vi. +Будет сброшен параметр 'compatible'. +Редактор +.B Vim +будет работать лучше, но не будет полностью совместим с редактором Vi, даже если +отсутствует файл начальных настроек (".vimrc"). +.TP +\-nb +Назначить программу Vim сервером редактора для ИСР NetBeans. Подробности +смотрите в документации. .TP \-o[N] -Открыть N окон, разделённых по горизонтали. Если N не указано, то открывается -по одному окну на каждый файл. +Создать для N файлов отдельные окна, расположенные по горизонтали. +Если N не указано, то создаётся по одному окну на каждый файл. .TP \-O[N] -Открыть N окон, разделённых по вертикали. Если N не указано, то открывается -по одному окну на каждый файл. -.TP -\-R -Режим "только для чтения". Включается опция 'readonly'. -Файл в буфере доступен для редактирования, но его копию на диске нельзя -случайно перезаписать. Для сохранения файла необходимо добавить восклицательный -знак к соответствующей команде Ex (например, ":w!"). -Ключ "\-R" подразумевает также, что используется и ключ "\-n" (см. выше). -Опция 'readonly' может быть выключена по команде ":set noro". -См. ":help 'readonly'". +Создать для N файлов отдельные окна, расположенные по вертикали. +Если N не указано, то создаётся по одному окну на каждый файл. +.TP +\-p[N] +Создать для N файлов отдельные вкладки. +Если N не указано, то создаётся по одной вкладке на каждый файл. +.TP +\-P {заголовок окна} +Открыть программу в многодокументном приложении. +Только для ГИП в MS Windows. Задаёт заголовок окна родительского приложения. +Если возможно, то программа Vim будет запущена внутри окна многодокументного +приложения. Многодокументное приложение должно иметь указанный {заголовок окна}. +Убедитесь, что этот {заголовок окна} уникален для приложения. Обращаем внимание, +что реализация данного функционала всё ещё не до конца отработана. Внедрение +программы возможно не во все приложения и не поддерживается меню окна. .TP \-r -Вывести список своп-файлов и информацию об их использовании для восстановления после сбоя. +Вывод перечня файлов подкачки и завершение работы. +Будут показаны доступные файлы подкачки и информация об их использовании +для восстановления в случае сбоя. .TP \-r {файл} -Режим восстановления. -Для восстановления после сбоя будет использован своп-файл. -Своп-файл имеет то же имя, что и текстовый файл, но с добавлением расширения ".swp". +Восстановление аварийно завершённого сеанса. +Для восстановления после сбоя в работе будет использован указанный файл подкачки. +Файл подкачки имеет то же наименование, что и редактируемый текстовый файл, +но с добавлением расширения ".swp". См. ":help recovery". .TP +\-R +Работа в варианте только для чтения. +Будет установлен параметр 'readonly'. +Файл в буфере доступен для редактирования, но его копию на диске нельзя +случайно перезаписать. Для сохранения файла необходимо добавить восклицательный +знак к соответствующей Ex-команде (например, ":w!"). +При задании аргумента "\-R" также подразумевается, что используется и аргумент +"\-n" (см. выше). +Параметр 'readonly' может быть сброшен по команде ":set noro". +См. ":help 'readonly'". +.TP \-s -Тихий режим. Только при запуске как "Ex" или если перед "\-s" указан ключ "\-e". +Тихий режим. +Только при запуске в командной оболочке как программы "ex" или если перед +аргументом "\-s" указан аргумент "\-e". +.TP +\-s {командный файл} +Считывание команд режима команд из {командного файла}. +Содержимое файла воспринимается в виде команд, как если бы они были набраны +непосредственно в редакторе. +То же самое достигается командой ":source! {командный файл}". +Если после исполнения всех команд из {командного файла} работа редактора +продолжается, то дальнейший ввод команд и текста ожидается с клавиатуры. +.TP +\-S {файл} +Исполнение указанного {файла}. +После загрузки в буфер первого файла, будет исполнен указанный командный {файл}. +Это аналогично команде в командной строке \-c "source {файл}". +Наименование {файла} не может начинаться с символа '\-'. +Если не указан {файл}, то будет исполнен файл "Session.vim" (это будет работать +только если аргумент \-S является последним в командной строке). +.TP +\-T {терминал} +Назначить указанный тип {терминала}. +Редактору +.B Vim +будет передан тип используемого терминала. +Необходимо только в тех ситуациях, когда автоматическое определение терминала +не работает. Наименование терминала должно быть известно редактору +.B Vim +(предопределено в редакторе) либо указано в базе termcap или terminfo. +.TP +\-u {файл} +Использовать для начальной настройки указанный командный {файл}. +Все остальные файлы настроек игнорируются. +Удобно для редактирования специальных типов файлов. +Через этот аргумент можно также отключить обработку всех файлов начальной +настройки, используйте для этого слово "NONE" (прописными буквами). +См. ":help initialization". +.TP +\-U {файл} +Использовать для начальной настройки графического интерфейса указанный +командный {файл}. +Все остальные файлы настроек для графического интерфейса игнорируются. +Через этот аргумент можно также отключить обработку всех файлов настройки +графического интерфейса, используйте для этого слово "NONE" (прописными буквами). +См. ":help gui\-init". .TP -\-s {scriptin} -Считывается файл сценария {scriptin}. При этом, содержимое файла воспринимается -в виде команд, как если бы они были набраны на консоли. -То же самое достигается командой ":source! {scriptin}". -Если конец файла считывается до завершения работы редактора, то в дальнейшем -ввод осуществляется с клавиатуры. +\-v +Запуск программы в режиме Vi. +Редактор +.B Vim +будет работать в режиме редактора Vi, как будто исполняемый файл называется "vi". +Имеет смысл только если исполняемый файл называется "ex". +.TP +\-V[N] +Режим подробного вывода. +Будут выводиться сообщения о том, какие командные файлы исполняются, и какая +информация считывается и записывается в viminfo-файле. Необязательное число N +задаёт уровень детализации информации. По умолчанию это значение установлено +равным 10. +.TP +\-V[N]{файл} +Аналогично аргументу \-V, а также выполняется установка параметру 'verbosefile' +значение {файл}. Как результат, сообщения будут записываться в {файл}, а не +отображаться на экране. Наименование {файла} не может начинаться с какой-либо +цифры. +.TP +\-w{число} +Для параметра 'window' будет установлено значение, равное указанному {числу}. +.TP +\-w {файл} +Добавление всех введённых команд в {файл}. +Все символы, введённые с клавиатуры вплоть до момента завершения работы +редактора, записываются в {файл}. +Удобно в том случае, когда вы хотите создать командный файл для последующего +его использования в командной строке "vim \-s" или в команде ":source!". +Если {файл} уже существует, то набранный текст будет добавляются в конец файла. +.TP +\-W {файл} +Запись всех введённых команд в {файл}. +Как аргумент "\-w", но существующий {файл} будет перезаписан. .TP -\-T {terminal} -Сообщает -.B Vim -тип используемого терминала. Необходимо только в тех ситуациях, когда -автоматическое определение терминала не работает. Имя терминала должно быть -известно +\-x +Редактирование шифрованных файлов. +Если редактор .B Vim -(встроено в него) или определено в файлах termcap или terminfo. -.TP -\-u {vimrc} -Использовать команды из файла сценария {vimrc} для настройки. -Все остальные файлы настроек пропускаются. -Удобно для редактирования специальных типов файлов. -Чтобы избежать использования сценариев настроек вообще, можно использовать -имя "NONE". См. ":help initialization". +был собран с поддержкой шифрования, то выполнять шифрование при записи файлов. +Будет выдано приглашение ввести пароль. .TP -\-U {gvimrc} -Использовать команды из файла сценария {gvimrc} для настройки графического -интерфейса. -Все остальные файлы настроек для графического интерфейса пропускаются. -Чтобы избежать использования сценариев настроек графического интерфейса вообще, -можно использовать имя "NONE". См. ":help gui-init". -.TP -\-V -"Болтливый" режим. Выводить сообщения о том, какие файлы читаются, и о -чтении-записи файла viminfo. +\-X +Запуск программы без подключения к X-серверу. +Ускоряет загрузку в консоли, но делает невозможным использование заголовка окна +и буфера обмена. .TP -\-v -Запустить +\-y +Работа в упрощённом варианте. +Редактор +.B Vim +будет работать в упрощённом варианте, как будто исполняемый файл имеет название +"evim" или "eview". +Поведение редактора .B Vim -в режиме Vi, как будто исполняемый файл имеет имя "vi". Имеет смысл только если -исполняемый файл имеет имя "ex". +будет походить на редакторы, созданные по безрежимному принципу работы. .TP -\-w {scriptout} -Все символы, введённые с клавиатуры вплоть до момента завершения работы, -записываются в файл {scriptout}. -Удобно в том случае, когда вы хотите создать файл сценария для последующего -использования с "vim \-s" или ":source!". Если файл {scriptout} уже существует, -то новые символы будут добавляются в конец файла. +\-Z +Работа с ограничением функциональности. +Работает так же, как и запуск исполняемого файла, наименование которого +начинается с буквы "r". .TP -\-W {scriptout} -Как "\-w", но уже существующий файл будет перезаписан. +\-\- +Означает окончание ввода аргументов. +Все что указано после этого в командной строке, считается наименованиями файлов. +Может быть использовано для правки файлов, наименования которых начинаются с +дефиса. .TP -\-x -Шифровать записываемые файлы. Будет выдано приглашение ввести пароль. +\-\-clean +При работе редактора не использовать пользовательскую конфигурацию (файлы vimrc, +подключаемые модули и т. п.). Полезно для проверки, что проблема в работе +редактора не возникнет с предустановленными настройками программы Vim. .TP -\-X -Не подключаться к X-серверу. Ускоряет загрузку на консоли, но делает невозможным -использование заголовка окна и буфера обмена. +\-\-cmd {команда} +Как аргумент "\-c", но команда исполняется перед обработкой любого файла +настроек (vimrc). +Можно указывать до десяти таких команд, независимо от количества команд "\-c". .TP -\-Z -Ограниченный режим. Работает так же, как и программы, начинающиеся с "r". +\-\-echo\-wid +Только для графического интерфейса GTK. Отобразить идентификатор окна +(Window ID) в поток стандартного вывода (stdout). +.TP +\-\-gui\-dialog\-file {файл} +При работе редактора в графическом интерфейсе пользователя, заголовок +и сообщение диалогового окна будут записаны в {файл} без отображения на экране. +Если указанный {файл} не существует, то он будет создан, а при его наличии +сообщения будут дописываться в этот {файл}. Данный аргумент полезен только для +тестирования работы редактора, чтобы избежать остановки программы, так как +отображаемое диалоговое окно может быть скрыто. Если не поддерживается +графический интерфейс пользователя, то этот аргумент игнорируется программой. +.TP +\-\-help, \-h, \-? +Будет показана краткая информация об аргументах и параметрах командной строки. +После этого редактор +.B Vim +завершит работу. +.TP +\-\-literal +Данный аргумент указывает, что требуется воспринимать наименования файлов +буквально, и не выполнять разбор подстановочных символов. +Этот аргумент командной строки неприменим в Unix-подобных системах, где разбор +подстановочных символов выполняется командной оболочкой. +.TP +\-\-log {файл} +Будет выполнена запись протокола работы с этапа инициализации программы. +Если при сборке программы +.B Vim +были включены компоненты "eval" и "channel", будет выполняться протоколирование +работы с самой ранней стадии запуска программы, а журнал записываться в {файл}. +Это работает аналогично вызову функции +.I ch_logfile({filename}, 'ao') .TP -\-\- -Конец ключей. Все остальные аргументы рассматриваются как имена файлов. -Может быть использовано для правки файлов, имена которых начинаются с дефиса. +\-\-nofork +Режим активного приложения. +Редактор +.B Vim +с графическим интерфейсом не будет наследоваться и отключаться +от командной оболочки, в которой выполнена команда его запуска. .TP -\-\-help -Вывести краткую справку и завершить работу. То же, что и "\-h". +\-\-noplugin +Будет выполнен запуск программы без загрузки внешних подключаемых модулей. +Это же подразумевается при указании аргумента \-u NONE. .TP -\-\-version -Вывести информацию о версии программы и завершить работу. +\-\-not\-a\-term +Не сообщать об отсутствии терминала для ввода-вывода. +Через этот аргумент указывается, что операции ввода-вывода осуществляются не +на терминал. Это позволяет избежать предупреждающего сообщения и двухсекундной +задержки, которые могли бы возникнуть. .TP \-\-remote -Подключиться к серверу Vim и заставить его править файлы, указанные в -последующих аргументах. Если сервер не найден, выводится предупреждение, -а файлы правятся в местной копии Vim. +Будет выполнено подключение к Vim-серверу и передача для правки файлов, +указанных в последующих аргументах. Если сервер не найден, выводится +предупреждение, а правка файлов выполняется в текущей копии редактора Vim. .TP \-\-remote\-expr {выражение} -Подключиться к серверу Vim и вычислить на нём указанное {выражение}. +Будет выполнено подключение к Vim-серверу и передача указанного {выражение} для +вычисления. Результат вычисления будет выведен в поток стандартного вывода (stdout). .TP -\-\-remote\-send {ключи} -Подключиться к серверу Vim и передать ему указанные {ключи}. +\-\-remote\-send {код клавиши} +Будет выполнено подключение к Vim-серверу и передача указанных {кодов клавиш}. .TP \-\-remote\-silent Как "\-\-remote", но без вывода предупреждения, если сервер не найден. .TP \-\-remote\-wait -Как "\-\-remote", но Vim не будет завершать работу до тех пор, пока не будет -выполнена правка всех файлов. +Как "\-\-remote", но редактор Vim не будет завершать работу до тех пор, +пока не будет выполнена правка всех файлов. .TP \-\-remote\-wait\-silent Как "\-\-remote\-wait", но без вывода предупреждения, если сервер не найден. .TP \-\-serverlist -Вывести список всех доступных серверов Vim. +Будет выведен перечень всех доступных Vim-серверов. .TP -\-\-servername {имя} -Использовать указанное {имя} в качестве имени сервера. Если ключ -"\-\-remote" не указан, то {имя} присваивается данной копии Vim, -в противном случае указывает на имя сервера, к которому следует -подключиться. +\-\-servername {название} +Использовать указанное {название} в качестве наименования сервера. Если аргумент +"\-\-remote" не указан, то {название} присваивается данной копии редактора Vim, +в противном случае указывает на сервер, к которому следует подключиться. .TP \-\-socketid {id} -Только для графического интерфейса GTK: использовать механизм GtkPlug для -запуска gvim в отдельном окне. +Только для графического интерфейса GTK. Будет использован механизм GtkPlug для +запуска редактора gVim в отдельном окне. .TP -\-\-echo\-wid -Только для графического интерфейса GTK: вывести идентификатор окна (Window ID) -в поток стандартного вывода (stdout). -.SH ВСТРОЕННАЯ СПРАВКА -Для начала, наберите команду ":help". -Введите ":help тема", чтобы получить справку по конкретной теме. -Например, команда ":help ZZ" выведет информацию о команде "ZZ". -Используйте <Tab> и CTRL-D для автоматического дополнения -названий тем (":help cmdline-completion"). -Для быстрого перемещения по справочнику используются метки (что-то +\-\-startuptime {файл} +Будет выполнена запись хронометража запуска программы в {файл}. +.TP +\-\-ttyfail +Будт сразу же завершена работа, если ввод-вывод получен не с терминала (tty). +.TP +\-\-version +Будет выведена информация о версии программы и завершена работа. +.TP +\-\-windowid {ИД} +Только для графического интерфейса в MS Windows. Редактор gVim будет +использовать окно с указанным {ИД} в качестве родительского, чтобы попытаться +выполнить запуск внутри этого окна. +.SH ВСТРОЕННАЯ ДОКУМЕНТАЦИЯ +Для начала работы с документацией, наберите в редакторе +.B Vim +команду ":help". +Введите ":help тема", чтобы получить справку по интересующей теме. +Например, по команде ":help ZZ" будет выведена информация о команде "ZZ". +Используйте клавиши <TAB> и CTRL+D для подстановки нужного названия темы +(см. ":help cmdline\-completion"). +Для быстрого перемещения по документации используются индексы (что-то вроде гипертекстовых ссылок, см. ":help"). Таким образом можно -просматривать все файлы справки, например ":help syntax.txt". +переходить от одного файла документации к другому, например, ":help syntax.txt". .SH ФАЙЛЫ .TP 15 -/usr/local/lib/vim/doc/*.txt -Файлы справочника +/usr/local/share/vim/vim??/doc/*.txt +Файлы документации редактора .B Vim. -См. ":help doc-file-list" для получения полного списка. +См. ":help doc\-file\-list" для получения полного перечня файлов. +.br +Здесь и далее +.I "vim??" +означает сокращённую запись номера версии, например, vim91 для версии редактора +.B Vim 9.1 .TP -/usr/local/lib/vim/doc/tags -Файл меток, используемый для поиска информации в файлах справки. +/usr/local/share/vim/vim??/doc/tags +Файл индексов, используемый для поиска информации в файлах документации. .TP -/usr/local/lib/vim/syntax/syntax.vim -Системные настройки синтаксиса. +/usr/local/share/vim/vim??/syntax/syntax.vim +Общесистемные настройки распознавания и подсветки синтаксиса. .TP -/usr/local/lib/vim/syntax/*.vim -Файлы синтаксиса для разных языков. +/usr/local/share/vim/vim??/syntax/*.vim +Файлы распознавания и подсветки синтаксиса для различных языков программирования. .TP -/usr/local/lib/vim/vimrc -Системные настройки +/usr/local/share/vim/vimrc +Общесистемный файл начальной настройки для консольного редактора .B Vim. .TP -/usr/local/lib/vim/gvimrc -Системный настройки графического интерфейса. +~/.vimrc, ~/.vim/vimrc, $XDG_CONFIG_HOME/vim/vimrc +Пользовательские файлы начальной настройки для консольного редактора +.B Vim +(будет использован первый найденный файл из указанных). +.TP +/usr/local/share/vim/gvimrc +Общесистемный файл начальной настройки для редактора с графическим интерфейсом +.B gVim. +.TP +~/.gvimrc, ~/.vim/gvimrc, $XDG_CONFIG_HOME/vim/gvimrc +Пользовательские файлы начальной настройки для редактора с графическим +интерфейсом +.B gVim +(будет использован первый найденный файл из указанных). .TP -/usr/local/lib/vim/optwin.vim -Сценарий, используемый при выполнении команды ":options". -Хороший способ просматривать и изменять настройки. +/usr/local/share/vim/vim??/optwin.vim +Командный файл, используемый при выполнении команды ":options". +По этой команде предоставляется удобный способ просмотра и изменения настроек. .TP -/usr/local/lib/vim/menu.vim -Системные настройки меню для gvim. +/usr/local/share/vim/vim??/menu.vim +Системные настройки меню для графического интерфейса редактора +.B gVim. .TP -/usr/local/lib/vim/bugreport.vim -Сценарий для создания отчёта об обнаруженных глюках. См. ":help bugs". +/usr/local/share/vim/vim??/bugreport.vim +Командный файл для создания отчёта об обнаруженных ошибках. См. ":help bugs". .TP -/usr/local/lib/vim/filetype.vim -Сценарий для определения типа файла по имени. См. ":help 'filetype'". +/usr/local/share/vim/vim??/filetype.vim +Командный файл для распознавания типов файлов по наименованию. +См. ":help 'filetype'". .TP -/usr/local/lib/vim/scripts.vim -Сценарий для определения типа файла по содержимому. См. ":help 'filetype'". +/usr/local/share/vim/vim??/scripts.vim +Командный файл для распознавания типов файлов по содержимому. +См. ":help 'filetype'". .TP -/usr/local/lib/vim/print/*.ps -Файлы для печати PostScript. +/usr/local/share/vim/vim??/print/*.ps +Файлы, используемые для печати через интерфейс PostScript. .PP -Более свежая информация -- на сайте VIM: +Всю последнюю информацию о редакторе можно получить на веб-странице VIM: .br <URL:http://www.vim.org/> -.SH СМОТРИ ТАКЖЕ +.SH СМОТРИТЕ ТАКЖЕ vimtutor(1) .SH АВТОРЫ -Большая часть +Большая часть редактора .B Vim -создана Брамом Мооленааром (Bram Moolenaar), которому помогает огромное -количество людей. См. ":help credits" в +была создана Брамом Моленаром (Bram Moolenaar), которому помогало огромное +количество людей. См. ":help credits" в редакторе .B Vim. .br +Редактор .B Vim базируется на коде редактора Stevie, написанного Тимом Томпсоном (Tim Thompson), Тони Эндрюсом (Tony Andrews) и Г. Р. (Фредом) Уолтером (G.R. (Fred) Walter). -Однако, в настоящее время в Vim почти не осталось ничего от исторического кода -его предшественника. +Однако, в настоящее время в программе Vim почти ничего не осталось +от исторического кода его предшественника. .br -Русская локализация +Русская локализация редактора .B Vim выполняется в рамках проекта "РуВим", -см. <URL:http://sourceforge.net/projects/ruvim/>. -.SH ГЛЮКИ +см. <URL:https://github.com/restorerz/ruvim/>. +.SH ОШИБКИ Скорее всего есть. -См. ":help todo" -- список известных проблем. +См. ":help todo" \[em] перечень известных ошибок в работе. .PP -Заметим, что многие вещи, которые считаются глюками, на самом деле -являются результатом слишком полного воспроизведения поведения Vi. +Заметим, что многие вещи, которые считаются ошибками, на самом деле +являются результатом слишком полного воспроизведения поведения редактора Vi. Если вы думаете, что что-то является ошибкой только потому, что "Vi делает это по-другому", внимательно прочитайте файл vi_diff.txt -(или наберите ":help vi_diff.txt" в Vim) и используйте опции 'compatible' -и 'cpoptions'. +(или наберите ":help vi_diff.txt" в редакторе Vim) и посмотрите параметры + 'compatible' и 'cpoptions'. |