Mercurial > vim
changeset 35999:ecb5d46edd81
translation(ru): update man pages
Commit: https://github.com/vim/vim/commit/12333bae0175edda16ea2e1201e12224989e3ef2
Author: RestorerZ <restorer@mail2k.ru>
Date: Tue Aug 20 19:57:00 2024 +0200
translation(ru): update man pages
closes: https://github.com/vim/vim/issues/15532
Signed-off-by: RestorerZ <restorer@mail2k.ru>
Signed-off-by: Christian Brabandt <cb@256bit.org>
author | Christian Brabandt <cb@256bit.org> |
---|---|
date | Tue, 20 Aug 2024 20:00:11 +0200 |
parents | 859c6a518734 |
children | 20316ae9790d |
files | runtime/doc/evim-ru.1 runtime/doc/evim-ru.UTF-8.1 runtime/doc/vim-ru.1 runtime/doc/vim-ru.UTF-8.1 runtime/doc/vimdiff-ru.1 runtime/doc/vimdiff-ru.UTF-8.1 runtime/doc/vimtutor-ru.1 runtime/doc/vimtutor-ru.UTF-8.1 runtime/doc/xxd-ru.1 runtime/doc/xxd-ru.UTF-8.1 |
diffstat | 10 files changed, 1780 insertions(+), 1174 deletions(-) [+] |
line wrap: on
line diff
--- a/runtime/doc/evim-ru.1 +++ b/runtime/doc/evim-ru.1 @@ -1,59 +1,69 @@ -.TH EVIM 1 "2002 February 16" -.SH -evim \- Vim, Vim -.SH +.TH EVIM 1 "12 2024" +.SH + evim \[em] ݣ Vim, Vim + . +.SH .br .B evim -[] [ ..] +[] [ ...] .br .B eview .SH - + .B evim - + .B Vim - , - . Vim -Notepad MS-Windows. + , + . Vim + Notepad MS Windows. + .B eVim - , - . + , + . .PP - , - - Vim . - , Vim. + , - + Vim. + , . .PP - + .B eview - , " - ". -evim \-R. + , " ". + evim \-R. .PP - Vim, .. + Vim, . . vim(1). .PP - + .B evim - 'insertmode', . + 'insertmode', +. .br - , , MS-Windows - . CTRL-X -, CTRL-C CTRL-V . - CTRL-V, CTRL-Q. -.SH -. vim(1). + , , + , , + MS Windows. + CTRL+X , CTRL+C + CTRL+V . + , CTRL+V, + CTRL+Q. +.SH +. vim(1). .SH .TP 15 -/usr/local/lib/vim/evim.vim +/usr/local/share/vim/vim??/evim.vim , eVim. -.SH AKA -eVim "Vim ". +.br + +.I "vim??" + ݣ , , vim91 +.B Vim 9.1 +.SH + eVim "Vim ". , . -.SH +.SH vim(1) .SH - + .B Vim - (Bram Moolenaar), - . . /. + (Bram Moolenaar), + . . .
--- a/runtime/doc/evim-ru.UTF-8.1 +++ b/runtime/doc/evim-ru.UTF-8.1 @@ -1,59 +1,69 @@ -.TH EVIM 1 "2002 February 16" -.SH ИМЯ -evim \- простой Vim, позволяет редактировать файл с помощью Vim в безрежимном режиме -.SH КОМАНДНАЯ СТРОКА +.TH EVIM 1 "12 августа 2024" +.SH НАЗНАЧЕНИЕ +Программа evim \[em] это упрощённый Vim, которая производит запуск редактора Vim +в безрежимном варианте редактирования файлов. +.SH КРАТКИЙ ОБЗОР .br .B evim -[ключи] [файл ..] +[аргументы] [файл ...] .br .B eview .SH ОПИСАНИЕ -Команда +По команде .B evim -запускает +запускается редактор .B Vim -и настраивает ряд опций таким образом, что он начинает вести себя -как обычный безрежимный редактор. В этом режиме Vim напоминает -Notepad из MS-Windows. +и выполняется настройка ряда параметров таким образом, чтобы его работа была как +у простых безрежимных редакторов. В этом режиме редактор Vim напоминает +редактор Notepad из MS Windows. +Вариант редактора .B eVim -всегда запускается с поддержкой графического интерфейса, чтобы обеспечить -использование меню и инструментальной панели. +всегда запускается с поддержкой графического интерфейса, чтобы была возможность +взаимодействия с программой через меню и панель инструментов. .PP -Эта команда создана для тех, кто по каким-то причинам не в состоянии -работать с Vim в обычном режиме. Редактирование файлов при этом происходит -гораздо менее эффективно, чем при использовании обычного Vim. +Этот вариант редактора сделан для тех, кто по каким-то причинам не в состоянии +работать с обычным редактором Vim. Редактирование файлов при этом происходит +гораздо менее эффективно, чем при использовании стандартного варианта редактора. .PP -Команда +По команде .B eview -выполняет почти ту же самую задачу, но файл открывается в режиме "только -для чтения". Использование этой команды полностью идентично использованию -evim \-R. +выполняются почти те же самые действия, но файл будет открыт "только для чтения". +Использование этой команды полностью идентично команде evim \-R. .PP -Подробнее о Vim, ключах запуска и т.п. смотрите на странице справочника +Подробнее о редакторе Vim, аргументах запуска и т. п. смотрите в справочнике vim(1). .PP -При использовании +По команде .B evim -включается опция 'insertmode', что позволяет вводить текст напрямую. +будет установлен параметр 'insertmode', что обеспечивает ввод текста напрямую в +буфер. .br -Кроме того, настраиваются привязки, позволяющие использовать кнопки MS-Windows -для выполнения команд копирования и вклейки. CTRL-X используется для вырезания -текста, CTRL-C для копирования и CTRL-V для вклейки. Чтобы воспользоваться -изначальным значением кнопки CTRL-V, используйте CTRL-Q. -.SH ПАРАМЕТРЫ ЗАПУСКА -См. vim(1). +Кроме того, настраиваются клавиатурные команды, позволяющие выполнять +копирование и вставку текста, используя такие же комбинации клавиш, +как в MS Windows. +Клавиши CTRL+X используются для вырезания текста, CTRL+C для копирования +и CTRL+V для вставки. +Чтобы выполнить ту же команду, которая раньше была назначена на клавиши CTRL+V, +используйте клавиши CTRL+Q. +.SH АРГУМЕНТЫ КОМАНДНОЙ СТРОКИ +См. справочник vim(1). .SH ФАЙЛЫ .TP 15 -/usr/local/lib/vim/evim.vim +/usr/local/share/vim/vim??/evim.vim Сценарий, который загружается для инициализации eVim. -.SH AKA -eVim также известен как "Vim для чайников". +.br +Здесь +.I "vim??" +означает сокращённую запись номера версии, например, vim91 для версии редактора +.B Vim 9.1 +.SH ДРУГИМИ СЛОВАМИ +Вариант eVim также известен как "Vim для чайников". Для наилучшего эффекта рекомендуется во время использования повязать на голове платок, предварительно завязав на каждом конце по узелку. -.SH СМОТРИ ТАКЖЕ +.SH СМОТРИТЕ ТАКЖЕ vim(1) .SH АВТОРЫ -Большая часть +Большая часть редактора .B Vim -создана Брамом Мооленааром (Bram Moolenaar), которому помогает огромное -количество людей. См. меню Справка/Благодарности. +была создана Брамом Моленаром (Bram Moolenaar), которому помогало огромное +количество людей. См. меню Справка пункт Соавторы.
--- a/runtime/doc/vim-ru.1 +++ b/runtime/doc/vim-ru.1 @@ -1,19 +1,20 @@ -.TH VIM 1 "2002 Feb 22" -.SH -vim \- Vi IMproved ( Vi), -.SH +.TH VIM 1 "12 2024" +.SH + Vim \[em] Vi IMproved ( Vi), +. +.SH .br .B vim -[] [ ..] +[] [ ...] .br .B vim -[] \- +[] \- .br .B vim -[] \-t +[] \-t .br .B vim -[] \-q [ ] +[] \-q [ ] .PP .br .B ex @@ -22,468 +23,669 @@ vim \- Vi IMproved ( Vi), .br .B gvim .B gview +.B evim +.B eview .br .B rvim .B rview .B rgvim .B rgview .SH + .B Vim --- , - Vi. - . - . +\[em] , Vi. + . + . .PP - Vi, + Vi, .B Vim - : , + : , , , , - ͣ , , .. -. ":help vi_diff.txt" + , , + . +. ":help vi_diff.txt" + .B Vim - Vi. + Vi. .PP - -.B Vim - ( ":help"). -. " " . + +.B Vim, + , + ":help". +. " " . .PP - + .B Vim .PP vim .PP - + .B Vim : .PP - vim [] [ ] + vim [] [] .PP - , Σ . - ң : + , + . + ң : .TP 12 - .. - ͣ . - . ݣ - . ̣ - ":next". , -"" (-), "--". + ... + . + , + . + ̣ ":next". , + "" (\-), + "\-\-". .TP \- - . - (stderr), -. + . + (stderr), + . .TP -\-t {} - "", goto. -{} , , - . - , {} -. -, , , . -. ":help tag-commands". +\-t {} + "", + goto. {} +, + {} . + , {} + . +, , , + . +. ":help tag\-commands". .TP -\-q [ ] - . - [ ] . - [ ] , ң 'errorfile' -( : "AztecC.Err" Amiga, "errors.err" ). - ":cn". +\-q [ ] + . + [ ] . + [ ] , ң + 'errorfile' ( Amiga "AztecC.Err", + \[em] "errors.err"). + ":cn". . ":help quickfix". .PP + .B Vim -ģ - ( - ). +ģ - + ( ). .TP 10 vim -"" , ӣ . + "" , ӣ . .TP ex - Ex. - ":vi". Ex - "\-e". + Ex-. , + ":vi". +Ex- "\-e". .TP view - " ". -. "\-R". + " ". + . + "\-R". .TP gvim gview - . . - "\-g". + . . + "\-g". +.TP +evim eview +ݣ . . + "\-y". .TP rvim rview rgvim rgview - , . - + , . + .B Vim. - "r" "\-Z". -.SH - , ͣ -. -. + "r" "\-Z". +.SH + , . +, , + . .TP 12 +[] - ݣ . - "" , ݣ . + [] . + . + "" , . .TP +/{} - ݣ - . . ":help search-pattern" - . + . + + . . ":help search\-pattern" +. .TP +{} .TP \-c {} -{} Ex. - {} , - ( ). -: vim "+set si" main.c + {}. + {} Ex-. + {} , + ( ). +: +vim "+set si" main.c .br -: "+" "\-c". -.TP -\-\-cmd {} - "\-c", - (vimrc). - , - "\-c". +. "+" "\-c". .TP \-A - + . + .B Vim - , - , , - + + , + .B Vim - , 'arabic'. - + , . . 'arabic'. + .B Vim - . + . .TP \-b - . - , + . + , . .TP \-C - . 'compatible'. + Vi. + 'compatible', .B Vim - Vi, .vimrc. + Vi, ".vimrc". .TP \-d - . - . + . + . .B Vim - -( vimdiff(1)). + ( vimdiff(1)). .TP -\-d {} - {} ( Amiga). +\-d {}, \-dev {} + {} -. + {} ( Amiga). : "\-d con:20/30/600/150". .TP +\-D + . + . +.TP \-e - + Ex-. + .B Vim - Ex, "ex". + Ex-, , + "ex". +.TP +\-E + Ex-. + +.B Vim + Ex-, + "exim". .TP \-f - . + . + .B Vim - - ţ . Amiga + +, . + Amiga .B Vim - . , - + . + , .B Vim , (, ). - Amiga ":sh" ":!" . -.TP -\-\-nofork - . -.B Vim - - ţ . + Amiga ":sh" ":!" . .TP \-F - + . + .B Vim - FKMAP - , + + , + .B Vim - , , ޣ -\&'fkmap' 'rightleft'. - + , . . 'fkmap' + 'rightleft'. + .B Vim - . + . +.br +. 8.1.0932. .TP \-g - -.B Vim - , - . + . + .B Vim - . -.TP -\-h - . - + , + . + .B Vim - . + . .TP \-H - + . + .B Vim - - , + + , + +.B Vim + , . . 'hkmap' + 'rightleft'. + .B Vim - , , ޣ 'hkmap' 'rightleft'. - -.B Vim - . + . .TP -\-i {viminfo} - viminfo, ( -"~/.viminfo" ). viminfo -ԣ "NONE". +\-i {} + {}. + viminfo- ( + ".viminfo"). viminfo- + "NONE" ( ). +.TP +\-l + Lisp. + 'lisp' 'showmatch'. .TP \-L - , \-r. -.TP -\-l - Lisp. 'lisp' 'showmatch'. + , \-r. .TP \-m - . 'write', - . + . + 'write', + , ӣ . +.TP +\-M + . + 'modifiable' 'write' , +, . + , , +, . +.TP +\-n + . + . + (, ). + ":set uc=0". \[em] +":set uc=200". .TP \-N - . 'compatible'. + Vi. + 'compatible'. + .B Vim - , Vi, - (.vimrc). + , Vi, + (".vimrc"). .TP -\-n - -. . - (, ). - ":set uc=0". -- ":set uc=200". +\-nb + Vim NetBeans. + . .TP \-o[N] - N , ̣ . N , - . + N , . + N , . .TP \-O[N] - N , ̣ . N , - . + N , . + N , . +.TP +\-p[N] + N . + N , . .TP -\-R - " ". 'readonly'. - , - . - Ex (, ":w!"). - "\-R" , "\-n" (. ). - 'readonly' ":set noro". -. ":help 'readonly'". +\-P { } + . + MS Windows. . + , Vim +. { }. +, { } . , + ӣ ݣ . + . .TP \-r - - . + . + + . .TP \-r {} - . - -. -- , , ".swp". + ۣ . + . + , , + ".swp". . ":help recovery". .TP +\-R + . + 'readonly'. + , + . + Ex- (, ":w!"). + "\-R" , +"\-n" (. ). + 'readonly' ":set noro". +. ":help 'readonly'". +.TP \-s - . "Ex" "\-s" "\-e". -.TP -\-s {scriptin} - {scriptin}. , - , . - ":source! {scriptin}". - , - . + . + "ex" + "\-s" "\-e". .TP -\-T {terminal} - -.B Vim - . , - . - -.B Vim -( ) termcap terminfo. +\-s { } + { }. + , + . + ":source! { }". + { } +, . +.TP +\-S {} + {}. + , {}. + \-c "source {}". + {} '\-'. + {}, "Session.vim" ( + \-S ). .TP -\-u {vimrc} - {vimrc} . - . - . - , - "NONE". . ":help initialization". +\-T {} + {}. + +.B Vim + . + , + . +.B Vim +( ) termcap terminfo. .TP -\-U {gvimrc} - {gvimrc} -. - . - , - "NONE". . ":help gui-init". +\-u {} + {}. + . + . + +, "NONE" ( ). +. ":help initialization". .TP -\-V -"" . , , -- viminfo. +\-U {} + + {}. + . + + , "NONE" ( ). +. ":help gui\-init". .TP \-v - + Vi. + .B Vim - Vi, "vi". - "ex". + Vi, "vi". + "ex". +.TP +\-V[N] + . + , , + viminfo-. N + . + 10. .TP -\-w {scriptout} - , ģ , - {scriptout}. - , - "vim \-s" ":source!". {scriptout} , - . +\-V[N]{} + \-V, 'verbosefile' + {}. , {}, + . {} - +. +.TP +\-w{} + 'window' , {}. .TP -\-W {scriptout} - "\-w", . +\-w {} + ģ {}. + , ģ +, {}. + , + "vim \-s" ":source!". + {} , . +.TP +\-W {} + ģ {}. + "\-w", {} . .TP \-x - . . + . + +.B Vim + , . + . .TP \-X - X-. , - . + X-. + , + . +.TP +\-y + ݣ . + +.B Vim + ݣ , +"evim" "eview". + +.B Vim + , . .TP \-Z - . , , "r". + . + , , + "r". .TP \-\- - . . - , . + . + , . + , +. +.TP +\-\-clean + ( vimrc, + . .). , + Vim. +.TP +\-\-cmd {} + "\-c", + (vimrc). + , "\-c". +.TP +\-\-echo\-wid + GTK. +(Window ID) (stdout). +.TP +\-\-gui\-dialog\-file {} + , + {} . + {} , , + {}. + , , + . + , . .TP -\-\-help - . , "\-h". +\-\-help, \-h, \-? + . + +.B Vim + . +.TP +\-\-literal + , +, . + Unix- , + . .TP -\-\-version - . +\-\-log {} + . + +.B Vim + "eval" "channel", + , {}. + +.I ch_logfile({filename}, 'ao') +.TP +\-\-nofork + . + +.B Vim + + , . +.TP +\-\-noplugin + . + \-u NONE. +.TP +\-\-not\-a\-term + -. + , - + . +, . .TP \-\-remote - Vim , - . , , - Vim. + Vim- , + . , +, Vim. .TP \-\-remote\-expr {} - Vim Σ {}. + Vim- {} +. (stdout). .TP -\-\-remote\-send {} - Vim {}. +\-\-remote\-send { } + Vim- { }. .TP \-\-remote\-silent "\-\-remote", , . .TP \-\-remote\-wait - "\-\-remote", Vim , - . + "\-\-remote", Vim , + . .TP \-\-remote\-wait\-silent "\-\-remote\-wait", , . .TP \-\-serverlist - Vim. + Vim-. .TP -\-\-servername {} - {} . -"\-\-remote" , {} Vim, - , -. +\-\-servername {} + {} . +"\-\-remote" , {} Vim, + , . .TP \-\-socketid {id} - GTK: GtkPlug - gvim . + GTK. GtkPlug + gVim . +.TP +\-\-startuptime {} + {}. +.TP +\-\-ttyfail + , - (tty). +.TP +\-\-version + . .TP -\-\-echo\-wid - GTK: (Window ID) - (stdout). -.SH - , ":help". - ":help ", . -, ":help ZZ" "ZZ". - <Tab> CTRL-D - (":help cmdline-completion"). - (- +\-\-windowid {} + MS Windows. gVim + {} , + . +.SH + , +.B Vim + ":help". + ":help ", . +, ":help ZZ" "ZZ". + <TAB> CTRL+D +(. ":help cmdline\-completion"). + (- , . ":help"). - , ":help syntax.txt". + , , ":help syntax.txt". .SH .TP 15 -/usr/local/lib/vim/doc/*.txt - +/usr/local/share/vim/vim??/doc/*.txt + .B Vim. -. ":help doc-file-list" . -.TP -/usr/local/lib/vim/doc/tags - , . +. ":help doc\-file\-list" . +.br + +.I "vim??" + ݣ , , vim91 +.B Vim 9.1 .TP -/usr/local/lib/vim/syntax/syntax.vim - . +/usr/local/share/vim/vim??/doc/tags + , . +.TP +/usr/local/share/vim/vim??/syntax/syntax.vim + . .TP -/usr/local/lib/vim/syntax/*.vim - . +/usr/local/share/vim/vim??/syntax/*.vim + . .TP -/usr/local/lib/vim/vimrc - +/usr/local/share/vim/vimrc + .B Vim. .TP -/usr/local/lib/vim/gvimrc - . +~/.vimrc, ~/.vim/vimrc, $XDG_CONFIG_HOME/vim/vimrc + +.B Vim +( ). +.TP +/usr/local/share/vim/gvimrc + +.B gVim. .TP -/usr/local/lib/vim/optwin.vim -, ":options". - . +~/.gvimrc, ~/.vim/gvimrc, $XDG_CONFIG_HOME/vim/gvimrc + + +.B gVim +( ). .TP -/usr/local/lib/vim/menu.vim - gvim. +/usr/local/share/vim/vim??/optwin.vim + , ":options". + . .TP -/usr/local/lib/vim/bugreport.vim - ޣ . . ":help bugs". +/usr/local/share/vim/vim??/menu.vim + +.B gVim. .TP -/usr/local/lib/vim/filetype.vim - . . ":help 'filetype'". +/usr/local/share/vim/vim??/bugreport.vim + ޣ . . ":help bugs". .TP -/usr/local/lib/vim/scripts.vim - . . ":help 'filetype'". +/usr/local/share/vim/vim??/filetype.vim + . +. ":help 'filetype'". .TP -/usr/local/lib/vim/print/*.ps - PostScript. +/usr/local/share/vim/vim??/scripts.vim + . +. ":help 'filetype'". +.TP +/usr/local/share/vim/vim??/print/*.ps +, PostScript. .PP - -- VIM: + - VIM: .br <URL:http://www.vim.org/> -.SH +.SH vimtutor(1) .SH - + .B Vim - (Bram Moolenaar), - . . ":help credits" + (Bram Moolenaar), + . . ":help credits" .B Vim. .br + .B Vim Stevie, (Tim Thompson), (Tony Andrews) . . () (G.R. (Fred) Walter). -, Vim - . +, Vim + . .br - + .B Vim "", -. <URL:http://sourceforge.net/projects/ruvim/>. -.SH +. <URL:https://github.com/restorerz/ruvim/>. +.SH . -. ":help todo" -- . +. ":help todo" \[em] . .PP -, , , - Vi. +, , , + Vi. , - , "Vi -", vi_diff.txt -( ":help vi_diff.txt" Vim) 'compatible' - 'cpoptions'. +( ":help vi_diff.txt" Vim) + 'compatible' 'cpoptions'.
--- a/runtime/doc/vim-ru.UTF-8.1 +++ b/runtime/doc/vim-ru.UTF-8.1 @@ -1,19 +1,20 @@ -.TH VIM 1 "2002 Feb 22" -.SH ИМЯ -vim \- Vi IMproved (Улучшенный Vi), текстовый редактор для программистов -.SH КОМАНДНАЯ СТРОКА +.TH VIM 1 "12 августа 2024" +.SH НАЗНАЧЕНИЕ +Программа Vim \[em] это Vi IMproved (Улучшенный Vi), текстовый редактор для +программистов. +.SH КРАТКИЙ ОБЗОР .br .B vim -[ключи] [файл ..] +[аргументы] [файл ...] .br .B vim -[ключи] \- +[аргументы] \- .br .B vim -[ключи] \-t метка +[аргументы] \-t индекс .br .B vim -[ключи] \-q [файл ошибок] +[аргументы] \-q [файл результатов] .PP .br .B ex @@ -22,468 +23,669 @@ vim \- Vi IMproved (Улучшенный Vi), текстовый редактор для программистов .br .B gvim .B gview +.B evim +.B eview .br .B rvim .B rview .B rgvim .B rgview .SH ОПИСАНИЕ +Программа .B Vim --- текстовый редактор, обратно-совместимый с Vi. -Он может быть использован для правки всех видов простого текста. -Особенно он хорош для правки исходных текстов программ. +\[em] это текстовый редактор, совместимый с редактором Vi. +Она может быть использована для правки всех видов обычных текстовых документов. +Особенно полезна она будет для редактирования исходных текстов программ. .PP -По сравнению с Vi, +По сравнению с редактором Vi, в редакторе .B Vim -имеет много усовершенствований: многократная отмена операций, +представлено много усовершенствований: многократная отмена операций, множественность окон и буферов, подсветка синтаксиса, правка командной строки, -автодополнение имён файлов, встроенная справка, визуальное выделение и т.п. -См. ":help vi_diff.txt" для получения полного списка различий между +подстановка наименований файлов, встроенная документация, визуальное выделение +и прочее. +См. ":help vi_diff.txt" чтобы ознакомиться с полным перечнем различий между +редактором .B Vim -и Vi. +и редактором Vi. .PP -Во время работы в -.B Vim -можно получить справку с помощью системы встроенной справки (команда ":help"). -См. раздел "ВСТРОЕННАЯ СПРАВКА" ниже по тексту. +Чтобы получить полезную информацию о работе с редактором +.B Vim, +можно воспользоваться встроенной в программу документацией, набрав в редакторе +команду ":help". +См. раздел "ВСТРОЕННАЯ ДОКУМЕНТАЦИЯ" далее в тексте. .PP -Чаще всего +Чаще всего редактор .B Vim запускают для правки одного файла при помощи команды .PP vim файл .PP -В общем виде команда запуска +В общем виде команда запуска редактора .B Vim выглядит так: .PP - vim [ключи] [список файлов] + vim [аргументы] [файлы] .PP -Если список файлов отсутствует, редактор начнёт работу с пустым буфером. -В противном случае имя файла должно быть указано одним из следующих четырёх способов: +Если файлы не указаны, редактор будет запущен с доступным для редактирования +пустым буфером. +Наименования файлов могут быть указаны одним из следующих четырёх способов: .TP 12 -файл .. -Список имён файлов. -Первый файл будет объявлен активным и загружен в буфер. Курсор будет помещён -в первой строке буфера. Доступ к другим файлам может быть осуществлён при -помощи команды ":next". Чтобы править файл, имя которого начинается с символа -"дефис" (-), перед списком файлов необходимо поставить "--". +файл ... +Перечень наименований файлов. +Первый файл из перечня будет объявлен активным и загружен в буфер, а каретка +установлена на первой строке этого буфера. Доступ к другим файлам из этого +перечня может быть осуществлён при помощи команды ":next". Чтобы править файл, +наименование которого начинается с символа "дефис" (\-), перед перечнем файлов +необходимо указать символы "\-\-". .TP \- -Файл будет прочитан из потока стандартного ввода. Команды будут считываться -из стандартного потока диагностики (stderr), который должен быть -терминалом. +Текст для правки будет считан из потока стандартного ввода. Команды будут +считываться из стандартного потока диагностики (stderr), который должен +предоставляться терминалом. .TP -\-t {метка} -Имя файла и начальная позиция курсора зависят от "метки", похожей на метку goto. -{метка} ищется в файле меток, соответствующий файл становится активным, а -соответствующая команда исполняется. -Чаще всего используется в программах на языке Си, где {метка} может быть именем -функции. -Файл, содержащий функцию, становится активным, а курсор помещается в начало функции. -См. ":help tag-commands". +\-t {индекс} +Файла для правки и начальная позиция каретки зависят от значения "индекса", +являющийся своего рода меткой goto. Поиск самого {индекса} выполняется в файле +индексов, а сопоставленный с ним файл будет открыт в редакторе и выполнена +связанная с этим {индексом} команда. +Чаще всего этот способ используется для программ на языке Си, где {индекс} может +быть наименованием функции. +Файл, содержащий такую функцию, становится активным, а каретка помещается +в начало этой функции. +См. ":help tag\-commands". .TP -\-q [файл ошибок] -Начать работу в режиме быстрого исправления. -При этом считывается [файл ошибок] и первая ошибка выводится на экран. -Если [файл ошибок] не указан, имя файла берётся из значения опции 'errorfile' -(по умолчанию: "AztecC.Err" для Amiga, "errors.err" для других систем). -К следующим ошибкам можно перейти по команде ":cn". +\-q [файл результатов] +Начать работу редактора в цикле быстрого исправления текста программ. +Будет считан [файл результатов] и отображена первая запись из этого файла. +Если [файл результатов] не указан, то его наименование берётся из значения +параметра 'errorfile' (по умолчанию для ОС Amiga это "AztecC.Err", а для других +систем \[em] "errors.err"). +К следующей записи в файле результатов можно перейти по команде ":cn". См. ":help quickfix". .PP +Программа .B Vim -ведёт себя по-разному в зависимости от имени команды (исполняемый файл может -быть одним и тем же). +ведёт себя по-разному в зависимости от указанной в командной строке команды +вызова редактора (исполняемый файл при этом может быть одним и тем же). .TP 10 vim -"Нормальный" запуск, всё по умолчанию. +Это "нормальный" запуск редактора, всё по умолчанию. .TP ex -Запуск в режиме Ex. Для перехода в нормальный режим -необходимо выполнить команду ":vi". Режим Ex включает -также ключ "\-e". +Запуск редактора в Ex-режиме. Для переключения в обычный режим, необходимо +набрать команду ":vi". +Ex-режим также может быть активирован через аргумент "\-e". .TP view -Запуск в режиме "только для чтения". Вы будете защищены от случайной записи -файла. То же самое можно сделать ключом "\-R". +Запуск редактора в режиме "только для чтения". В этом режиме есть некоторая +защита от случайной перезаписи файлов. +То же самое можно сделать через указание аргумента "\-R". .TP gvim gview -Версия с графическим интерфейсом. Запускается в новом окне. -То же самое можно сделать при запуске с ключом "\-g". +Запуск редактора с графическим интерфейсом. Для этого будет открыто новое окно. +То же самое можно сделать при запуске с аргументом "\-g". +.TP +evim eview +Упрощённый вариант редактора с графическим интерфейсом. Запускается в новом окне. +То же самое можно сделать через аргумент "\-y". .TP rvim rview rgvim rgview -Как и предыдущие команды, но с ограничениями. Нельзя запускать команды оболочки -или приостанавливать работу +Как и предыдущие команды, но с некоторыми ограничениями в функциональности. +Нельзя запускать команды оболочки или приостанавливать работу редактора .B Vim. -Вместо приставки "r" можно использовать ключ "\-Z". -.SH КЛЮЧИ -Ключи могут быть указаны в любом порядке, до или после имён -файлов. Ключи без аргументов могут быть объединены под одним -дефисом. +Вместо приставки "r" можно использовать аргумент командной строки "\-Z". +.SH АРГУМЕНТЫ КОМАНДНОЙ СТРОКИ +Аргументы могут быть указаны в любом порядке, до или после наименований файлов. +Аргументы, не требующие значений, могут быть объединены с указанием только +одного дефиса. .TP 12 +[номер] -В первом файле курсор будет помещён на строку с указанным номером. -Если "номер" не указан, курсор будет помещён на последнюю строку. +Установка каретки на [номер] строки. +В первом открытом файле каретка будет установлена на строку с указанным номером. +Если "номер" не задан, каретка устанавливается на последней строке файла. .TP +/{шаблон} -В первом файле курсор будет помещён на место первого совпадения -с указанным шаблоном. См. ":help search-pattern" для получения -списка допустимых шаблонов. +Установка каретки на найденной строке. +В открытом файле каретка будет установлена в строке первого совпадения +с указанным шаблоном. См. ":help search\-pattern" для ознакомления с допустимыми +шаблонами. .TP +{команда} .TP \-c {команда} -{команда} исполняется после загрузки первого файла как команда Ex. -Если {команда} содержит пробелы, то она должна быть заключена в -двойные кавычки (в зависимости от используемой оболочки). -Пример: vim "+set si" main.c +Исполнение указанной {команды}. +После загрузки первого файла будет исполнена указанная {команда} как Ex-команда. +Если в тексте {команда} есть пробелы, то она должна быть заключена в +двойные кавычки (в зависимости от используемой командной оболочки). +Пример: +vim "+set si" main.c .br -Примечание: Можно указывать до десяти команд "+" или "\-c". -.TP -\-\-cmd {команда} -Как "\-c", но команда исполняется перед обработкой любого файла -настроек (vimrc). -Можно указывать до десяти таких команд, независимо от количества -команд "\-c". +Примечание. Можно указывать до десяти команд "+" или "\-c". .TP \-A -Если +Запуск программы с поддержкой арабской письменности. +Если программа .B Vim -был собран с поддержкой арабского языка для правки файлов, -набранных справа налево, и с поддержкой арабской клавиатуры, -этот ключ запускает +была собрана с поддержкой правки текста с написанием справа налево +и с поддержкой клавиатуры для арабского языка, то будет выполнен запуск +редактора .B Vim -в арабском режиме, с включенной опцией 'arabic'. В противном -случае +в режиме работы с арабской письменностью, т. е. установлен параметр 'arabic'. +В противном случае редактор .B Vim -завершает работу с ошибкой. +завершит работу с сообщением об ошибке. .TP \-b -Двоичный режим. -Производится настройка некоторых опций, делающих возможной правку +Запуск программы в режиме работы с двоичными данными. +Производится настройка некоторых параметров, делающих возможной правку двоичного или исполняемого файла. .TP \-C -Режим совместимости. Включает опцию 'compatible'. +Работа в варианте совместимости с редактором Vi. +Будет установлен параметр 'compatible', и редактор .B Vim -будет работать почти как Vi, даже если существует файл .vimrc. +будет работать почти как редактор Vi, даже если существует файл ".vimrc". .TP \-d -Режим поиска различий. -Должно быть указано два или три имени файла. +Режим сравнения различий. +Может быть указано от двух до восьми наименований файлов. В редакторе .B Vim -откроет все файлы и покажет различия между ними -(как vimdiff(1)). +будут открыты все файлы и показаны различия между ними (как vimdiff(1)). .TP -\-d {устройство} -Открыть {устройство} для использования в качестве терминала (только на Amiga). +\-d {устройство}, \-dev {устройство} +Использовать {устройство} для операций ввода-вывода. +Открыть {устройство} для использования в качестве терминала (только в ОС Amiga). Пример: "\-d con:20/30/600/150". .TP +\-D +Запуск программы в режиме диагностики. +Переключение в режим отладки при исполнении первой команды из командного файла. +.TP \-e -Запустить +Запуск программы в Ex-режиме. +Редактор .B Vim -в режиме Ex, как будто исполняемый файл имеет имя "ex". +будет работоать в Ex-режиме, тоже, что в командной строке оболочки набрать +команду "ex". +.TP +\-E +Запуск программы в улучшенном Ex-режиме. +Редактор +.B Vim +будет работать в улучшенном Ex-режиме, это аналогично набору в командной +оболочке команды "exim". .TP \-f -Режим активного приложения. Версия +Режим активного приложения. +Редактор .B Vim -с графическим интерфейсом не будет ветвиться и отключаться -от запустившей её оболочки. На платформе Amiga +с графическим интерфейсом не будет наследоваться и отключаться от командной +оболочки, в которой выполнена команда его запуска. +На платформе Amiga редактор .B Vim -не будет создавать новое окно. Этот ключ нужно использовать, -когда +не будет перезапускаться для создания нового окна. Этот аргумент командной +строки нужно использовать, когда редактор .B Vim запускается программой, которая должна ждать завершения сеанса правки (например, программа для работы с электронной почтой). -На платформе Amiga команды ":sh" и ":!" не будут работать. -.TP -\-\-nofork -Режим активного приложения. Версия -.B Vim -с графическим интерфейсом не будет ветвиться и отключаться -от запустившей её оболочки. +На платформе Amiga в этом случае команды ":sh" и ":!" не будут работать. .TP \-F -Если +Запуск программы с поддержкой персидской письменности. +Если программа .B Vim -был собран с поддержкой FKMAP для правки текста справа налево -и настроек клавиатуры для языка фарси, этот ключ запускает +была собрана с поддержкой правки текста с написанием справа налево +и с поддержкой клавиатуры для персидского языка, то будет выполнен запуск +редактора .B Vim -в режиме фарси, иначе говоря, с включёнными опциями -\&'fkmap' и 'rightleft'. -В противном случае +в режиме работы с персидской письменностью, т. е. установлены параметры 'fkmap' +и 'rightleft'. +В противном случае редактор .B Vim -завершает работу с сообщением об ошибке. +завершит работу с сообщением об ошибке. +.br +Примечание. Поддержка персидской письменности была удалена в версии 8.1.0932. .TP \-g -Если -.B Vim -был собран с поддержкой графического интерфейса, этот ключ -включает графический интерфейс. В противном случае +Запуск программы с графическим интерфейсом. +Если программа .B Vim -завершает работу с сообщением об ошибке. -.TP -\-h -Выводит краткую информацию об аргументах и ключах командной строки. -После этого +была собрана с поддержкой графического интерфейса, то будет выполнен запуск +графического интерфейса пользователя. +В противном случае редактор .B Vim -завершает работу. +завершит работу с сообщением об ошибке. .TP \-H -Если +Запуск программы с поддержкой еврейской письменности. +Если программа .B Vim -был собран с поддержкой правки текста справа налево -и настроек клавиатуры для иврита, этот ключ запускает +была собрана с поддержкой правки текста с написанием справа налево +и с поддержкой клавиатуры для еврейского языка, то будет выполнен запуск +редактора +.B Vim +в режиме работы с еврейской письменностью, т. е. установлены параметры 'hkmap' +и 'rightleft'. +В противном случае редактор .B Vim -в режиме иврита, иначе говоря, с включёнными опциями 'hkmap' и 'rightleft'. -В противном случае -.B Vim -завершает работу с сообщением об ошибке. +завершит работу с сообщением об ошибке. .TP -\-i {viminfo} -Если используется файл viminfo, то этот ключ задаёт имя такого файла (вместо -"~/.viminfo" по умолчанию). Можно также избежать использования файла viminfo -путём указания имени "NONE". +\-i {файл} +Использовать в качестве файла подкачки указанный {файл}. +Через этот аргумент задаётся наименование viminfo-файла (вместо принятого +по умолчанию ".viminfo"). Здесь же можно отключить использование viminfo-файла +через указание слова "NONE" (прописными буквами). +.TP +\-l +Запуск программы в режиме Lisp. +Выполняется установка параметров 'lisp' и 'showmatch'. .TP \-L -То же, что и \-r. -.TP -\-l -Режим Lisp. Включаются опции 'lisp' и 'showmatch'. +То же, что и аргумент командной строки \-r. .TP \-m -Изменение файлов запрещено. При этом отключается опция 'write', поэтому -запись файлов становится невозможной. +Работа без возможности сохранения изменений. +Выполняется сброс параметра 'write', поэтому становится невозможным записать +в файл изменения, внесённые в буфер. +.TP +\-M +Работа без возможности внесения изменений в текст. +Параметры 'modifiable' и 'write' будут отключены, так что изменения будут +запрещены, и файлы не смогут быть записаны. +Обратите внимание, что после начала работы редактора, эти параметры можно +включить, чтобы разрешить внесение изменений. +.TP +\-n +Работа без создания файла подкачки. +В этом случае восстановление при сбое в работе редактора будет невозможно. +Удобно для правки файла на очень медленном носителе (например, гибком диске). +То же самое можно сделать командой ":set uc=0". Включение файла подкачки \[em] +":set uc=200". .TP \-N -Режим неполной совместимости. Отключается 'compatible'. +Работа в варианте неполной совместимости с редактором Vi. +Будет сброшен параметр 'compatible'. +Редактор .B Vim -будет работать лучше, но не будет полностью совместим с Vi, даже если -отсутствует файл сценария настроек (.vimrc). +будет работать лучше, но не будет полностью совместим с редактором Vi, даже если +отсутствует файл начальных настроек (".vimrc"). .TP -\-n -Не использовать своп-файл. Восстановление при сбое в работе будет невозможно. -Удобно для правки файла на очень медленном носителе (например, гибком диске). -То же самое можно сделать командой ":set uc=0". Отмена -- ":set uc=200". +\-nb +Назначить программу Vim сервером редактора для ИСР NetBeans. Подробности +смотрите в документации. .TP \-o[N] -Открыть N окон, разделённых по горизонтали. Если N не указано, то открывается -по одному окну на каждый файл. +Создать для N файлов отдельные окна, расположенные по горизонтали. +Если N не указано, то создаётся по одному окну на каждый файл. .TP \-O[N] -Открыть N окон, разделённых по вертикали. Если N не указано, то открывается -по одному окну на каждый файл. +Создать для N файлов отдельные окна, расположенные по вертикали. +Если N не указано, то создаётся по одному окну на каждый файл. +.TP +\-p[N] +Создать для N файлов отдельные вкладки. +Если N не указано, то создаётся по одной вкладке на каждый файл. .TP -\-R -Режим "только для чтения". Включается опция 'readonly'. -Файл в буфере доступен для редактирования, но его копию на диске нельзя -случайно перезаписать. Для сохранения файла необходимо добавить восклицательный -знак к соответствующей команде Ex (например, ":w!"). -Ключ "\-R" подразумевает также, что используется и ключ "\-n" (см. выше). -Опция 'readonly' может быть выключена по команде ":set noro". -См. ":help 'readonly'". +\-P {заголовок окна} +Открыть программу в многодокументном приложении. +Только для ГИП в MS Windows. Задаёт заголовок окна родительского приложения. +Если возможно, то программа Vim будет запущена внутри окна многодокументного +приложения. Многодокументное приложение должно иметь указанный {заголовок окна}. +Убедитесь, что этот {заголовок окна} уникален для приложения. Обращаем внимание, +что реализация данного функционала всё ещё не до конца отработана. Внедрение +программы возможно не во все приложения и не поддерживается меню окна. .TP \-r -Вывести список своп-файлов и информацию об их использовании для восстановления после сбоя. +Вывод перечня файлов подкачки и завершение работы. +Будут показаны доступные файлы подкачки и информация об их использовании +для восстановления в случае сбоя. .TP \-r {файл} -Режим восстановления. -Для восстановления после сбоя будет использован своп-файл. -Своп-файл имеет то же имя, что и текстовый файл, но с добавлением расширения ".swp". +Восстановление аварийно завершённого сеанса. +Для восстановления после сбоя в работе будет использован указанный файл подкачки. +Файл подкачки имеет то же наименование, что и редактируемый текстовый файл, +но с добавлением расширения ".swp". См. ":help recovery". .TP +\-R +Работа в варианте только для чтения. +Будет установлен параметр 'readonly'. +Файл в буфере доступен для редактирования, но его копию на диске нельзя +случайно перезаписать. Для сохранения файла необходимо добавить восклицательный +знак к соответствующей Ex-команде (например, ":w!"). +При задании аргумента "\-R" также подразумевается, что используется и аргумент +"\-n" (см. выше). +Параметр 'readonly' может быть сброшен по команде ":set noro". +См. ":help 'readonly'". +.TP \-s -Тихий режим. Только при запуске как "Ex" или если перед "\-s" указан ключ "\-e". -.TP -\-s {scriptin} -Считывается файл сценария {scriptin}. При этом, содержимое файла воспринимается -в виде команд, как если бы они были набраны на консоли. -То же самое достигается командой ":source! {scriptin}". -Если конец файла считывается до завершения работы редактора, то в дальнейшем -ввод осуществляется с клавиатуры. +Тихий режим. +Только при запуске в командной оболочке как программы "ex" или если перед +аргументом "\-s" указан аргумент "\-e". .TP -\-T {terminal} -Сообщает -.B Vim -тип используемого терминала. Необходимо только в тех ситуациях, когда -автоматическое определение терминала не работает. Имя терминала должно быть -известно -.B Vim -(встроено в него) или определено в файлах termcap или terminfo. +\-s {командный файл} +Считывание команд режима команд из {командного файла}. +Содержимое файла воспринимается в виде команд, как если бы они были набраны +непосредственно в редакторе. +То же самое достигается командой ":source! {командный файл}". +Если после исполнения всех команд из {командного файла} работа редактора +продолжается, то дальнейший ввод команд и текста ожидается с клавиатуры. +.TP +\-S {файл} +Исполнение указанного {файла}. +После загрузки в буфер первого файла, будет исполнен указанный командный {файл}. +Это аналогично команде в командной строке \-c "source {файл}". +Наименование {файла} не может начинаться с символа '\-'. +Если не указан {файл}, то будет исполнен файл "Session.vim" (это будет работать +только если аргумент \-S является последним в командной строке). .TP -\-u {vimrc} -Использовать команды из файла сценария {vimrc} для настройки. -Все остальные файлы настроек пропускаются. -Удобно для редактирования специальных типов файлов. -Чтобы избежать использования сценариев настроек вообще, можно использовать -имя "NONE". См. ":help initialization". +\-T {терминал} +Назначить указанный тип {терминала}. +Редактору +.B Vim +будет передан тип используемого терминала. +Необходимо только в тех ситуациях, когда автоматическое определение терминала +не работает. Наименование терминала должно быть известно редактору +.B Vim +(предопределено в редакторе) либо указано в базе termcap или terminfo. .TP -\-U {gvimrc} -Использовать команды из файла сценария {gvimrc} для настройки графического -интерфейса. -Все остальные файлы настроек для графического интерфейса пропускаются. -Чтобы избежать использования сценариев настроек графического интерфейса вообще, -можно использовать имя "NONE". См. ":help gui-init". +\-u {файл} +Использовать для начальной настройки указанный командный {файл}. +Все остальные файлы настроек игнорируются. +Удобно для редактирования специальных типов файлов. +Через этот аргумент можно также отключить обработку всех файлов начальной +настройки, используйте для этого слово "NONE" (прописными буквами). +См. ":help initialization". .TP -\-V -"Болтливый" режим. Выводить сообщения о том, какие файлы читаются, и о -чтении-записи файла viminfo. +\-U {файл} +Использовать для начальной настройки графического интерфейса указанный +командный {файл}. +Все остальные файлы настроек для графического интерфейса игнорируются. +Через этот аргумент можно также отключить обработку всех файлов настройки +графического интерфейса, используйте для этого слово "NONE" (прописными буквами). +См. ":help gui\-init". .TP \-v -Запустить +Запуск программы в режиме Vi. +Редактор .B Vim -в режиме Vi, как будто исполняемый файл имеет имя "vi". Имеет смысл только если -исполняемый файл имеет имя "ex". +будет работать в режиме редактора Vi, как будто исполняемый файл называется "vi". +Имеет смысл только если исполняемый файл называется "ex". +.TP +\-V[N] +Режим подробного вывода. +Будут выводиться сообщения о том, какие командные файлы исполняются, и какая +информация считывается и записывается в viminfo-файле. Необязательное число N +задаёт уровень детализации информации. По умолчанию это значение установлено +равным 10. .TP -\-w {scriptout} -Все символы, введённые с клавиатуры вплоть до момента завершения работы, -записываются в файл {scriptout}. -Удобно в том случае, когда вы хотите создать файл сценария для последующего -использования с "vim \-s" или ":source!". Если файл {scriptout} уже существует, -то новые символы будут добавляются в конец файла. +\-V[N]{файл} +Аналогично аргументу \-V, а также выполняется установка параметру 'verbosefile' +значение {файл}. Как результат, сообщения будут записываться в {файл}, а не +отображаться на экране. Наименование {файла} не может начинаться с какой-либо +цифры. +.TP +\-w{число} +Для параметра 'window' будет установлено значение, равное указанному {числу}. .TP -\-W {scriptout} -Как "\-w", но уже существующий файл будет перезаписан. +\-w {файл} +Добавление всех введённых команд в {файл}. +Все символы, введённые с клавиатуры вплоть до момента завершения работы +редактора, записываются в {файл}. +Удобно в том случае, когда вы хотите создать командный файл для последующего +его использования в командной строке "vim \-s" или в команде ":source!". +Если {файл} уже существует, то набранный текст будет добавляются в конец файла. +.TP +\-W {файл} +Запись всех введённых команд в {файл}. +Как аргумент "\-w", но существующий {файл} будет перезаписан. .TP \-x -Шифровать записываемые файлы. Будет выдано приглашение ввести пароль. +Редактирование шифрованных файлов. +Если редактор +.B Vim +был собран с поддержкой шифрования, то выполнять шифрование при записи файлов. +Будет выдано приглашение ввести пароль. .TP \-X -Не подключаться к X-серверу. Ускоряет загрузку на консоли, но делает невозможным -использование заголовка окна и буфера обмена. +Запуск программы без подключения к X-серверу. +Ускоряет загрузку в консоли, но делает невозможным использование заголовка окна +и буфера обмена. +.TP +\-y +Работа в упрощённом варианте. +Редактор +.B Vim +будет работать в упрощённом варианте, как будто исполняемый файл имеет название +"evim" или "eview". +Поведение редактора +.B Vim +будет походить на редакторы, созданные по безрежимному принципу работы. .TP \-Z -Ограниченный режим. Работает так же, как и программы, начинающиеся с "r". +Работа с ограничением функциональности. +Работает так же, как и запуск исполняемого файла, наименование которого +начинается с буквы "r". .TP \-\- -Конец ключей. Все остальные аргументы рассматриваются как имена файлов. -Может быть использовано для правки файлов, имена которых начинаются с дефиса. +Означает окончание ввода аргументов. +Все что указано после этого в командной строке, считается наименованиями файлов. +Может быть использовано для правки файлов, наименования которых начинаются с +дефиса. +.TP +\-\-clean +При работе редактора не использовать пользовательскую конфигурацию (файлы vimrc, +подключаемые модули и т. п.). Полезно для проверки, что проблема в работе +редактора не возникнет с предустановленными настройками программы Vim. +.TP +\-\-cmd {команда} +Как аргумент "\-c", но команда исполняется перед обработкой любого файла +настроек (vimrc). +Можно указывать до десяти таких команд, независимо от количества команд "\-c". +.TP +\-\-echo\-wid +Только для графического интерфейса GTK. Отобразить идентификатор окна +(Window ID) в поток стандартного вывода (stdout). +.TP +\-\-gui\-dialog\-file {файл} +При работе редактора в графическом интерфейсе пользователя, заголовок +и сообщение диалогового окна будут записаны в {файл} без отображения на экране. +Если указанный {файл} не существует, то он будет создан, а при его наличии +сообщения будут дописываться в этот {файл}. Данный аргумент полезен только для +тестирования работы редактора, чтобы избежать остановки программы, так как +отображаемое диалоговое окно может быть скрыто. Если не поддерживается +графический интерфейс пользователя, то этот аргумент игнорируется программой. .TP -\-\-help -Вывести краткую справку и завершить работу. То же, что и "\-h". +\-\-help, \-h, \-? +Будет показана краткая информация об аргументах и параметрах командной строки. +После этого редактор +.B Vim +завершит работу. +.TP +\-\-literal +Данный аргумент указывает, что требуется воспринимать наименования файлов +буквально, и не выполнять разбор подстановочных символов. +Этот аргумент командной строки неприменим в Unix-подобных системах, где разбор +подстановочных символов выполняется командной оболочкой. .TP -\-\-version -Вывести информацию о версии программы и завершить работу. +\-\-log {файл} +Будет выполнена запись протокола работы с этапа инициализации программы. +Если при сборке программы +.B Vim +были включены компоненты "eval" и "channel", будет выполняться протоколирование +работы с самой ранней стадии запуска программы, а журнал записываться в {файл}. +Это работает аналогично вызову функции +.I ch_logfile({filename}, 'ao') +.TP +\-\-nofork +Режим активного приложения. +Редактор +.B Vim +с графическим интерфейсом не будет наследоваться и отключаться +от командной оболочки, в которой выполнена команда его запуска. +.TP +\-\-noplugin +Будет выполнен запуск программы без загрузки внешних подключаемых модулей. +Это же подразумевается при указании аргумента \-u NONE. +.TP +\-\-not\-a\-term +Не сообщать об отсутствии терминала для ввода-вывода. +Через этот аргумент указывается, что операции ввода-вывода осуществляются не +на терминал. Это позволяет избежать предупреждающего сообщения и двухсекундной +задержки, которые могли бы возникнуть. .TP \-\-remote -Подключиться к серверу Vim и заставить его править файлы, указанные в -последующих аргументах. Если сервер не найден, выводится предупреждение, -а файлы правятся в местной копии Vim. +Будет выполнено подключение к Vim-серверу и передача для правки файлов, +указанных в последующих аргументах. Если сервер не найден, выводится +предупреждение, а правка файлов выполняется в текущей копии редактора Vim. .TP \-\-remote\-expr {выражение} -Подключиться к серверу Vim и вычислить на нём указанное {выражение}. +Будет выполнено подключение к Vim-серверу и передача указанного {выражение} для +вычисления. Результат вычисления будет выведен в поток стандартного вывода (stdout). .TP -\-\-remote\-send {ключи} -Подключиться к серверу Vim и передать ему указанные {ключи}. +\-\-remote\-send {код клавиши} +Будет выполнено подключение к Vim-серверу и передача указанных {кодов клавиш}. .TP \-\-remote\-silent Как "\-\-remote", но без вывода предупреждения, если сервер не найден. .TP \-\-remote\-wait -Как "\-\-remote", но Vim не будет завершать работу до тех пор, пока не будет -выполнена правка всех файлов. +Как "\-\-remote", но редактор Vim не будет завершать работу до тех пор, +пока не будет выполнена правка всех файлов. .TP \-\-remote\-wait\-silent Как "\-\-remote\-wait", но без вывода предупреждения, если сервер не найден. .TP \-\-serverlist -Вывести список всех доступных серверов Vim. +Будет выведен перечень всех доступных Vim-серверов. .TP -\-\-servername {имя} -Использовать указанное {имя} в качестве имени сервера. Если ключ -"\-\-remote" не указан, то {имя} присваивается данной копии Vim, -в противном случае указывает на имя сервера, к которому следует -подключиться. +\-\-servername {название} +Использовать указанное {название} в качестве наименования сервера. Если аргумент +"\-\-remote" не указан, то {название} присваивается данной копии редактора Vim, +в противном случае указывает на сервер, к которому следует подключиться. .TP \-\-socketid {id} -Только для графического интерфейса GTK: использовать механизм GtkPlug для -запуска gvim в отдельном окне. +Только для графического интерфейса GTK. Будет использован механизм GtkPlug для +запуска редактора gVim в отдельном окне. +.TP +\-\-startuptime {файл} +Будет выполнена запись хронометража запуска программы в {файл}. +.TP +\-\-ttyfail +Будт сразу же завершена работа, если ввод-вывод получен не с терминала (tty). +.TP +\-\-version +Будет выведена информация о версии программы и завершена работа. .TP -\-\-echo\-wid -Только для графического интерфейса GTK: вывести идентификатор окна (Window ID) -в поток стандартного вывода (stdout). -.SH ВСТРОЕННАЯ СПРАВКА -Для начала, наберите команду ":help". -Введите ":help тема", чтобы получить справку по конкретной теме. -Например, команда ":help ZZ" выведет информацию о команде "ZZ". -Используйте <Tab> и CTRL-D для автоматического дополнения -названий тем (":help cmdline-completion"). -Для быстрого перемещения по справочнику используются метки (что-то +\-\-windowid {ИД} +Только для графического интерфейса в MS Windows. Редактор gVim будет +использовать окно с указанным {ИД} в качестве родительского, чтобы попытаться +выполнить запуск внутри этого окна. +.SH ВСТРОЕННАЯ ДОКУМЕНТАЦИЯ +Для начала работы с документацией, наберите в редакторе +.B Vim +команду ":help". +Введите ":help тема", чтобы получить справку по интересующей теме. +Например, по команде ":help ZZ" будет выведена информация о команде "ZZ". +Используйте клавиши <TAB> и CTRL+D для подстановки нужного названия темы +(см. ":help cmdline\-completion"). +Для быстрого перемещения по документации используются индексы (что-то вроде гипертекстовых ссылок, см. ":help"). Таким образом можно -просматривать все файлы справки, например ":help syntax.txt". +переходить от одного файла документации к другому, например, ":help syntax.txt". .SH ФАЙЛЫ .TP 15 -/usr/local/lib/vim/doc/*.txt -Файлы справочника +/usr/local/share/vim/vim??/doc/*.txt +Файлы документации редактора .B Vim. -См. ":help doc-file-list" для получения полного списка. -.TP -/usr/local/lib/vim/doc/tags -Файл меток, используемый для поиска информации в файлах справки. +См. ":help doc\-file\-list" для получения полного перечня файлов. +.br +Здесь и далее +.I "vim??" +означает сокращённую запись номера версии, например, vim91 для версии редактора +.B Vim 9.1 .TP -/usr/local/lib/vim/syntax/syntax.vim -Системные настройки синтаксиса. +/usr/local/share/vim/vim??/doc/tags +Файл индексов, используемый для поиска информации в файлах документации. +.TP +/usr/local/share/vim/vim??/syntax/syntax.vim +Общесистемные настройки распознавания и подсветки синтаксиса. .TP -/usr/local/lib/vim/syntax/*.vim -Файлы синтаксиса для разных языков. +/usr/local/share/vim/vim??/syntax/*.vim +Файлы распознавания и подсветки синтаксиса для различных языков программирования. .TP -/usr/local/lib/vim/vimrc -Системные настройки +/usr/local/share/vim/vimrc +Общесистемный файл начальной настройки для консольного редактора .B Vim. .TP -/usr/local/lib/vim/gvimrc -Системный настройки графического интерфейса. +~/.vimrc, ~/.vim/vimrc, $XDG_CONFIG_HOME/vim/vimrc +Пользовательские файлы начальной настройки для консольного редактора +.B Vim +(будет использован первый найденный файл из указанных). +.TP +/usr/local/share/vim/gvimrc +Общесистемный файл начальной настройки для редактора с графическим интерфейсом +.B gVim. .TP -/usr/local/lib/vim/optwin.vim -Сценарий, используемый при выполнении команды ":options". -Хороший способ просматривать и изменять настройки. +~/.gvimrc, ~/.vim/gvimrc, $XDG_CONFIG_HOME/vim/gvimrc +Пользовательские файлы начальной настройки для редактора с графическим +интерфейсом +.B gVim +(будет использован первый найденный файл из указанных). .TP -/usr/local/lib/vim/menu.vim -Системные настройки меню для gvim. +/usr/local/share/vim/vim??/optwin.vim +Командный файл, используемый при выполнении команды ":options". +По этой команде предоставляется удобный способ просмотра и изменения настроек. .TP -/usr/local/lib/vim/bugreport.vim -Сценарий для создания отчёта об обнаруженных глюках. См. ":help bugs". +/usr/local/share/vim/vim??/menu.vim +Системные настройки меню для графического интерфейса редактора +.B gVim. .TP -/usr/local/lib/vim/filetype.vim -Сценарий для определения типа файла по имени. См. ":help 'filetype'". +/usr/local/share/vim/vim??/bugreport.vim +Командный файл для создания отчёта об обнаруженных ошибках. См. ":help bugs". .TP -/usr/local/lib/vim/scripts.vim -Сценарий для определения типа файла по содержимому. См. ":help 'filetype'". +/usr/local/share/vim/vim??/filetype.vim +Командный файл для распознавания типов файлов по наименованию. +См. ":help 'filetype'". .TP -/usr/local/lib/vim/print/*.ps -Файлы для печати PostScript. +/usr/local/share/vim/vim??/scripts.vim +Командный файл для распознавания типов файлов по содержимому. +См. ":help 'filetype'". +.TP +/usr/local/share/vim/vim??/print/*.ps +Файлы, используемые для печати через интерфейс PostScript. .PP -Более свежая информация -- на сайте VIM: +Всю последнюю информацию о редакторе можно получить на веб-странице VIM: .br <URL:http://www.vim.org/> -.SH СМОТРИ ТАКЖЕ +.SH СМОТРИТЕ ТАКЖЕ vimtutor(1) .SH АВТОРЫ -Большая часть +Большая часть редактора .B Vim -создана Брамом Мооленааром (Bram Moolenaar), которому помогает огромное -количество людей. См. ":help credits" в +была создана Брамом Моленаром (Bram Moolenaar), которому помогало огромное +количество людей. См. ":help credits" в редакторе .B Vim. .br +Редактор .B Vim базируется на коде редактора Stevie, написанного Тимом Томпсоном (Tim Thompson), Тони Эндрюсом (Tony Andrews) и Г. Р. (Фредом) Уолтером (G.R. (Fred) Walter). -Однако, в настоящее время в Vim почти не осталось ничего от исторического кода -его предшественника. +Однако, в настоящее время в программе Vim почти ничего не осталось +от исторического кода его предшественника. .br -Русская локализация +Русская локализация редактора .B Vim выполняется в рамках проекта "РуВим", -см. <URL:http://sourceforge.net/projects/ruvim/>. -.SH ГЛЮКИ +см. <URL:https://github.com/restorerz/ruvim/>. +.SH ОШИБКИ Скорее всего есть. -См. ":help todo" -- список известных проблем. +См. ":help todo" \[em] перечень известных ошибок в работе. .PP -Заметим, что многие вещи, которые считаются глюками, на самом деле -являются результатом слишком полного воспроизведения поведения Vi. +Заметим, что многие вещи, которые считаются ошибками, на самом деле +являются результатом слишком полного воспроизведения поведения редактора Vi. Если вы думаете, что что-то является ошибкой только потому, что "Vi делает это по-другому", внимательно прочитайте файл vi_diff.txt -(или наберите ":help vi_diff.txt" в Vim) и используйте опции 'compatible' -и 'cpoptions'. +(или наберите ":help vi_diff.txt" в редакторе Vim) и посмотрите параметры + 'compatible' и 'cpoptions'.
--- a/runtime/doc/vimdiff-ru.1 +++ b/runtime/doc/vimdiff-ru.1 @@ -1,50 +1,51 @@ -.TH VIMDIFF 1 "2001 March 30" -.SH -vimdiff \- Vim - . -.SH +.TH VIMDIFF 1 "13 2021" +.SH + vimdiff \[em] Vim + . +.SH .br .B vimdiff -[] 1 2 [3] +[] file1 file2 [file3 [file4 [file5 [file6 [file7 [file8]]]]]] .PP .B gvimdiff .SH - + .B vimdiff - + .B Vim - ( ) . . - . - ӣ - . + , . + . + ӣ + . .PP - Vim . vim(1). + Vim . vim(1). .PP - + .B gvimdiff - , . + , +. .PP - 'diff', - . + 'diff', + . .br - - 'wrap' 'scrollbind'. + + 'wrap' 'scrollbind'. .br - 'foldmethod' "diff", - , . - 'foldcolumn' 2, -, . -.SH - , - "\-O". , - , "\-o". + 'foldmethod' "diff", + , . + 'foldcolumn' 2, +, ף . +.SH + , , + "\-O". , , + "\-o". .PP - vim(1). -.SH + vim(1). +.SH vim(1) .SH - + .B Vim - (Bram Moolenaar), - . . ":help credits" + (Bram Moolenaar), + . . ":help credits" .B Vim.
--- a/runtime/doc/vimdiff-ru.UTF-8.1 +++ b/runtime/doc/vimdiff-ru.UTF-8.1 @@ -1,50 +1,51 @@ -.TH VIMDIFF 1 "2001 March 30" -.SH ИМЯ -vimdiff \- позволяет редактировать две или три версии файла с помощью Vim -с отображением различий. -.SH КОМАНДНАЯ СТРОКА +.TH VIMDIFF 1 "13 июня 2021" +.SH НАЗНАЧЕНИЕ +Программа vimdiff \[em] запускает редактор Vim для сравнения и правки от двух до +восьми версий текстового файла. +.SH КАТКИЙ ОБЗОР .br .B vimdiff -[ключи] файл1 файл2 [файл3] +[аргументы] file1 file2 [file3 [file4 [file5 [file6 [file7 [file8]]]]]] .PP .B gvimdiff .SH ОПИСАНИЕ -Команда +По команде .B vimdiff -загружает в +выполняется загрузка в редактор .B Vim -два (или три) файла. Каждый файл открывается в собственном окне. -Различия между файлами отображаются с помощью подсветки синтаксиса. -Эта команда позволяет наглядно отображать внесённые изменения и переносить -различающиеся фрагменты из одной версии файла в другую. +от двух до восьми файлов, и для каждого файла создаётся отдельное окно. +Различия между файлами выделяются с помощью подсветки. +Этот способ очень удобен для наглядного отображения внесённых изменений +и переноса различающихся фрагментов текста из одной версии файла в другую. .PP -Подробнее о Vim см. на странице справочника vim(1). +Подробнее о редакторе Vim см. в справочнике vim(1). .PP -При запуске с помощью команды +При запуске редактора с помощью команды .B gvimdiff -редактор запускается в режиме графического интерфейса, если это возможно. +будте выполнено переключение на графический интерфес пользователя, если это +возможно. .PP -В каждом окне включается опция 'diff', что позволяет использовать подсветку -синтаксиса для отображения различий между файлами. +Для каждого созданного окна будет установлен параметр 'diff', что позволяет +использовать подсветку для отображения различий между файлами. .br -Для улучшения работы с файлами в режиме отображения отличий также включаются -опции 'wrap' и 'scrollbind'. +Для улучшения работы с файлами в режиме сравнения различий также будут +установлены параметры 'wrap' и 'scrollbind'. .br -Значение опции 'foldmethod' устанавливается равным "diff", что позволяет -прятать в складку области текста, которые не отличаются в различных версиях файла. -Значение опции 'foldcolumn' устанавливается равным 2, чтобы было проще -находить, открывать и закрывать такие складки. -.SH КЛЮЧИ ЗАПУСКА -Для выравнивания строк между окнами используется вертикальное разделение окон, -как если бы использовался ключ "\-O". Для того, чтобы использовать разделение -окон по горизонтали, следует указать в командной строке ключ "\-o". +Для параметра 'foldmethod' устанавливается значение "diff", что позволяет +сворачивать области текста, которые идентичны в различных версиях файла. +Значение параметра 'foldcolumn' устанавливается равным 2, чтобы было проще +находить, открывать и закрывать такие области свёрнутого текста. +.SH АРГУМЕНТЫ КОМАНДНОЙ СТРОКИ +При сопоставлении файлов, используется вертикальное расположение окон, как если +бы был указан аргумент "\-O". Для того, чтобы окна располагались по горизонтали, +следует указать в командной строке аргумент "\-o". .PP -Остальные ключи командной строки рассматриваются на странице справочника vim(1). -.SH СМОТРИ ТАКЖЕ +Остальные аргументы командной строки описаны в справочнике vim(1). +.SH СМОТРИТЕ ТАКЖЕ vim(1) .SH АВТОРЫ -Большая часть +Большая часть редактора .B Vim -создана Брамом Мооленааром (Bram Moolenaar), которому помогает огромное -количество людей. См. ":help credits" в +была создана Брамом Моленаром (Bram Moolenaar), которому помогало огромное +количество людей. См. ":help credits" в редакторе .B Vim.
--- a/runtime/doc/vimtutor-ru.1 +++ b/runtime/doc/vimtutor-ru.1 @@ -1,51 +1,63 @@ -.TH VIMTUTOR 1 "2001 April 2" -.SH -vimtutor \- Vim -.SH +.TH VIMTUTOR 1 "12 2024" +.SH + vimtutor \[em] Vim. +.SH .br -.B vimtutor [] +.B vimtutor [\-g] [] .SH - + .B vimtutor - + .B Vim. - , - . + , . + , Σ + . .PP - + , .B vimtutor - , + , +.B Vim. +.PP + \-g + , , , . + , .B Vim. .PP - [] , - "ru" "it". - [] , - . , - . + [] , , +"ru" "it". + [] , , + . +, , , . .PP - + , .B Vim - Vi. + Vi. .SH + +.I "vim??" + ݣ , , vim91 +.B Vim 9.1 .TP 15 -/usr/local/lib/vim/tutor/tutor[.] - -.B vimtutor. +/usr/local/share/vim/vim??/tutor/tutor[.] + +.B Vimtutor. .TP 15 -/usr/local/lib/vim/tutor/tutor.vim - Vim, - -.B vimtutor. +/usr/local/share/vim/vim??/tutor/tutor.vim + +.B 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. + 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). + (Bram Moolenaar). . -.SH +.SH vim(1)
--- a/runtime/doc/vimtutor-ru.UTF-8.1 +++ b/runtime/doc/vimtutor-ru.UTF-8.1 @@ -1,51 +1,63 @@ -.TH VIMTUTOR 1 "2001 April 2" -.SH ИМЯ -vimtutor \- учебник по Vim -.SH КОМАНДНАЯ СТРОКА +.TH VIMTUTOR 1 "12 августа 2024" +.SH НАЗНАЧЕНИЕ +Программа vimtutor \[em] выполняет запуск учебника по редактору Vim. +.SH КРАТКИЙ ОБЗОР .br -.B vimtutor [язык] +.B vimtutor [\-g] [язык] .SH ОПИСАНИЕ -Команда +По команде .B vimtutor -запускает учебник по +выполняется запуск редактора .B Vim. -При этом сначала происходит создание копии файла учебника, -чтобы его можно было редактировать без опасения потерять исходный файл. +с загруженным файлом, содержащем текст учебника. Но перед этим происходит +создание копии файла учебника, чтобы в нём можно было выполнять практические +задания без опасения испортить исходный файл. .PP -Программа +Практический курс, который будет открыт по команде .B vimtutor -полезна для новичков, желающих научиться самым основным командам +полезен для новичков, желающих научиться самым основным командам редактора +.B Vim. +.PP +Через необязательный аргумент командной строки \-g даётся указание на запуск +учебника в графическом интерфейсе редактора, если это, конечно, возможно. +При не возможности выполнить это, будет запущен консольный вариант редактора .B Vim. .PP -Необязательный параметр [язык] представляет собой двухсимвольный код языка, -например "ru" или "it". -Если параметр [язык] не указан, то используется язык активной в настоящий -момент локали. Если учебник на этом языке не существует, то по умолчанию -используется учебник на английском языке. +Необязательный аргумент [язык] задаётся как двухсимвольный код языка, например, +"ru" или "it". +Если аргумент [язык] не указан, то используется язык, заданный в действующих +в настоящий момент региональных настройках. Если учебника на этом языке не +существует, то, по умолчанию, используется учебник на английском языке. .PP -При работе с учебником +При работе с учебником, редактор .B Vim -всегда запускается в режиме совместимости с Vi. +всегда запускается в режиме совместимости с редактором Vi. .SH ФАЙЛЫ +Здесь и далее +.I "vim??" +означает сокращённую запись номера версии, например, vim91 для версии редактора +.B Vim 9.1 .TP 15 -/usr/local/lib/vim/tutor/tutor[.язык] -Текст учебника -.B vimtutor. +/usr/local/share/vim/vim??/tutor/tutor[.язык] +Файлы с текстом учебника +.B Vimtutor. .TP 15 -/usr/local/lib/vim/tutor/tutor.vim -Сценарий Vim, который используется для создания рабочей -копии текста учебника -.B vimtutor. +/usr/local/share/vim/vim??/tutor/tutor.vim +Командный файл редактора +.B 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. +был впервые написан для 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). +Брамом Моленаром (Bram Moolenaar). Имена переводчиков учебника упоминаются в соответствующих файлах. -.SH СМОТРИ ТАКЖЕ +.SH СМОТРИТЕ ТАКЖЕ vim(1)
--- a/runtime/doc/xxd-ru.1 +++ b/runtime/doc/xxd-ru.1 @@ -1,57 +1,60 @@ -.TH XXD 1 "August 1996" " man xxd" +.TH XXD 1 "May 2024" " 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 +.SH + .I xxd -\- - . -.SH +\[em] , + +.SH .B xxd \-h[elp] .br .B xxd -[] [_ [_]] +[] [_ [_]] .br .B xxd -\-r[evert] [] [_ [_]] +\-r[evert] [] [_ [_]] .SH + .I xxd - , - , . - - . - + , + , . + + . + .BR uuencode(1) -.BR uudecode(1), - ASCII-, - , , , -xxd , - . -.SH +.BR uudecode(1) +, +ASCII, , , , + xxd , + . +.SH .I _ - , . + , . , .I _ -.RB \` \- ', - . +.RB ' \- ', + . , .I _ ( -.RB \` \- ' -), . +.RB ' \- ' +), . .PP - , "" , - , . - -. , - . - , + , "" , + , , , + - . + +. , + . + , .BR \-c8 , .BR "\-c 8" , .B \-c 010 @@ -61,118 +64,179 @@ xxd , .PP .TP .IR \-a " | " \-autoskip - : - '*'. - . + , . ., + , '*'. + . .TP .IR \-b " | " \-bits - ( ). - - "1" "0". - , - ( ascii ebcdic). \-p, \-i - . + ( ), . + , +, "1" "0". + ţ , + ASCII ( EBCDIC). +\-p, \-i . .TP .IR "\-c " | " \-cols " .RI < >, . 16 -(\-i: 12, \-ps: 30, \-b: 6). - : 256. +( \-i 12, \-ps \[em] 30, \-b \[em] 6). + \[em] 256. + \-ps. \-ps, + 0, . +.TP +.IR \-C " | " \-capitalize + + , + \-i. +.TP +.I \-d + , . .TP .IR \-E " | " \-EBCDIC - ASCII EBCDIC. - . , - \-r, \-p \-i. + ASCII, + EBCDIC. + . , + \-r, \-p \-i. +.TP +.IR \-e + + . + . + + +.RI "" \-g . + + + ASCII ( EBCDIC). + +\-r, \-p, \-i . .TP .IR "\-g " | " \-groupsize " - -.RI < > -( ), . + +.RI < > +( ), + . .I \-g 0 - . + . -.RI < "> " 2 - \fI1\fP . - postscript include. +.RI < ">, " 2 + , \fI4\fP + \fI1\fP . + PostScript include. .TP .IR \-h " | " \-help - . + +. . .TP .IR \-i " | " \-include - C. - , - , xxd -. + . + , + , xxd + . .TP .IR "\-l " | " \-len " - +, .RI < > - . + , . +.TP +.I "\-n " | " \-name " + \-i. + , \fI\fP + \fI\fP_len. +.TP +.I \-o + +.RI < > + . .TP .IR \-p " | " \-ps " | " \-postscript " | " \-plain - , - "" "postscript". + , + "" "PostScript". .TP .IR \-r " | " \-revert - : - ( ). - , xxd - . + , . . + ( + ). + , xxd + . .I \-r \-p "" - - . - . + - . + . + +.I \-r \-b + . +.TP +.IR \-R " " + + . + . + +.I \fI\fP + +.BR never " (), " always " (), " auto " (, ). + +.BR $NO_COLOR +, . .TP .I \-seek - + .I \-r -: +, .RI < > , . .TP -.I \-s [\+][\-]seek - ( ) +.I \-s [+][\-]seek + ( ) .RI < > _. -\fI\+ \fR, - (, - ). \fI\- \fR, - (, \fI \+ \fR: - ). - \-s , xxd . + \fI+ \fR, + (, + ). \fI\- \fR, + (, + \fI+\fR, + ). + \-s , xxd + . .TP .I \-u - . - . +, . + . .TP .IR \-v " | " \-version - . -.SH + . +.SH .PP + .I xxd \-r - . + , + . , - , - . xxd -lseek(2) . -, , -. + , + . +xxd lseek(2) . + , , + . .PP + .I xxd \-r - . . + , . + . .PP - -, + , +, .I xxd \-r - - (. \-c). , , - ascii ( ebcdic), . +, +(. \-c), . + , , ӣ +ASCII ( EBCDIC), . -postscript xxd \-r \-p . - , . +PostScript xxd \-r \-p . + , +. .PP .PP @@ -186,125 +250,139 @@ postscript xxd \-r \-p . .I xxd \-s \+seek .I xxd \-s seek, - , "" , lseek(2). - `+' , - , - , xxd . + , "" , + lseek(2). + '+' , + , + , xxd + . ( ݣ !) ... .PP - ; , 'cat' - : -.PP -\fI% sh \-c 'cat > plain_copy; xxd \-s 0 > hex_copy' < file + , 'cat' + : .PP - 0x480 -(= 1024+128). - `+' " ", `128' - , dd: +\fI% sh \-c "cat > plain_copy; xxd \-s 0 > hex_copy" < file\fR +.PP + 0x480 (=1024+128). + '+' " ", '128' + , dd: .PP -\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet' < file +\fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +128 \> hex_snippet" < file\fR .PP - 0x100 -(= 1024-768): + 0x100 (=1024\[mi]768): .PP -\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +-768 > hex_snippet' < file +\fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +\-768 \> hex_snippet" < file\fR .PP - , , , - `+' . -xxd strace(1) truss(1) , + , , +, '+' . + xxd strace(1) truss(1) +, \-s. .SH .PP .br - ӣ, ң (0x30 ) -.B file + ӣ, ң (0x30 ) +.BR : -.PP -\fI% xxd \-s 0x30 file +.br +\fI% xxd \-s 0x30 file\fR .PP .br - (0x30 ) -.B file + (0x30 ) +.BR : -.PP -\fI% xxd \-s \-0x30 file +.br +\fI% xxd \-s \-0x30 file\fR .PP .br - 120 - 20 : -.PP + 120 + 20 +.br +( xxd.1 , + ): +.br \fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR .br -2e544820585844203120224d616e75616c207061 +2e544820585844203120224d6179203230323422 .br -676520666f7220787864220a2e5c220a2e5c2220 +20224d616e75616c207061676520666f72207878 .br -32317374204d617920313939360a2e5c22204d61 +64220a2e5c220a2e5c222032317374204d617920 .br -6e207061676520617574686f723a0a2e5c222020 +313939360a2e5c22204d616e2070616765206175 +.br +74686f723a0a2e5c2220202020546f6e79204e75 .br -2020546f6e79204e7567656e74203c746f6e7940 +67656e74203c746f6e79407363746e7567656e2e .br -7363746e7567656e2e7070702e67752e6564752e + .br -.PP + 120 12 .br - 120 12 : -.PP +( xxd.1 , + ): +.br \fI% xxd \-l 120 \-c 12 xxd.1\fR .br -0000000: 2e54 4820 5858 4420 3120 224d .TH XXD 1 "M +00000000: 2e54 4820 5858 4420 3120 224d .TH XXD 1 "M .br -000000c: 616e 7561 6c20 7061 6765 2066 anual page f +0000000c: 6179 2032 3032 3422 2022 4d61 ay 2024" "Ma .br -0000018: 6f72 2078 7864 220a 2e5c 220a or xxd"..\\". +00000018: 6e75 616c 2070 6167 6520 666f nual page fo .br -0000024: 2e5c 2220 3231 7374 204d 6179 .\\" 21st May +00000024: 7220 7878 6422 0a2e 5c22 0a2e r xxd"..\\".. .br -0000030: 2031 3939 360a 2e5c 2220 4d61 1996..\\" Ma +00000030: 5c22 2032 3173 7420 4d61 7920 \\" 21st May .br -000003c: 6e20 7061 6765 2061 7574 686f n page autho +0000003c: 3139 3936 0a2e 5c22 204d 616e 1996..\\" Man .br -0000048: 723a 0a2e 5c22 2020 2020 546f r:..\\" To +00000048: 2070 6167 6520 6175 7468 6f72 page author .br -0000054: 6e79 204e 7567 656e 7420 3c74 ny Nugent <t +00000054: 3a0a 2e5c 2220 2020 2054 6f6e :..\\" Ton .br -0000060: 6f6e 7940 7363 746e 7567 656e ony@sctnugen +00000060: 7920 4e75 6765 6e74 203c 746f y Nugent <to .br -000006c: 2e70 7070 2e67 752e 6564 752e .ppp.gu.edu. +0000006c: 6e79 4073 6374 6e75 6765 6e2e ny@sctnugen. .PP .br - xxd.1: + +.B xxd.1 +.br +( xxd.1 , + , , UTF-8 \[em] \flxxd \-s 0x50 \-l 13 \-c 13 xxd.1\fR): .PP -\fI% xxd \-s 0x28 \-l 12 \-c 12 xxd.1\fR +\fI% xxd \-s 0x33 \-l 13 \-c 13 xxd.1\fR .br -0000028: 3231 7374 204d 6179 2031 3939 21st May 199 +00000033: 3231 7374 204d 6179 2031 3939 36 21st May 1996 .PP .br .B _ .B _ - 100 0x00 : -.PP + 100 0x00 : +.br \fI% xxd _ | xxd \-r \-s 100 \> _\fR .br + +.br + +.B xxd.1 +.br +( xxd.1 , + ): +.PP +\fI% echo "0000034: 3574 68" | xxd \-r \- xxd.1\fR +.br +\fI% xxd \-s 0x33 \-l 13 \-c 13 xxd.1\fR +.br +00000033: 3235 7468 204d 6179 2031 3939 36 25th May 1996 .PP .br - xxd.1: + 65537- , 0x00, + , 'A' (0x41): .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 +\fI% echo "010000: 41" | xxd \-r > file\fR .PP .br @@ -312,97 +390,97 @@ 0x00, , 'A' .PP \fI% xxd \-a \-c 12 file\fR .br -0000000: 0000 0000 0000 0000 0000 0000 ............ +00000000: 0000 0000 0000 0000 0000 0000 ............ .br * .br -000fffc: 0000 0000 40 ....A +0000fffc: 0000 0000 41 ....A .PP 1- , 'A'. - '\-r \-s' , ; + '\-r \-s' , , , : .PP -\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> file\fR +\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 > file\fR .PP -xxd , -.B vim(1), - - `a' `z': -.PP + xxd , +.B vim(1) +, + 'a' 'z': +.br \fI:'a,'z!xxd\fR .PP - xxd , -.B vim(1), - - `a' `z': -.PP + xxd , +.B vim(1) +, + 'a' 'z': +.br \fI:'a,'z!xxd \-r\fR .PP - xxd , -.B vim(1), - + xxd , +.B vim(1) +, . -.PP +.br \fI!!xxd \-r\fR .PP : -.PP +.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 +\fI% echo \-n foo \> /dev/term/b\fR .PP -.SH - xxd : +.SH + , xxd : .TP 0 . .TP \-1 ( -.I xxd \-r \-i +.I \%xxd \-r \-i ). .TP 1 - . + . .TP 2 - . + . .TP 3 - . + . .TP 4,5 . -.SH +.SH uuencode(1), uudecode(1), patch(1) .br .SH ţ . - ţ . , -, . + ţ . , , + . .br .SH - xxd 1.7. + xxd 1.7 2024-05. .SH .br -(c) 1990-1997 (Juergen Weigert) +(c) (Juergen Weigert), 1990-1997 .br -<jnweiger@informatik.uni-erlangen.de> +<jnweiger@informatik.uni\-erlangen.de> .LP . .br - - , - . + - , +. .br - , ޣ. + , ޣ. .PP - (Tony Nugent) + (Tony Nugent) .br <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> .br - (Bram Moolenaar). - (Juergen Weigert). + (Bram Moolenaar). + (Juergen Weigert). .PP
--- a/runtime/doc/xxd-ru.UTF-8.1 +++ b/runtime/doc/xxd-ru.UTF-8.1 @@ -1,57 +1,60 @@ -.TH XXD 1 "August 1996" "Страница man для xxd" +.TH XXD 1 "May 2024" "Справочник по программе 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 ИМЯ +.SH НАЗНАЧЕНИЕ +Программа .I xxd -\- создаёт представление файла в виде шестнадцатеричных кодов или выполняет -обратное преобразование. -.SH КОМАНДНАЯ СТРОКА +\[em] выполняет преобразование данных или в шестнадцатеричный вид, или выполняет +обратное преобразование из шестнадцатеричного кода в исходный формат +.SH КРАТКИЙ ОБЗОР .B xxd \-h[elp] .br .B xxd -[ключи] [входной_файл [выходной_файл]] +[аргументы] [входной_файл [выходной_файл]] .br .B xxd -\-r[evert] [ключи] [входной_файл [выходной_файл]] +\-r[evert] [аргументы] [входной_файл [выходной_файл]] .SH ОПИСАНИЕ +Программа .I xxd -создаёт представление указанного файла или данных, прочитанных из потока -стандартного ввода, в виде шестнадцатеричных кодов. Эта команда также может -выполнить обратное преобразование заданных шестнадцатеричными кодами данных -в исходный бинарный формат. -Подобно командам +создаёт представление указанного файла или данных, прочитанных из стандартного +потока ввода, в виде шестнадцатеричных кодов. Эта программа также может +выполнять обратное преобразование заданных шестнадцатеричными кодами данных +в исходный двоичных формат. +Подобно программам .BR uuencode(1) и -.BR uudecode(1), -она позволяет выполнять преобразование бинарных данных в ASCII-код, -который можно передавать по электронной почте, однако, помимо этого, программа -xxd позволяет выполнять декодирование в поток стандартного вывода, -а также может применяться для создания заплаток для бинарных файлов. -.SH КЛЮЧИ ЗАПУСКА +.BR uudecode(1) +, она позволяет выполнять преобразование двоичных данных в символы кодировки +ASCII, которые можно передавать по электронной почте, однако, помимо этого, +программа xxd позволяет выполнять декодирование в поток стандартного вывода, +а также может применяться для создания исправлений для двоичных файлов. +.SH АРГУМЕНТЫ КОМАНДНОЙ СТРОКИ Если .I входной_файл -не задан, то соответствующие данные читаются из потока стандартного ввода. +не задан, то требуемые данные считываются из стандартного потока ввода. В случае, если в качестве .I входного_файла используется символ -.RB \` \- ', -источником данных также выступает поток стандартного ввода. +.RB ' \- ', +источником данных также выступает стандартный поток ввода. В том случае, если не указан .I выходной_файл (или вместо него используется символ -.RB \` \- ' -), результат преобразования направляется в поток стандартного вывода. +.RB ' \- ' +), результат преобразования направляется в стандартный поток вывода. .PP -Обратите внимание, что используется "ленивый" алгоритм разбора ключей, который не -проверяет более одной буквы ключа, если в этом ключе не используется параметр. -Пробелы между единственным символом ключа и соответствующим параметром не являются -обязательными. Параметры ключей могут быть заданы с использованием десятичного, -шестнадцатеричного или восьмеричного формата. -Таким образом, ключи +Обратите внимание, что применяется "ленивый" алгоритм разбора аргументов, +который проверяет только первую букву аргумента, если, конечно, для этого +аргумента не указано какое-то значение. +Пробелы между односимвольным аргументом и его значением не являются +обязательными. Значения аргументов могут быть заданы в десятичном, +шестнадцатеричном или восьмеричном формате. +Таким образом, аргументы .BR \-c8 , .BR "\-c 8" , .B \-c 010 @@ -61,118 +64,179 @@ xxd позволяет выполнять декодирование в поток стандартного вывода, .PP .TP .IR \-a " | " \-autoskip -Включает автоматический пропуск: вместо последовательности -нулевых строк используется одиночный символ '*'. По умолчанию -не применяется. +Включить автоматический пропуск, т. е., вместо нескольких идущих подряд строк +с нулевым значением, используется одиночный символ '*'. +По умолчанию не применяется. .TP .IR \-b " | " \-bits -Вместо шестнадцатеричного кода используются биты (двоичные цифры). -При использовании этого ключа вместо обычного шестнадцатеричного представления -октетов используются наборы из восьми символов "1" и "0". Каждая строка -предваряется номером строки в шестнадцатеричном виде, а завершается символьным -представлением (в виде ascii или ebcdic). Ключи \-p, \-i в этом режиме -не работают. +Использовать биты (двоичный код), а не шестнадцатеричные цифры. +При указании этого аргумента, вместо обычного шестнадцатеричного представления +октетов, будет отображается набор из восьми цифр "1" и "0". Каждая строка +предваряется её номером в шестнадцатеричном виде, а завершается в виде символов +в кодировке ASCII (или в кодировке EBCDIC). Аргументы командной строки +\-p, \-i в этом режиме не применяются. .TP .IR "\-c кол " | " \-cols кол" Задаёт количество октетов .RI < кол >, которое выводится на каждой строке. По умолчанию используется значение 16 -(\-i: 12, \-ps: 30, \-b: 6). -Максимально допустимое значение: 256. +(для аргумента \-i используется 12, для \-ps \[em] 30, для \-b \[em] 6). +Максимально допустимое значение \[em] 256. +Максимальное значение не применяется с аргументом \-ps. Если с аргументом \-ps, +указано значение 0, то будет выведена просто одна длинная строка. +.TP +.IR \-C " | " \-capitalize +Преобразовать наименования переменных в верхний регистр при использовании стиля +отображения в виде подключаемых файлов языка Си, +который включается через аргумент командной строки \-i. +.TP +.I \-d +Отображать смещение не в шестнадцатеричном, а в десятичном формате. .TP .IR \-E " | " \-EBCDIC -Изменяет способ кодирования символов в правой колонке с ASCII на EBCDIC. Этот ключ -не изменяет шестнадцатеричное представление. Данный ключ не имеет смысла, -если используются ключи \-r, \-p или \-i. +Отображать символы в крайне правой колонке не в кодировке ASCII, +а в кодировке EBCDIC. Этот аргумент не влияет на шестнадцатеричное +представление данных. Данный аргумент не имеет смысла, если используются +аргументы командной строки \-r, \-p или \-i. +.TP +.IR \-e +Использовать обратный порядок байт при отображение шестнадцатеричного +представления данных. +Группа байт будет показана как двоичное слово от младших разрядов к старшим. +Используемое по умолчанию группирование по четыре байта может быть изменено +через аргумент командной строки +.RI "" \-g . +Действие этого аргумента распространяется только на шестнадцатеричное +представление данных и не оказывает влияние на символьное представление +в кодировке ASCII (или EBCDIC). +Аргументы командной строки +\-r, \-p, \-i не применяются в этом режиме. .TP .IR "\-g байт " | " \-groupsize байт" -Позволяет выполнять группировку указанного количества -.RI < байтов > -(две шестнадцатеричные цифры или восемь битов), отделяя группы друг от друга пробелами. +Выполнить группирование указанного количества +.RI < байт > +(две шестнадцатеричные цифры или восемь двоичных цифр), отделяя группы +друг от друга пробелами. Значение .I \-g 0 -применяется для отказа от использования группировки. +применяется для отказа от использования группирования. По умолчанию используется значение -.RI < байт "> равное " 2 -в обычном режиме и \fI1\fP в битовом режиме. Группировка не применяется -в режимах postscript и include. +.RI < байт ">, равное " 2 +при отображении в прямом порядке байт, \fI4\fP при отображении в обратном +порядке байт и \fI1\fP в двоичном режиме. Группировка не применяется +в режиме PostScript или include. .TP .IR \-h " | " \-help -Выводит справку по доступным ключам командной строки и завершает работу программы. +Показать краткую информацию об аргументах командной строки и завершить работу +программы. Создание шестнадцатеричного представления не выполняется. .TP .IR \-i " | " \-include -Позволяет создавать вывод в стиле подключаемых заголовочных файлов языка C. -Вывод содержит полноценное определение статического массива данных, имя которого -соответствует имени входного файла, если xxd не считывает данные из потока стандартного -ввода. +Создавать вывод в стиле подключаемых заголовочных файлов языка Си. +Вывод содержит полноценное определение статического массива данных, название +которого соответствует наименованию входного файла, если программа xxd +не считывает данные из стандартного потока ввода. .TP .IR "\-l длина " | " \-len длина" -Завершает работу после записи заданного в параметре +Указывает, что после записи заданного в параметре .RI < длина > -количества октетов. +количества октетов, работа программы будет завершена. +.TP +.I "\-n название " | " \-name название" +Изменить возвращаемое наименование переменной при использовании аргумента \-i. +Применяется к массиву байт, который будет именоваться как \fIназвание\fP и длина +файла как \fIназвание\fP_len. +.TP +.I \-o смещение +Указывает добавить +.RI < смещение > +в отображаемую позицию файла. .TP .IR \-p " | " \-ps " | " \-postscript " | " \-plain -Использует непрерывный формат вывода шестнадцатеричного кода, -известный как "простой" стиль или стиль "postscript". +Использовать непрерывный формата вывода шестнадцатеричного кода, +известного как "простой" стиль или стиль "PostScript". .TP .IR \-r " | " \-revert -Изменяет смысл операции на противоположный: позволяет выполнять преобразование -шестнадцатеричного представления в бинарный код (или применять результат в качестве заплаты). -Если вывод происходит не в поток стандартного вывода, то xxd выполняет добавление кода -к соответствующему файлу. При использовании комбинации ключей +Выполнить операцию обратного преобразования, т. е. преобразование +шестнадцатеричного представления в двоичный код (или применить результат +в качестве исправления). +Если вывод происходит не в стандартного поток вывода, то программа xxd выполняет +добавление кода к выходному файлу. При использовании комбинации аргументов .I \-r \-p происходит чтение "простого" шестнадцатеричного представления без использования -информации о номерах строк и какого-либо специального раскроя колонок. Пробелы -и символы новой строки могут встречаться в любом месте исходных данных. +информации о номерах строк и какого-либо специального распределения колонок. +Пробелы и символы новой строки могут встречаться в любом месте исходных данных. +При использовании комбинации аргументов +.I \-r \-b +будет происходить считывание двоичного представления вместо шестнадцатеричного. +.TP +.IR \-R " " когда +В выходных данных одни и те же шестнадцатеричные значения и строковые значения +будут подсвечиваться одним и тем же цветом. В основном это помогает различать +печатаемые и непечатаемые символы. +Где +.I \fIкогда\fP +может принимать значение +.BR never " (никогда), " always " (всегда), или " auto " (автовыбор, по умолчанию). +Если установлена переменная окружения +.BR $NO_COLOR +, то цветовая подсветка будет отключена. .TP .I \-seek смещение -При использовании после ключа +При указании после аргумента .I \-r -: добавлять указанное +, будет добавляться указанное .RI < смещение > к файловым позициям, обнаруженным в исходных данных. .TP -.I \-s [\+][\-]seek -Начинает работу с указанного абсолютного (или относительного) +.I \-s [+][\-]seek +Начинать обработку с указанного абсолютного (или относительного) .RI < смещения > в байтах во входном_файле. -\fI\+ \fRуказывает, что смещение является относительным по отношению -к текущей файловой позиции в потоке стандартного ввода (бессмысленно, если чтение -происходит не из потока стандартного ввода). \fI\- \fRуказывает, что должно быть прочитано -указанное количество символов от конца ввода (либо, если сочетается с \fI \+ \fR: -перед текущей позиции файла в потоке стандартного ввода). -Если ключ \-s не используется, то xxd начинает работу от текущей позиции в файле. +Где \fI+ \fRуказывает, что смещение является относительным по отношению +к текущей позиции данных в стандартном потоке ввода (бессмысленно, если чтение +происходит не из стандартного потока ввода). А параметр \fI\- \fRуказывает, +что должно быть прочитано указанное количество символов от конца ввода (либо, +если одновременно с параметром \fI+\fR, то перед текущей позицией данных +в стандартном потоке ввода). +Если аргумент \-s не используется, то программа xxd начинает обработку +от текущей позиции в файле. .TP .I \-u -Использует шестнадцатеричные цифры в верхнем регистре. По умолчанию используются цифры в -нижнем регистре символов. +Указывает, что в выводе отображать шестнадцатеричные цифры в верхнем регистре. +По умолчанию используются символы в нижнем регистре символов. .TP .IR \-v " | " \-version -Отображает информацию о версии программы. -.SH ПОДВОДНЫЕ КАМНИ +Показать информацию о версии программы и завершить работу. +.SH НЕКОТОРЫЕ РАЗЪЯСНЕНИЯ .PP +При указании команды .I xxd \-r -обладает встроенным интеллектом для распознавания информации о номерах строк. +при запуске программы, будет применяться некий встроенный алгоритм +для распознавания информации о номерах строк. Если возможен поиск по входному файлу, то номера строк в начале каждой строки -шестнадцатеричного представления могут быть неупорядоченными, некоторые строки могут -быть пропущены или пересекаться друг с другом. В этих случаях xxd использует -lseek(2) для перехода к следующей позиции. Если поиск по входному файлу -невозможен, то допустимы только пропуски строк, которые заполняются нулевыми -байтами. +шестнадцатеричного представления могут быть неупорядоченными, некоторые строки +могут быть пропущены или пересекаться друг с другом. В этих случаях программа +xxd использует функцию lseek(2) для перехода к следующей позиции. Если поиск по +входному файлу невозможен, то допустимы только пропуски строк, которые +заполняются нулевыми байтами. .PP +Использование команды .I xxd \-r -никогда не выводит сообщений об ошибках. Мусор пропускается молча. +приводит к тому, что сообщения об ошибках не будут отображаться. +Посторонние данные просто молча пропускаются. .PP -При редактировании шестнадцатеричных представлений бинарных файлов обращайте -внимание, что +При редактировании шестнадцатеричного представления двоичных файлов, обращайте +внимание, что по команде .I xxd \-r -пропускает в строке ввода любые данные после прочтения достаточного количества -колонок шестнадцатеричных данных (см. ключ \-c). Это означает, что изменения, -внесенные в колонки с печатными символами ascii (или ebcdic), всегда игнорируются. +, после считывания достаточного количества колонок шестнадцатеричных данных +(см. аргумент \-c), в строке ввода не будут обрабатываться остальные данные. +Это означает, что изменения, внесённые в колонке с текстом в кодировке +ASCII (или EBCDIC), всегда игнорируются. При обратном преобразовании шестнадцатеричного представления в стиле -postscript с помощью команды xxd \-r \-p количество колонок не учитывается. -В этом случае распознаются все символы, которые похожи на пары шестнадцатеричных цифр. +PostScript с помощью команды xxd \-r \-p количество колонок не учитывается. +В этом случае распознаются все символы, которые похожи на пары шестнадцатеричных +цифр. .PP Обратите внимание на различие между командами .PP @@ -186,125 +250,139 @@ postscript с помощью команды xxd \-r \-p количество колонок не учитывается. .I xxd \-s \+seek может отличаться от .I xxd \-s seek, -поскольку для того, чтобы "отмотать" данные на входе назад, используется вызов lseek(2). -При использовании `+' поведение будет отличаться, если входные данные -поступают с потока стандартного ввода, а позиция в файле стандартного ввода не находится -в начале файла к тому моменту, когда программа xxd запущена и приступает к чтению ввода. +поскольку для того, чтобы "отмотать" данные на входе назад, используется вызов +функции lseek(2). +При указании параметра '+' поведение будет отличаться, если входные данные +поступают со стандартного потока ввода, а позиция в файле стандартного ввода +не находится в начале файла к тому моменту, когда программа xxd запущена +и приступает к чтению ввода. Нижеследующие примеры помогут прояснить (или ещё больше запутать!) ситуацию... .PP -Отмотка назад потока стандартного ввода; необходимо, поскольку 'cat' уже выполнила -чтение до конца потока стандартного ввода: -.PP -\fI% sh \-c 'cat > plain_copy; xxd \-s 0 > hex_copy' < file +Отмотка потока стандартного ввода назад необходима, поскольку программа 'cat' +уже выполнила чтение данных до конца из стандартного потока ввода: .PP -Вывод шестнадцатеричного представления от позиции в файле 0x480 -(= 1024+128). -Символ `+' означает "относительно текущей позиции", таким образом `128' добавляется -к первому килобайту, где завершает работу dd: +\fI% sh \-c "cat > plain_copy; xxd \-s 0 > hex_copy" < file\fR +.PP +Вывод шестнадцатеричного представления от позиции в файле 0x480 (=1024+128). +Параметр '+' означает "относительно текущей позиции", таким образом '128' +добавляется к первому килобайту, где завершает работу программа dd: .PP -\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +128 > hex_snippet' < file +\fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +128 \> hex_snippet" < file\fR .PP -Вывод шестнадцатеричного представления от позиции в файле 0x100 -(= 1024-768): +Вывод шестнадцатеричного представления от позиции в файле 0x100 (=1024\[mi]768): .PP -\fI% sh \-c 'dd of=plain_snippet bs=1k count=1; xxd \-s +-768 > hex_snippet' < file +\fI% sh \-c "dd of=plain_snippet bs=1k count=1; xxd \-s +\-768 \> hex_snippet" < file\fR .PP -В то же время, следует заметить, что подобные ситуации встречаются довольно редко, -так что символ `+' обычно не используется. Автор предпочитает наблюдать за работой -xxd с помощью strace(1) или truss(1) в тех случаях, когда применяется ключ +В то же время, следует заметить, что подобные ситуации встречаются довольно +редко, так что параметр '+' обычно не используется. Автор предпочитает наблюдать +за работой программы xxd с помощью инструментов strace(1) или truss(1) в тех +случаях, когда применяется аргумент \-s. .SH ПРИМЕРЫ .PP .br -Вывести всё, кроме первых трёх строк (0x30 байтов) файла -.B file +Вывести всё, кроме первых трёх строк (0x30 байт) +.BR файла : -.PP -\fI% xxd \-s 0x30 file +.br +\fI% xxd \-s 0x30 file\fR .PP .br -Вывести три строки (0x30 байтов) от конца файла -.B file +Вывести три строки (0x30 байт) от конца +.BR файла : -.PP -\fI% xxd \-s \-0x30 file +.br +\fI% xxd \-s \-0x30 file\fR .PP .br -Вывести 120 байтов в виде непрерывного шестнадцатеричного представления -по 20 октетов в строке: -.PP +Вывести 120 байт в виде непрерывного шестнадцатеричного представления +по 20 октетов в строке +.br +(этот пример для справочника xxd.1 на английском языке, для русского языка будет +немного другой результат): +.br \fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR .br -2e544820585844203120224d616e75616c207061 +2e544820585844203120224d6179203230323422 .br -676520666f7220787864220a2e5c220a2e5c2220 +20224d616e75616c207061676520666f72207878 .br -32317374204d617920313939360a2e5c22204d61 +64220a2e5c220a2e5c222032317374204d617920 .br -6e207061676520617574686f723a0a2e5c222020 +313939360a2e5c22204d616e2070616765206175 +.br +74686f723a0a2e5c2220202020546f6e79204e75 .br -2020546f6e79204e7567656e74203c746f6e7940 +67656e74203c746f6e79407363746e7567656e2e .br -7363746e7567656e2e7070702e67752e6564752e + .br -.PP +Вывести первые 120 байт этого справочника по 12 октетов в строке .br -Вывести первые 120 байтов этой страницы справочника по 12 октетов в строке: -.PP +(этот пример для справочника xxd.1 на английском языке, для русского языка будет +немного другой результат): +.br \fI% xxd \-l 120 \-c 12 xxd.1\fR .br -0000000: 2e54 4820 5858 4420 3120 224d .TH XXD 1 "M +00000000: 2e54 4820 5858 4420 3120 224d .TH XXD 1 "M .br -000000c: 616e 7561 6c20 7061 6765 2066 anual page f +0000000c: 6179 2032 3032 3422 2022 4d61 ay 2024" "Ma .br -0000018: 6f72 2078 7864 220a 2e5c 220a or xxd"..\\". +00000018: 6e75 616c 2070 6167 6520 666f nual page fo .br -0000024: 2e5c 2220 3231 7374 204d 6179 .\\" 21st May +00000024: 7220 7878 6422 0a2e 5c22 0a2e r xxd"..\\".. .br -0000030: 2031 3939 360a 2e5c 2220 4d61 1996..\\" Ma +00000030: 5c22 2032 3173 7420 4d61 7920 \\" 21st May .br -000003c: 6e20 7061 6765 2061 7574 686f n page autho +0000003c: 3139 3936 0a2e 5c22 204d 616e 1996..\\" Man .br -0000048: 723a 0a2e 5c22 2020 2020 546f r:..\\" To +00000048: 2070 6167 6520 6175 7468 6f72 page author .br -0000054: 6e79 204e 7567 656e 7420 3c74 ny Nugent <t +00000054: 3a0a 2e5c 2220 2020 2054 6f6e :..\\" Ton .br -0000060: 6f6e 7940 7363 746e 7567 656e ony@sctnugen +00000060: 7920 4e75 6765 6e74 203c 746f y Nugent <to .br -000006c: 2e70 7070 2e67 752e 6564 752e .ppp.gu.edu. +0000006c: 6e79 4073 6374 6e75 6765 6e2e ny@sctnugen. .PP .br -Показать дату из файла xxd.1: +Показать дату из файла +.B xxd.1 +.br +(этот пример для справочника xxd.1 на английском языке, для русского языка будет +немного другая команда, например, для UTF-8 \[em] \flxxd \-s 0x50 \-l 13 \-c 13 xxd.1\fR): .PP -\fI% xxd \-s 0x28 \-l 12 \-c 12 xxd.1\fR +\fI% xxd \-s 0x33 \-l 13 \-c 13 xxd.1\fR .br -0000028: 3231 7374 204d 6179 2031 3939 21st May 199 +00000033: 3231 7374 204d 6179 2031 3939 36 21st May 1996 .PP .br Скопировать .B входной_файл в .B выходной_файл -с добавлением 100 байтов со значением 0x00 в начало файла: -.PP +с добавлением 100 байт со значением 0x00 в начало файла: +.br \fI% xxd входной_файл | xxd \-r \-s 100 \> выходной_файл\fR .br + +.br +Заменить дату в файле +.B xxd.1 +.br +(этот пример для справочника xxd.1 на английском языке, для русского языка будут +немного другие команды): +.PP +\fI% echo "0000034: 3574 68" | xxd \-r \- xxd.1\fR +.br +\fI% xxd \-s 0x33 \-l 13 \-c 13 xxd.1\fR +.br +00000033: 3235 7468 204d 6179 2031 3939 36 25th May 1996 .PP .br -Заменить дату в файле xxd.1: +Создать 65537-байтный файл, все байты которого имеют значение 0x00, +кроме последнего байта, который должен иметь значение 'A' (0x41): .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 +\fI% echo "010000: 41" | xxd \-r > file\fR .PP .br Создать шестнадцатеричное представление этого файла с @@ -312,97 +390,97 @@ 0x00, кроме последнего байта, который должен иметь значение 'A' .PP \fI% xxd \-a \-c 12 file\fR .br -0000000: 0000 0000 0000 0000 0000 0000 ............ +00000000: 0000 0000 0000 0000 0000 0000 ............ .br * .br -000fffc: 0000 0000 40 ....A +0000fffc: 0000 0000 41 ....A .PP Создать 1-байтный файл, содержащий символ 'A'. -Число после '\-r \-s' добавляется к номерам строк, найденным в файле; +Число после аргументов '\-r \-s' добавляется к номерам строк, найденным в файле, иначе говоря, предшествующие байты пропускаются: .PP -\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> file\fR +\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 > file\fR .PP -xxd можно использовать в качестве фильтра в редакторе, например в -.B vim(1), -чтобы создать шестнадцатеричное представление области между -отметками `a' и `z': -.PP +Программу xxd можно использовать в качестве фильтра в редакторе, например в +.B vim(1) +, чтобы создать шестнадцатеричное представление области между +закладками 'a' и 'z': +.br \fI:'a,'z!xxd\fR .PP -Вы можете использовать xxd в качестве фильтра в редакторе, например в -.B vim(1), -для восстановления данных из шестнадцатеричного представления -между отметками `a' и `z': -.PP +Можно использовать программу xxd в качестве фильтра в редакторе, например в +.B vim(1) +, для восстановления данных из шестнадцатеричного представления +между закладками 'a' и 'z': +.br \fI:'a,'z!xxd \-r\fR .PP -Вы можете использовать xxd в качестве фильтра в редакторе, например в -.B vim(1), -для восстановления данных из единственной строки +Можно использовать программу xxd в качестве фильтра в редакторе, например в +.B vim(1) +, для восстановления данных из единственной строки шестнадцатеричного представления. Поместите курсор в соответствующую строку и наберите -.PP +.br \fI!!xxd \-r\fR .PP Чтобы прочитать единственный символ из канала связи: -.PP +.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 +\fI% echo \-n foo \> /dev/term/b\fR .PP -.SH ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ -Программа xxd завершает работу со следующими значениями: +.SH КОДЫ ЗАВЕРШЕНИЯ +При завершении работы, программа xxd возвращает следующие значения: .TP 0 Ошибки не обнаружены. .TP \-1 Операция не поддерживается (выполнение -.I xxd \-r \-i +.I \%xxd \-r \-i пока невозможно). .TP 1 -Ошибка при разборе ключей командной строки. +Ошибка при разборе аргументов командной строки. .TP 2 -Проблемы во входном файле. +Ошибки во входном файле. .TP 3 -Проблемы в выходном файле. +Ошибки в выходном файле. .TP 4,5 Желательная позиция поиска недостижима. -.SH СМОТРИ ТАКЖЕ +.SH СМОТРИТЕ ТАКЖЕ uuencode(1), uudecode(1), patch(1) .br .SH ПРЕДУПРЕЖДЕНИЕ Странность этой программы соответствует особенностям мозга её создателя. -Используйте её на свой страх и риск. Копируйте файлы, отслеживайте -вызовы, становитесь волшебником. +Используйте её на свой страх и риск. Копируйте файлы, отслеживайте вызовы, +становитесь волшебником. .br .SH ВЕРСИЯ -Эта страница справочника документирует xxd версии 1.7. +Этот справочник документирует программу xxd версии 1.7 от 2024-05. .SH АВТОР .br -(c) 1990-1997 Юрген Вайгерт (Juergen Weigert) +(c) Юрген Вайгерт (Juergen Weigert), 1990-1997 .br -<jnweiger@informatik.uni-erlangen.de> +<jnweiger@informatik.uni\-erlangen.de> .LP Вы можете свободно распространять программу со ссылкой на меня. .br -Если использование этой программы принесло вам какой-то доход, -поделитесь со мной. +Если использование этой программы принесло вам какой-то доход, поделитесь со +мной. .br -Если вы потеряли деньги, то я тут не причём. +Если вы потеряли деньги, то я тут ни при чём. .PP -Первый вариант страницы справочника написан Тони Наджентом (Tony Nugent) +Первый вариант справочника написан Тони Наджентом (Tony Nugent) .br <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> .br -Небольшие изменения внесены Брамом Мооленааром (Bram Moolenaar). -Страница отредактирована Юргеном Вайгертом (Juergen Weigert). +Небольшие изменения внесены Брамом Моленаром (Bram Moolenaar). +Справочник отредактирован Юргеном Вайгертом (Juergen Weigert). .PP