diff options
Diffstat (limited to 'runtime/doc/manpages/ru')
-rw-r--r-- | runtime/doc/manpages/ru/evim-ru.1 | 59 | ||||
-rw-r--r-- | runtime/doc/manpages/ru/vim-ru.1 | 489 | ||||
-rw-r--r-- | runtime/doc/manpages/ru/vimdiff-ru.1 | 50 | ||||
-rw-r--r-- | runtime/doc/manpages/ru/vimtutor-ru.1 | 51 | ||||
-rw-r--r-- | runtime/doc/manpages/ru/xxd-ru.1 | 408 |
5 files changed, 1057 insertions, 0 deletions
diff --git a/runtime/doc/manpages/ru/evim-ru.1 b/runtime/doc/manpages/ru/evim-ru.1 new file mode 100644 index 0000000000..581c364c22 --- /dev/null +++ b/runtime/doc/manpages/ru/evim-ru.1 @@ -0,0 +1,59 @@ +.TH EVIM 1 "2002 February 16" +.SH ИМЯ +evim \- простой Vim, позволяет редактировать файл с помощью Vim в безрежимном режиме +.SH КОМАНДНАЯ СТРОКА +.br +.B evim +[ключи] [файл ..] +.br +.B eview +.SH ОПИСАНИЕ +Команда +.B evim +запускает +.B Vim +и настраивает ряд опций таким образом, что он начинает вести себя +как обычный безрежимный редактор. В этом режиме Vim напоминает +Notepad из MS-Windows. +.B eVim +всегда запускается с поддержкой графического интерфейса, чтобы обеспечить +использование меню и инструментальной панели. +.PP +Эта команда создана для тех, кто по каким-то причинам не в состоянии +работать с Vim в обычном режиме. Редактирование файлов при этом происходит +гораздо менее эффективно, чем при использовании обычного Vim. +.PP +Команда +.B eview +выполняет почти ту же самую задачу, но файл открывается в режиме "только +для чтения". Использование этой команды полностью идентично использованию +evim \-R. +.PP +Подробнее о Vim, ключах запуска и т.п. смотрите на странице справочника +vim(1). +.PP +При использовании +.B evim +включается опция 'insertmode', что позволяет вводить текст напрямую. +.br +Кроме того, настраиваются привязки, позволяющие использовать кнопки MS-Windows +для выполнения команд копирования и вклейки. CTRL-X используется для вырезания +текста, CTRL-C для копирования и CTRL-V для вклейки. Чтобы воспользоваться +изначальным значением кнопки CTRL-V, используйте CTRL-Q. +.SH ПАРАМЕТРЫ ЗАПУСКА +См. vim(1). +.SH ФАЙЛЫ +.TP 15 +/usr/local/lib/vim/evim.vim +Сценарий, который загружается для инициализации eVim. +.SH AKA +eVim также известен как "Vim для чайников". +Для наилучшего эффекта рекомендуется во время использования повязать +на голове платок, предварительно завязав на каждом конце по узелку. +.SH СМОТРИ ТАКЖЕ +vim(1) +.SH АВТОРЫ +Большая часть +.B Vim +создана Брамом Мооленааром (Bram Moolenaar), которому помогает огромное +количество людей. См. меню Справка/Благодарности. diff --git a/runtime/doc/manpages/ru/vim-ru.1 b/runtime/doc/manpages/ru/vim-ru.1 new file mode 100644 index 0000000000..ef527213e3 --- /dev/null +++ b/runtime/doc/manpages/ru/vim-ru.1 @@ -0,0 +1,489 @@ +.TH VIM 1 "2002 Feb 22" +.SH ИМЯ +vim \- Vi IMproved (Улучшенный Vi), текстовый редактор для программистов +.SH КОМАНДНАЯ СТРОКА +.br +.B vim +[ключи] [файл ..] +.br +.B vim +[ключи] \- +.br +.B vim +[ключи] \-t метка +.br +.B vim +[ключи] \-q [файл ошибок] +.PP +.br +.B ex +.br +.B view +.br +.B gvim +.B gview +.br +.B rvim +.B rview +.B rgvim +.B rgview +.SH ОПИСАНИЕ +.B Vim +-- текстовый редактор, обратно-совместимый с 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'. diff --git a/runtime/doc/manpages/ru/vimdiff-ru.1 b/runtime/doc/manpages/ru/vimdiff-ru.1 new file mode 100644 index 0000000000..2f17e9c2e5 --- /dev/null +++ b/runtime/doc/manpages/ru/vimdiff-ru.1 @@ -0,0 +1,50 @@ +.TH VIMDIFF 1 "2001 March 30" +.SH ИМЯ +vimdiff \- позволяет редактировать две или три версии файла с помощью Vim +с отображением различий. +.SH КОМАНДНАЯ СТРОКА +.br +.B vimdiff +[ключи] файл1 файл2 [файл3] +.PP +.B gvimdiff +.SH ОПИСАНИЕ +Команда +.B vimdiff +загружает в +.B Vim +два (или три) файла. Каждый файл открывается в собственном окне. +Различия между файлами отображаются с помощью подсветки синтаксиса. +Эта команда позволяет наглядно отображать внесённые изменения и переносить +различающиеся фрагменты из одной версии файла в другую. +.PP +Подробнее о Vim см. на странице справочника vim(1). +.PP +При запуске с помощью команды +.B gvimdiff +редактор запускается в режиме графического интерфейса, если это возможно. +.PP +В каждом окне включается опция 'diff', что позволяет использовать подсветку +синтаксиса для отображения различий между файлами. +.br +Для улучшения работы с файлами в режиме отображения отличий также включаются +опции 'wrap' и 'scrollbind'. +.br +Значение опции 'foldmethod' устанавливается равным "diff", что позволяет +прятать в складку области текста, которые не отличаются в различных версиях файла. +Значение опции 'foldcolumn' устанавливается равным 2, чтобы было проще +находить, открывать и закрывать такие складки. +.SH КЛЮЧИ ЗАПУСКА +Для выравнивания строк между окнами используется вертикальное разделение окон, +как если бы использовался ключ "\-O". Для того, чтобы использовать разделение +окон по горизонтали, следует указать в командной строке ключ "\-o". +.PP +Остальные ключи командной строки рассматриваются на странице справочника vim(1). +.SH СМОТРИ ТАКЖЕ +vim(1) +.SH АВТОРЫ +Большая часть +.B Vim +создана Брамом Мооленааром (Bram Moolenaar), которому помогает огромное +количество людей. См. ":help credits" в +.B Vim. diff --git a/runtime/doc/manpages/ru/vimtutor-ru.1 b/runtime/doc/manpages/ru/vimtutor-ru.1 new file mode 100644 index 0000000000..6b1ba90df0 --- /dev/null +++ b/runtime/doc/manpages/ru/vimtutor-ru.1 @@ -0,0 +1,51 @@ +.TH VIMTUTOR 1 "2001 April 2" +.SH ИМЯ +vimtutor \- учебник по Vim +.SH КОМАНДНАЯ СТРОКА +.br +.B vimtutor [язык] +.SH ОПИСАНИЕ +Команда +.B vimtutor +запускает учебник по +.B Vim. +При этом сначала происходит создание копии файла учебника, +чтобы его можно было редактировать без опасения потерять исходный файл. +.PP +Программа +.B vimtutor +полезна для новичков, желающих научиться самым основным командам +.B Vim. +.PP +Необязательный параметр [язык] представляет собой двухсимвольный код языка, +например "ru" или "it". +Если параметр [язык] не указан, то используется язык активной в настоящий +момент локали. Если учебник на этом языке не существует, то по умолчанию +используется учебник на английском языке. +.PP +При работе с учебником +.B Vim +всегда запускается в режиме совместимости с Vi. +.SH ФАЙЛЫ +.TP 15 +/usr/local/lib/vim/tutor/tutor[.язык] +Текст учебника +.B vimtutor. +.TP 15 +/usr/local/lib/vim/tutor/tutor.vim +Сценарий Vim, который используется для создания рабочей +копии текста учебника +.B vimtutor. +.SH АВТОРЫ +.B Vimtutor +был впервые написан для Vi Майклом К. Пирсом (Michael C. Pierce) и +Робертом К. Уэа (Robert K. Ware) из Colorado School of Mines по +идее Чарльза Смита (Charles Smith) из Colorado State University. +E-mail: bware@mines.colorado.edu. +.br +Впоследствии учебник был доработан для использования в +.B Vim +Брамом Мооленааром (Bram Moolenaar). +Имена переводчиков учебника упоминаются в соответствующих файлах. +.SH СМОТРИ ТАКЖЕ +vim(1) diff --git a/runtime/doc/manpages/ru/xxd-ru.1 b/runtime/doc/manpages/ru/xxd-ru.1 new file mode 100644 index 0000000000..647845bab4 --- /dev/null +++ b/runtime/doc/manpages/ru/xxd-ru.1 @@ -0,0 +1,408 @@ +.TH XXD 1 "August 1996" "Страница man для xxd" +.\" +.\" 21st May 1996 +.\" Man page author: +.\" Tony Nugent <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.\" Changes by Bram Moolenaar <Bram@vim.org> +.SH ИМЯ +.I xxd +\- создаёт представление файла в виде шестнадцатеричных кодов или выполняет +обратное преобразование. +.SH КОМАНДНАЯ СТРОКА +.B xxd +\-h[elp] +.br +.B xxd +[ключи] [входной_файл [выходной_файл]] +.br +.B xxd +\-r[evert] [ключи] [входной_файл [выходной_файл]] +.SH ОПИСАНИЕ +.I xxd +создаёт представление указанного файла или данных, прочитанных из потока +стандартного ввода, в виде шестнадцатеричных кодов. Эта команда также может +выполнить обратное преобразование заданных шестнадцатеричными кодами данных +в исходный бинарный формат. +Подобно командам +.BR uuencode(1) +и +.BR uudecode(1), +она позволяет выполнять преобразование бинарных данных в ASCII-код, +который можно передавать по электронной почте, однако, помимо этого, программа +xxd позволяет выполнять декодирование в поток стандартного вывода, +а также может применяться для создания заплаток для бинарных файлов. +.SH КЛЮЧИ ЗАПУСКА +Если +.I входной_файл +не задан, то соответствующие данные читаются из потока стандартного ввода. +В случае, если в качестве +.I входного_файла +используется символ +.RB \` \- ', +источником данных также выступает поток стандартного ввода. +В том случае, если не указан +.I выходной_файл +(или вместо него используется символ +.RB \` \- ' +), результат преобразования направляется в поток стандартного вывода. +.PP +Обратите внимание, что используется "ленивый" алгоритм разбора ключей, который не +проверяет более одной буквы ключа, если в этом ключе не используется параметр. +Пробелы между единственным символом ключа и соответствующим параметром не являются +обязательными. Параметры ключей могут быть заданы с использованием десятичного, +шестнадцатеричного или восьмеричного формата. +Таким образом, ключи +.BR \-c8 , +.BR "\-c 8" , +.B \-c 010 +и +.B \-cols 8 +являются равнозначными. +.PP +.TP +.IR \-a " | " \-autoskip +Включает автоматический пропуск: вместо последовательности +нулевых строк используется одиночный символ '*'. По умолчанию +не применяется. +.TP +.IR \-b " | " \-bits +Вместо шестнадцатеричного кода используются биты (двоичные цифры). +При использовании этого ключа вместо обычного шестнадцатеричного представления +октетов используются наборы из восьми символов "1" и "0". Каждая строка +предваряется номером строки в шестнадцатеричном виде, а завершается символьным +представлением (в виде ascii или ebcdic). Ключи \-r, \-p, \-i в этом режиме +не работают. +.TP +.IR "\-c кол " | " \-cols кол" +Задаёт количество октетов +.RI < кол >, +которое выводится на каждой строке. По умолчанию используется значение 16 +(\-i: 12, \-ps: 30, \-b: 6). +Максимально допустимое значение: 256. +.TP +.IR \-E " | " \-EBCDIC +Изменяет способ кодирования символов в правой колонке с ASCII на EBCDIC. Этот ключ +не изменяет шестнадцатеричное представление. Данный ключ не имеет смысла, +если используются ключи \-r, \-p или \-i. +.TP +.IR "\-g байт " | " \-groupsize байт" +Позволяет выполнять группировку указанного количества +.RI < байтов > +(две шестнадцатеричные цифры или восемь битов), отделяя группы друг от друга пробелами. +Значение +.I \-g 0 +применяется для отказа от использования группировки. +По умолчанию используется значение +.RI < байт "> равное " 2 +в обычном режиме и \fI1\fP в битовом режиме. Группировка не применяется +в режимах postscript и include. +.TP +.IR \-h " | " \-help +Выводит справку по доступным ключам командной строки и завершает работу программы. +Создание шестнадцатеричного представления не выполняется. +.TP +.IR \-i " | " \-include +Позволяет создавать вывод в стиле подключаемых заголовочных файлов языка C. +Вывод содержит полноценное определение статического массива данных, имя которого +соответствует имени входного файла, если xxd не считывает данные из потока стандартного +ввода. +.TP +.IR "\-l длина " | " \-len длина" +Завершает работу после записи заданного в параметре +.RI < длина > +количества октетов. +.TP +.IR \-p " | " \-ps " | " \-postscript " | " \-plain +Использует непрерывный формат вывода шестнадцатеричного кода, +известный как "простой" стиль или стиль "postscript". +.TP +.IR \-r " | " \-revert +Изменяет смысл операции на противоположный: позволяет выполнять преобразование +шестнадцатеричного представления в бинарный код (или применять результат в качестве заплаты). +Если вывод происходит не в поток стандартного вывода, то xxd выполняет добавление кода +к соответствующему файлу. При использовании комбинации ключей +.I \-r \-p +происходит чтение "простого" шестнадцатеричного представления без использования +информации о номерах строк и какого-либо специального раскроя колонок. Пробелы +и символы новой строки могут встречаться в любом месте исходных данных. +.TP +.I \-seek смещение +При использовании после ключа +.I \-r +: добавлять указанное +.RI < смещение > +к файловым позициям, обнаруженным в исходных данных. +.TP +.I \-s [\+][\-]seek +Начинает работу с указанного абсолютного (или относительного) +.RI < смещения > +в байтах во входном_файле. +\fI\+ \fRуказывает, что смещение является относительным по отношению +к текущей файловой позиции в потоке стандартного ввода (бессмысленно, если чтение +происходит не из потока стандартного ввода). \fI\- \fRуказывает, что должно быть прочитано +указанное количество символов от конца ввода (либо, если сочетается с \fI \+ \fR: +перед текущей позиции файла в потоке стандартного ввода). +Если ключ \-s не используется, то xxd начинает работу от текущей позиции в файле. +.TP +.I \-u +Использует шестнадцатеричные цифры в верхнем регистре. По умолчанию используются цифры в +нижнем регистре символов. +.TP +.IR \-v " | " \-version +Отображает информацию о версии программы. +.SH ПОДВОДНЫЕ КАМНИ +.PP +.I xxd \-r +обладает встроенным интеллектом для распознавания информации о номерах строк. +Если возможен поиск по входному файлу, то номера строк в начале каждой строки +шестнадцатеричного представления могут быть неупорядоченными, некоторые строки могут +быть пропущены или пересекаться друг с другом. В этих случаях xxd использует +lseek(2) для перехода к следующей позиции. Если поиск по входному файлу +невозможен, то допустимы только пропуски строк, которые заполняются нулевыми +байтами. +.PP +.I xxd \-r +никогда не выводит сообщений об ошибках. Мусор пропускается молча. +.PP +При редактировании шестнадцатеричных представлений бинарных файлов обращайте +внимание, что +.I xxd \-r +пропускает в строке ввода любые данные после прочтения достаточного количества +колонок шестнадцатеричных данных (см. ключ \-c). Это означает, что изменения, +внесенные в колонки с печатными символами ascii (или ebcdic), всегда игнорируются. +При обратном преобразовании шестнадцатеричного представления в стиле +postscript с помощью команды xxd \-r \-p количество колонок не учитывается. +В этом случае распознаются все символы, которые похожи на пары шестнадцатеричных цифр. +.PP +Обратите внимание на различие между командами +.PP +\fI% xxd \-i файл\fR +.PP +и +.PP +\fI% xxd \-i \< файл\fR +.PP +Команда +.I xxd \-s \+seek +может отличаться от +.I xxd \-s seek, +поскольку для того, чтобы "отмотать" данные на входе назад, используется вызов lseek(2). +При использовании `+' поведение будет отличаться, если входные данные +поступают с потока стандартного ввода, а позиция в файле стандартного ввода не находится +в начале файла к тому моменту, когда программа xxd запущена и приступает к чтению ввода. +Нижеследующие примеры помогут прояснить (или ещё больше запутать!) ситуацию... +.PP +Отмотка назад потока стандартного ввода; необходимо, поскольку 'cat' уже выполнила +чтение до конца потока стандартного ввода: +.PP +\fI% sh \-c 'cat > plain_copy; xxd \-s 0 > hex_copy' < file +.PP +Вывод шестнадцатеричного представления от позиции в файле 0x480 +(= 1024+128). +Символ `+' означает "относительно текущей позиции", таким образом `128' добавляется +к первому килобайту, где завершает работу dd: +.PP +\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet' < file +.PP +Вывод шестнадцатеричного представления от позиции в файле 0x100 +(= 1024-768): +.PP +\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +-768 > hex_snippet' < file +.PP +В то же время, следует заметить, что подобные ситуации встречаются довольно редко, +так что символ `+' обычно не используется. Автор предпочитает наблюдать за работой +xxd с помощью strace(1) или truss(1) в тех случаях, когда применяется ключ +\-s. +.SH ПРИМЕРЫ +.PP +.br +Вывести всё, кроме первых трёх строк (0x30 байтов) файла +.B file +: +.PP +\fI% xxd \-s 0x30 file +.PP +.br +Вывести три строки (0x30 байтов) от конца файла +.B file +: +.PP +\fI% xxd \-s \-0x30 file +.PP +.br +Вывести 120 байтов в виде непрерывного шестнадцатеричного представления +по 20 октетов в строке: +.PP +\fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR +.br +2e544820585844203120224d616e75616c207061 +.br +676520666f7220787864220a2e5c220a2e5c2220 +.br +32317374204d617920313939360a2e5c22204d61 +.br +6e207061676520617574686f723a0a2e5c222020 +.br +2020546f6e79204e7567656e74203c746f6e7940 +.br +7363746e7567656e2e7070702e67752e6564752e +.br +.PP +.br +Вывести первые 120 байтов этой страницы справочника по 12 октетов в строке: +.PP +\fI% xxd \-l 120 \-c 12 xxd.1\fR +.br +0000000: 2e54 4820 5858 4420 3120 224d .TH XXD 1 "M +.br +000000c: 616e 7561 6c20 7061 6765 2066 anual page f +.br +0000018: 6f72 2078 7864 220a 2e5c 220a or xxd"..\\". +.br +0000024: 2e5c 2220 3231 7374 204d 6179 .\\" 21st May +.br +0000030: 2031 3939 360a 2e5c 2220 4d61 1996..\\" Ma +.br +000003c: 6e20 7061 6765 2061 7574 686f n page autho +.br +0000048: 723a 0a2e 5c22 2020 2020 546f r:..\\" To +.br +0000054: 6e79 204e 7567 656e 7420 3c74 ny Nugent <t +.br +0000060: 6f6e 7940 7363 746e 7567 656e ony@sctnugen +.br +000006c: 2e70 7070 2e67 752e 6564 752e .ppp.gu.edu. +.PP +.br +Показать дату из файла xxd.1: +.PP +\fI% xxd \-s 0x28 \-l 12 \-c 12 xxd.1\fR +.br +0000028: 3231 7374 204d 6179 2031 3939 21st May 199 +.PP +.br +Скопировать +.B входной_файл +в +.B выходной_файл +с добавлением 100 байтов со значением 0x00 в начало файла: +.PP +\fI% xxd входной_файл | xxd \-r \-s 100 \> выходной_файл\fR +.br +.PP +.br +Заменить дату в файле xxd.1: +.PP +\fI% echo '0000029: 3574 68' | xxd \-r \- xxd.1\fR +.br +\fI% xxd \-s 0x28 \-l 12 \-c 12 xxd.1\fR +.br +0000028: 3235 7468 204d 6179 2031 3939 25th May 199 +.PP +.br +Создать 65537-байтный файл, все байты которого имеют значение +0x00, кроме последнего байта, который должен иметь значение 'A' +(0x41): +.PP +\fI% echo '010000: 41' | xxd \-r \> file\fR +.PP +.br +Создать шестнадцатеричное представление этого файла с +использованием автоматического пропуска: +.PP +\fI% xxd \-a \-c 12 file\fR +.br +0000000: 0000 0000 0000 0000 0000 0000 ............ +.br +* +.br +000fffc: 0000 0000 40 ....A +.PP +Создать 1-байтный файл, содержащий символ 'A'. +Число после '\-r \-s' добавляется к номерам строк, найденным в файле; +иначе говоря, предшествующие байты пропускаются: +.PP +\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> file\fR +.PP +xxd можно использовать в качестве фильтра в редакторе, например в +.B vim(1), +чтобы создать шестнадцатеричное представление области между +отметками `a' и `z': +.PP +\fI:'a,'z!xxd\fR +.PP +Вы можете использовать xxd в качестве фильтра в редакторе, например в +.B vim(1), +для восстановления данных из шестнадцатеричного представления +между отметками `a' и `z': +.PP +\fI:'a,'z!xxd \-r\fR +.PP +Вы можете использовать xxd в качестве фильтра в редакторе, например в +.B vim(1), +для восстановления данных из единственной строки +шестнадцатеричного представления. Поместите курсор в соответствующую строку +и наберите +.PP +\fI!!xxd \-r\fR +.PP +Чтобы прочитать единственный символ из канала связи: +.PP +\fI% xxd \-c1 < /dev/term/b &\fR +.br +\fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR +.br +\fI% echo \-n foo > /dev/term/b\fR +.PP +.SH ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ +Программа xxd завершает работу со следующими значениями: +.TP +0 +Ошибки не обнаружены. +.TP +\-1 +Операция не поддерживается (выполнение +.I xxd \-r \-i +пока невозможно). +.TP +1 +Ошибка при разборе ключей командной строки. +.TP +2 +Проблемы во входном файле. +.TP +3 +Проблемы в выходном файле. +.TP +4,5 +Желательная позиция поиска недостижима. +.SH СМОТРИ ТАКЖЕ +uuencode(1), uudecode(1), patch(1) +.br +.SH ПРЕДУПРЕЖДЕНИЕ +Странность этой программы соответствует особенностям мозга её создателя. +Используйте её на свой страх и риск. Копируйте файлы, отслеживайте +вызовы, становитесь волшебником. +.br +.SH ВЕРСИЯ +Эта страница справочника документирует xxd версии 1.7. +.SH АВТОР +.br +(c) 1990-1997 Юрген Вайгерт (Juergen Weigert) +.br +<jnweiger@informatik.uni-erlangen.de> +.LP +Вы можете свободно распространять программу со ссылкой на меня. +.br +Если использование этой программы принесло вам какой-то доход, +поделитесь со мной. +.br +Если вы потеряли деньги, то я тут не причём. +.PP +Первый вариант страницы справочника написан Тони Наджентом (Tony Nugent) +.br +<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.br +Небольшие изменения внесены Брамом Мооленааром (Bram Moolenaar). +Страница отредактирована Юргеном Вайгертом (Juergen Weigert). +.PP |