diff options
author | Michael Reed <m.reed@mykolab.com> | 2015-05-11 17:30:18 -0400 |
---|---|---|
committer | Michael Reed <m.reed@mykolab.com> | 2015-05-13 18:16:51 -0400 |
commit | 0086c0a53b17d99bb336832f45899ee1fb6a67b7 (patch) | |
tree | ac5d38c5ce37ac984ae7e18ab70cc172c75c1929 /runtime/doc/manpages/ru | |
parent | b0b30769951963bd439d45586a0c86bba445d6ee (diff) | |
download | rneovim-0086c0a53b17d99bb336832f45899ee1fb6a67b7.tar.gz rneovim-0086c0a53b17d99bb336832f45899ee1fb6a67b7.tar.bz2 rneovim-0086c0a53b17d99bb336832f45899ee1fb6a67b7.zip |
Man pages: Move to nvim namespace and out of `runtime/`
Also clean up man page references in `runtime/doc/Makefile` as it
doesn't deal with them anymore.
Diffstat (limited to 'runtime/doc/manpages/ru')
-rw-r--r-- | runtime/doc/manpages/ru/vim-ru.1 | 426 | ||||
-rw-r--r-- | runtime/doc/manpages/ru/vimtutor-ru.1 | 51 | ||||
-rw-r--r-- | runtime/doc/manpages/ru/xxd-ru.1 | 408 |
3 files changed, 0 insertions, 885 deletions
diff --git a/runtime/doc/manpages/ru/vim-ru.1 b/runtime/doc/manpages/ru/vim-ru.1 deleted file mode 100644 index 1d4221b3ab..0000000000 --- a/runtime/doc/manpages/ru/vim-ru.1 +++ /dev/null @@ -1,426 +0,0 @@ -.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 [файл ошибок] -.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". -.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 -\-d -Режим поиска различий. -Должно быть указано два или три имени файла. -.B Vim -откроет все файлы и покажет различия между ними -.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 -\-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 -Не использовать своп-файл. Восстановление при сбое в работе будет невозможно. -Удобно для правки файла на очень медленном носителе (например, гибком диске). -То же самое можно сделать командой ":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 -\-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/vimtutor-ru.1 b/runtime/doc/manpages/ru/vimtutor-ru.1 deleted file mode 100644 index 6b1ba90df0..0000000000 --- a/runtime/doc/manpages/ru/vimtutor-ru.1 +++ /dev/null @@ -1,51 +0,0 @@ -.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 deleted file mode 100644 index 647845bab4..0000000000 --- a/runtime/doc/manpages/ru/xxd-ru.1 +++ /dev/null @@ -1,408 +0,0 @@ -.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 |