Merging upstream version 2:9.1.0698.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 272 insertions, 194 deletions

diff --git a/runtime/doc/xxd-ru.UTF-8.1 b/runtime/doc/xxd-ru.UTF-8.1
index 4a41d66..65586dd 100644
--- 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 \` \- '
-), результат преобразования направляется в поток стандартного вывода.
-.PP
-Обратите внимание, что используется "ленивый" алгоритм разбора ключей, который не
-проверяет более одной буквы ключа, если в этом ключе не используется параметр.
-Пробелы между единственным символом ключа и соответствующим параметром не являются
-обязательными. Параметры ключей могут быть заданы с использованием десятичного,
-шестнадцатеричного или восьмеричного формата.
-Таким образом, ключи
+.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' уже выполнила
-чтение до конца потока стандартного ввода:
+Отмотка потока стандартного ввода назад необходима, поскольку программа 'cat'
+уже выполнила чтение данных до конца из стандартного потока ввода:
 .PP
-\fI% sh \-c 'cat > plain_copy; xxd \-s 0 > hex_copy' < file
+\fI% sh \-c "cat > plain_copy; xxd \-s 0 > hex_copy" < file\fR
 .PP
-Вывод шестнадцатеричного представления от позиции в файле 0x480 
-(= 1024+128).
-Символ `+' означает "относительно текущей позиции", таким образом `128' добавляется
-к первому килобайту, где завершает работу dd:
+Вывод шестнадцатеричного представления от позиции в файле 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
-.PP
 .br
-Вывести 120 байтов в виде непрерывного шестнадцатеричного представления
-по 20 октетов в строке:
+\fI% xxd \-s \-0x30 file\fR
 .PP
+.br
+Вывести 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
-2020546f6e79204e7567656e74203c746f6e7940
+74686f723a0a2e5c2220202020546f6e79204e75
 .br
-7363746e7567656e2e7070702e67752e6564752e
+67656e74203c746f6e79407363746e7567656e2e
 .br
-.PP
+
+.br
+Вывести первые 120 байт этого справочника по 12 октетов в строке
+.br
+(этот пример для справочника xxd.1 на английском языке, для русского языка будет
+немного другой результат):
 .br
-Вывести первые 120 байтов этой страницы справочника по 12 октетов в строке:
-.PP
 \fI% xxd \-l 120 \-c 12 xxd.1\fR
 .br
-0000000: 2e54 4820 5858 4420 3120 224d  .TH XXD 1 "M
+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
-.PP
+
 .br
-Заменить дату в файле xxd.1:
+Заменить дату в файле
+.B xxd.1
+.br
+(этот пример для справочника xxd.1 на английском языке, для русского языка будут
+немного другие команды):
 .PP
-\fI% echo '0000029: 3574 68' | xxd \-r \- xxd.1\fR
+\fI% echo "0000034: 3574 68" | xxd \-r \- xxd.1\fR
 .br
-\fI% xxd \-s 0x28 \-l 12 \-c 12 xxd.1\fR
+\fI% xxd \-s 0x33 \-l 13 \-c 13 xxd.1\fR
 .br
-0000028: 3235 7468 204d 6179 2031 3939  25th May 199
+00000033: 3235 7468 204d 6179 2031 3939 36  25th May 1996
 .PP
 .br
-Создать 65537-байтный файл, все байты которого имеют значение
-0x00, кроме последнего байта, который должен иметь значение 'A'
-(0x41):
+Создать 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 @@ xxd с помощью strace(1) или truss(1) в тех случаях, ког
 .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
-.PP
-xxd можно использовать в качестве фильтра в редакторе, например в 
-.B vim(1),
-чтобы создать шестнадцатеричное представление области между
-отметками `a' и `z':
+\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 > file\fR
 .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