diff options
Diffstat (limited to 'runtime/doc')
| -rw-r--r-- | runtime/doc/todo.txt | 41 | ||||
| -rw-r--r-- | runtime/doc/version7.txt | 28 | ||||
| -rw-r--r-- | runtime/doc/vim-ru.1 | 489 | ||||
| -rw-r--r-- | runtime/doc/xxd-it.UTF-8.1 | 402 |
4 files changed, 934 insertions, 26 deletions
diff --git a/runtime/doc/todo.txt b/runtime/doc/todo.txt index 0a0ec6ebd..1ff6e2a24 100644 --- a/runtime/doc/todo.txt +++ b/runtime/doc/todo.txt @@ -1,4 +1,4 @@ -*todo.txt* For Vim version 7.0aa. Last change: 2005 Mar 18 +*todo.txt* For Vim version 7.0aa. Last change: 2005 Mar 20 VIM REFERENCE MANUAL by Bram Moolenaar @@ -30,17 +30,6 @@ be worked on, but only if you sponsor Vim development. See |sponsor|. *known-bugs* -------------------- Known bugs and current work ----------------------- -Fix for executable new file also in 6.3. - -Installing manual pages: FreeBSD includes encoding "it.ISO8859-1". Install in -"it" and "it.ISO8859-1"? -Russian manual needs to be in UTF-8 for RedHat, KOI8-R for Gentoo. -UTF-8 files from Ragosin (18 March). - -- Added "undercurl" highlight attribute. Based on a patch from Marcin Dalecki. - Docs for "guisp=Red" - Added another byte for attributes, 200 types is not enough. - Mac unicode patch (Da Woon Jung): - selecting proportional font breaks display - UTF-8 text causes display problems. Font replacement causes this. @@ -64,25 +53,20 @@ Awaiting response: PLANNED FOR VERSION 7.0: -- Add SPELLCHECKER, with easy to add support for many languages. - - Highlighting: SpellBad, SpellRare, SpellDialect - - Need wordlists for many languages; "language pack" +- Add SPELLCHECKER, with support for many languages. + - Use "engspchk" from Charles Campbell for ideas. + - Only look in @Spell groups or when there isn't such a group. + - Don't use vim_iswordc_buf(), always use the same wordchar. - Commands required: - enable/disable spellchecking: 'spell' option (local to win) - set spellcheck language (allow English + other lang) - :set langspell=en,du,pl add word to private dict: wrong and OK (in popup menu for evim) :spell good <word> zg :spell wrong <word> zw [s move to previous spell error [S also rare word ]s move to next spell error ]S also rare word - - "engspchk" from Charles Campbell is a good starting point. - - Do not use an external program like ispell or aspell: too slow and - doesn't work everywhere. - - Check spelling after syntax highlighting. Also when there is no syntax - highlighting! - - Keep wordlist globally, load it only once and use it several times - later. Sort of global syntax items. + - Update option window for 'spell' and 'spelllang'. + - Use an external program like ispell or aspell for suggestions to correct + the spelling. + - Need wordlists for many languages; "language pack" - Use wordlists from openoffice (myspell). Work together with them to update the wordlist. (Adri Verhoef, Aad Nales) - Support for approximate-regexps will help (agrep @@ -96,6 +80,8 @@ PLANNED FOR VERSION 7.0: 8 Add spell checking. Use "ispell -a" somehow. ~/vim/patches/wm_vim-5_4d.zip can be used as an example (includes ispell inside Vim). Gautam Iyer has an example with "aspell". + Patch from Marcin Dalecki, uses pipe to aspell. + - REFACTORING: The main() function is very long. Move parts to separate functions, especially loops. Ideas from Walter Briscoe (2003 Apr 3, 2004 Feb 9). @@ -220,6 +206,8 @@ PLANNED FOR VERSION 7.0: Adjust src/main.aap for installing manpages like in Makefile. +Win32: Patch for Korean IME. (Yusung, 2005 March 21) + Support ":set syntax=cpp.doxygen"? Suggested patch by Michael Geddes (9 Aug 2004). Should also work for 'filetype'. @@ -2247,6 +2235,9 @@ Command line completion: Command line history: +9 Remember which command lines were actually typed and were not loaded from + viminfo. When writing viminfo append only these lines, so that lines from + other Vim's are not overwritten. - Add "KeyWasTyped" flag: It's reset before each command and set when a character from the keyboard is consumed. Value is used to decide to put a command line in history or not. Put line in history if it didn't diff --git a/runtime/doc/version7.txt b/runtime/doc/version7.txt index d8ac66612..50e7657b0 100644 --- a/runtime/doc/version7.txt +++ b/runtime/doc/version7.txt @@ -1,4 +1,4 @@ -*version7.txt* For Vim version 7.0aa. Last change: 2005 Mar 18 +*version7.txt* For Vim version 7.0aa. Last change: 2005 Mar 20 VIM REFERENCE MANUAL by Bram Moolenaar @@ -19,6 +19,7 @@ INCOMPATIBLE CHANGES |incompatible-7| NEW FEATURES |new-7| Vim script enhancements |new-vim-script| +Spell checking |new-spell| KDE support |new-KDE| Translated manual pages |new-manpage-trans| Internal grep |new-vimgrep| @@ -130,6 +131,26 @@ With the |:profile| command you can find out where your function or script wastes its time. +Spell checking *new-spell* +-------------- + +Spell checking has been integrated in Vim. There were a few implementations +with scripts, but they were slow and/or required an external program. + +The 'spell' option is used to switch spell checking on or off. +The 'spelllang' option is used to specify the languages that are accepted. + +The "undercurl" highlighting attribute was added to nicely point out spelling +mistakes in the GUI (based on patch from Marcin Dalecki). +The "guisp" color can be used to give it a color different from foreground and +background. +The number of possible different highlight attributes was raised from about +220 to over 30000. This allows for the attributes of spelling to be combined +with syntax highlighting attributes. + +Much more info here: |spell|. + + KDE support *new-KDE* ----------- @@ -263,6 +284,8 @@ Options: ~ (based on an idea from Yegappan Lakshmanan) 'formatlistpat' pattern to recognize a numbered list for formatting. (idea by Hugo Haas) +'spell' switch spell checking on/off +'spelllang' languages to check spelling for Ex commands: ~ @@ -987,4 +1010,7 @@ Don't move the cursor if it's somewhere past the first line. "gg=G" while 'modifiable' is off was uninterruptable. +When 'encoding' is "sjis" inserting CTRL-V u d800 a few times causes a crash. +Don't insert a DBCS character with a NUL second byte. + vim:tw=78:ts=8:ft=help:norl: diff --git a/runtime/doc/vim-ru.1 b/runtime/doc/vim-ru.1 new file mode 100644 index 000000000..11e30174b --- /dev/null +++ b/runtime/doc/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/*.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/xxd-it.UTF-8.1 b/runtime/doc/xxd-it.UTF-8.1 new file mode 100644 index 000000000..0bdc792e8 --- /dev/null +++ b/runtime/doc/xxd-it.UTF-8.1 @@ -0,0 +1,402 @@ +.TH XXD 1 "Agosto 1996" "Pagina di manuale per xxd" +.\" +.\" 21 Maggio 1996 +.\" Autore della pagina di manuale: +.\" Tony Nugent <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.\" Modificato da Bram Moolenaar <Bram@vim.org> +.SH NOME +.I xxd +\- Produce esadecimale da un file binario o viceversa. +.SH SINTASSI +.B xxd +\-h[elp] +.br +.B xxd +[opzioni] [input_file [output_file]] +.br +.B xxd +\-r[evert] [opzioni] [input_file [output_file]] +.SH DESCRIZIONE +.I xxd +crea un'immagine esadecimale di un dato file o dello "standard input". +Puц╡ anche ottenere da un'immagine esadecimale il file binario originale. +Come +.BR uuencode(1) +e +.BR uudecode(1) +permette di trasmettere dati binari in una rapresentazione ASCII "a prova +di email", ma ha anche il vantaggio di poter decodificare sullo "standard +output". Inoltre, puц╡ essere usato per effettuare delle modifiche (patch) +a file binari. +.SH OPZIONI +Se non si specifica un +.I input_file +il programma legge dallo "standard input". +Se +.I input_file +ц╗ specificato come il carattere +.RB \` \- ' +, l'input ц╗ letto dallo "standard input". +Se non si specifica un +.I output_file +(o si mette al suo posto il carattere +.RB \` \- ' +), i risultati sono inviati allo "standard output". +.PP +Si noti che la scansione dei caratteri ц╗ "pigra", e non controlla oltre +la prima lettera dell'opzione, a meno che l'opzione sia seguita da un +parametro. +Gli spazi fra una singola lettera di opzione e il corrispondente parametro +dopo di essa sono facoltativi. +I parametri delle opzioni possono essere specificati usando la notazione +decimale, esadecimale oppure ottale. +Pertanto +.BR \-c8 , +.BR "\-c 8" , +.B \-c 010 +e +.B \-cols 8 +sono notazioni equivalenti fra loro. +.PP +.TP +.IR \-a " | " \-autoskip +Richiesta di autoskip: Un singolo '*' rimpiazza linee di zeri binari. +Valore predefinito: off. +.TP +.IR \-b " | " \-bits +Richiesta di una immagine binaria (cifre binarie), invece che esadecimale. +Questa opzione scrive un byte come otto cifre "1" e "0" invece di usare i +numeri esadecimali. Ogni linea ц╗ preceduta da un indirizzo in esadecimale e +seguita da una decodifica ascii (o ebcdic). Le opzioni specificabili dalla +linea comando \-r, \-p, \-i non funzionano in questo modo. +.TP +.IR "\-c colonne " | " \-cols colonne" +.IR "\-c colonne " | " \-cols colonne" +In ogni linea sono formattate +.RI < colonne > +colonne. Valore predefinito 16 (\-i: 12, \-ps: 30, \-b: 6). +Valore massimo 256. +.TP +.IR \-E " | " \-EBCDIC +Cambia la codifica della colonna di destra da ASCII a EBCDIC. +Questo non modifica la rappresentazione esadecimale. Non ha senso +specificare questa opzione in combinazione con \-r, \-p o \-i. +.TP +.IR "\-g bytes " | " \-groupsize bytes" +Inserisci ogni +.RI < bytes > +bytes di output (di due caratteri esadecimali o otto numeri binari ognuno) +uno spazio bianco. +Specificando +.I \-g 0 +i bytes di output non sono separati da alcuno spazio. +.RI < Bytes "> ha come valore predefinito " 2 +in modalitц═ normale [esadecimale] e \fI1\fP in modalitц═ binaria. +Il raggruppamento non si applica agli stili "PostScript" e "include". +.TP +.IR \-h " | " \-help +stampa un sommario dei comandi disponibili ed esce. Non viene fatto +null'altro. +.TP +.IR \-i " | " \-include +L'output ц╗ nello stile dei file "include" in C. Viene preparata la +definizione completa di un "array" [vettore], dandogli il nome del +file di input), tranne che nel caso in cui xxd legga dallo "standard input". +.TP +.IR "\-l lunghezza " | " \-len lunghezza" +Il programma esce dopo aver scritto +.RI < lunghezza > +bytes. +.TP +.IR \-p " | " \-ps " | " \-postscript " | " \-plain +L'output ц╗ nello stile di un dump continuo sotto postscript. +Noto anche come stile esadecimale semplice [plain]. +.TP +.IR \-r " | " \-revert +ricostruzione: converte (o mette una patch) a partire dall'immagine +esadecimale, creando [o modificando] il file binario. +Se non diretto allo "standard output", xxd scrive nel suo file di output +in maniera continua, senza interruzioni. Usare la combinazione +.I \-r \-p +per leggere dump in stile esadecimale semplice [plain], senza l'informazione +di numero di linea e senza un particolare tracciato di colonna. Degli spazi +o delle linee vuote possono essere inserite a piacere [e vengono ingorate]. +.TP +.I \-seek distanza +Usato con l'opzione +.I \-r +: (ricostruzione), +.RI < distanza > +viene aggiunta alla posizione nel file trovata nella immagine +esadecimale. +.TP +.I \-s [\+][\-]seek +Inizia a +.RI < seek > +bytes assoluti (o relativi) di distanza all'interno di input_file. +\fI\+ \fRindica che il "seek" ц╗ relativo alla posizione corrente nel file +"standard input" (non significativa quando non si legge da "standard input"). +\fI\- \fRindica che il "seek" dovrebbe posizionarsi ad quel numero di +caratteri dalla fine dell'input (o se in combinazione con +\fI \+ \fR: prime della posizione corrente nel file "standard input"). +Se non si specifica una opzione \-s option, xxd inizia alla posizione +corrente all'interno del file. +.TP +.I \-u +usa lettere esadecimali maiuscole. Il valore predefinito ц╗ di usare +lettere minuscole. +.TP +.IR \-v " | " \-version +visualizza la stringa contenente la versione del programma. +.SH ATTENZIONE +.PP +.I xxd \-r +ц╗ capace di operare "magie" nell'utilizzare l'informazione "numero di linea". +Se sul file di output ci si puц╡ posizionare usando la "seek", il numero di +linea all'inizio di ogni riga esadecimale puц╡ essere non ordinato, delle +linee possono mancare delle linee, oppure esserci delle sovrapposizioni. +In simili casi xxd userц═ lseek(2) per raggiungere la posizione d'inizio. +Se il file di output non consente di usare "seek", sono permessi solo dei +"buchi", che saranno riempiti con zeri binari. +.PP +.I xxd \-r +non genera mai errori di specifica parametri. I parametri non riconosciuti +sono silenziosamente ignorati. +.PP +Nel modificare immagini esadecimali, tenete conto che +.I xxd \-r +salta il resto della linea, dopo aver letto abbastanza caratteri contenenti +dati esadecimali (vedere opzione \-c). Ciц╡ implica pure che le modifiche alle +colonne di caratteri stampabili ascii (o ebcdic) sono sempre ignorate. +La ricostruzione da un file immagine esadecimale in stile semplice +(postscript) con xxd \-r \-p non dipende dal numero corrretto di colonne. +IN questo caso, qualsiasi cosa assomigli a una coppia di cifre esadecimali +ц╗ interpretata [e utilizzata]. +.PP +Notare la differenza fra +.br +\fI% xxd \-i file\fR +.br +e +.br +\fI% xxd \-i \< file\fR +.PP +.I xxd \-s \+seek +puц╡ comportarsi in modo diverso da +.I xxd \-s seek +, perchц╘ lseek(2) ц╗ usata per tornare indietro nel file di input. Il '+' +fa differenza se il file di input ц╗ lo "standard input", e se la pozione nel +file di "standard input" non ц╗ all'inizio del file quando xxd ц╗ eseguito, +con questo input. +I seguenti esempi possono contribuire a chiarire il concetto +(o ad oscurarlo!)... +.PP +Riavvolge lo "standard input" prima di leggere; necessario perchц╘ `cat' +ha giц═ letto lo stesso file ["file"] fino alla fine dello "standard input". +.br +\fI% sh \-c 'cat > copia_normale; xxd \-s 0 > copia_esadecimale' < file +.PP +Stampa immagine esadecimale dalla posizione file 0x480 (=1024+128) in poi. +Il segno `+' vuol dire "rispetto alla posizione corrente", quindi il `128' +si aggiunge a 1k (1024) dove `dd' si era fermato. +.br +\fI% sh \-c 'dd of=normale bs=1k count=1; xxd \-s +128 > esadecimale' < file +.PP +Immagine esadecimale dalla posizione 0x100 ( = 1024-768 ) del file in avanti. +.br +\fI% sh \-c 'dd of=normale bs=1k count=1; xxd \-s +-768 > esadecimale' < file +.PP +Comunque, questo capita raramente, e l'uso del `+' di rado. +L'autore preferisce monitorare il comportamento di xxd con strace(1) o +truss(1), quando si usa l'opzione \-s. +.SH ESEMPI +.PP +.br +Stampa tutto tranne le prime tre linee (0x30 bytes esadecimali) di +.B file +\. +.br +\fI% xxd \-s 0x30 file +.PP +.br +Stampa 3 linee (0x30 bytes esadecimali) alla fine di +.B file +\. +.br +\fI% xxd \-s \-0x30 file +.PP +.br +Stampa 120 bytes come immagine esadecimale continua con 40 bytes per linea. +.br +\fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR + +.br +2e54482058584420312022417567757374203139 +.br +39362220224d616e75616c207061676520666f72 +.br +20787864220a2e5c220a2e5c222032317374204d +.br +617920313939360a2e5c22204d616e2070616765 +.br +20617574686f723a0a2e5c2220202020546f6e79 +.br +204e7567656e74203c746f6e79407363746e7567 +.br + +.br +Stampa i primi 120 bytes della pagina di manuale vim.1 a 12 bytes per linea. +.br +\fI% xxd \-l 120 \-c 12 xxd.1\fR + + +.br +0000000: 2e54 4820 5858 4420 3120 2241 .TH XXD 1 "A +.br +000000c: 7567 7573 7420 3139 3936 2220 ugust 1996" +.br +0000018: 224d 616e 7561 6c20 7061 6765 "Manual page +.br +0000024: 2066 6f72 2078 7864 220a 2e5c for xxd"..\ +.br +0000030: 220a 2e5c 2220 3231 7374 204d "..\" 21st M +.br +000003c: 6179 2031 3939 360a 2e5c 2220 ay 1996..\" +.br +0000048: 4d61 6e20 7061 6765 2061 7574 Man page aut +.br +0000054: 686f 723a 0a2e 5c22 2020 2020 hor:..\" +.br +0000060: 546f 6e79 204e 7567 656e 7420 Tony Nugent +.br +000006c: 3c74 6f6e 7940 7363 746e 7567 <tony@sctnug +.PP +.br +Visualizza la data dal file xxd.1 +.br +\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR +.br +0000036: 3231 7374 204d 6179 2031 3939 36 21st May 1996 +.PP +.br +Copiare +.B input_file +su +.B output_file +premettendogli 100 bytes a 0x00. +.br +\fI% xxd input_file | xxd \-r \-s 100 \> output_file\fR +.br + +.br +Modificare (patch) la data nel file xxd.1 +.br +\fI% echo '0000037: 3574 68' | xxd \-r \- xxd.1\fR +.br +\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR +.br +0000036: 3235 7468 204d 6179 2031 3939 36 25th May 1996 +.PP +.br +Creare un file di 65537 tutto a 0x00, +tranne che l'ultimo carattere che ц╗ una 'A' (esadecimale 0x41). +.br +\fI% echo '010000: 41' | xxd \-r \> file\fR +.PP +.br +Stampa una immagine esadecimale del file di cui sopra con opzione autoskip. +.br +\fI% xxd \-a \-c 12 file\fR +.br +0000000: 0000 0000 0000 0000 0000 0000 ............ +.br +* +.br +000fffc: 0000 0000 40 ....A +.PP +Crea un file di 1 byte che contiene il solo carattere 'A'. +Il numero dopo '\-r \-s' viene aggiunto a quello trovato nel file; +in pratica, i bytes precedenti non sono stampati. +.br +\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> file\fR +.PP +Usare xxd come filtro all'interno di un editor come +.B vim(1) +per ottenere una immagine esadecimale di una parte di file +delimitata dai mark `a' e `z'. +.br +\fI:'a,'z!xxd\fR +.PP +Usare xxd come filtro all'interno di un editor come +.B vim(1) +per ricostruire un pezzo di file binario da una immagine esadecimale +delimitata dai mark `a' e `z'. +.br +\fI:'a,'z!xxd \-r\fR +.PP +Usare xxd come filtro all'interno di un editor come +.B vim(1) +per ricostruire una sola linea di file binario da una immagine esadecimale, +Portare il cursore sopra la linea e battere: +.br +\fI!!xxd \-r\fR +.PP +Per leggere singoli charatteri da una linea seriale +.br +\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 CODICI DI RITORNO +Il programma puц╡ restituire questi codici di errore: +.TP +0 +nessun errore rilevato. +.TP +\-1 +operazione non supportata ( +.I xxd \-r \-i +non ancora possible). +.TP +1 +errore durante la scansione parametri. +.TP +2 +problemi con il file di input. +.TP +3 +problemi con il file di output. +.TP +4,5 +posizione "seek" specificata non raggiungibile all'interno del file. +.SH VEDERE ANCHE +uuencode(1), uudecode(1), patch(1) +.br +.SH AVVERTIMENTI +La stranezza dello strumento rispecchia la mente del suo creatore. +Usate a vostro rischio e pericolo. Copiate i file. Tracciate l'esecuzione. +Diventate un mago. +.br +.SH VERSIONE +Questa pagina di manuale documenta la versione 1.7 di xxd. +.SH AUTORE +.br +(c) 1990-1997 Juergen Weigert +.br +<jnweiger@informatik.uni-erlangen.de> +.LP +Distribuite liberamente ed attribuitemi il credito, +.br +fate soldi e condivideteli con me +.br +perdete soldi e non venite a chiederli a me. +.PP +Pagina di manuale messa in piedi da Tony Nugent +.br +<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> +.br +Piccole modifiche di Bram Moolenaar. +Modificato da Juergen Weigert. +.PP |