translation(ru): updated vimtutor translation, update MAINTAINERS file

the translated man page is synchronized with the original English

closes: #16113

Signed-off-by: RestorerZ <restorer@mail2k.ru>
Signed-off-by: Christian Brabandt <cb@256bit.org>

.github/MAINTAINERS

@@ -111,6 +111,16 @@ runtime/compiler/yamllint.vim		@romainl
 runtime/compiler/zsh.vim		@dkearns
 runtime/doc/ft_hare.txt			@selenebun
 runtime/doc/ps1.txt			@heaths
+runtime/doc/evim-ru.1			@RestorerZ
+runtime/doc/evim-ru.UTF-8.1		@RestorerZ
+runtime/doc/vim-ru.1			@RestorerZ
+runtime/doc/vim-ru.UTF-8.1		@RestorerZ
+runtime/doc/vimdiff-ru.1		@RestorerZ
+runtime/doc/vimdiff-ru.UTF-8.1		@RestorerZ
+runtime/doc/vimtutor-ru.1		@RestorerZ
+runtime/doc/vimtutor-ru.UTF-8.1		@RestorerZ
+runtime/doc/xxd-ru.1			@RestorerZ
+runtime/doc/xxd-ru.UTF-8.1		@RestorerZ
 runtime/ftplugin/abaqus.vim		@costerwi
 runtime/ftplugin/antlr4.vim		@jiangyinzuo
 runtime/ftplugin/apache.vim		@dubgeiser

runtime/doc/vimtutor-ru.1

@@ -1,63 +1,111 @@
-.TH VIMTUTOR 1 "12 августа 2024"
+.TH VIMTUTOR 1 "04 ноября 2024"
 .SH НАЗНАЧЕНИЕ
-Программа vimtutor \[em] выполняет запуск учебника по редактору Vim.
+Программа vimtutor \[em] выполняет запуск учебника по редактору Vim
 .SH КРАТКИЙ ОБЗОР
 .br
-.B vimtutor [\-g] [язык]
+.B vimtutor [\-l | \-\-language ISO639] [\-c | \-\-chapter НОМЕР] [\-g | \-\-gui] [ISO639]
+.br
+.B vimtutor [\-h | \-\-help]
+.br
+.B vimtutor [\-\-list]
 .SH ОПИСАНИЕ
 По команде
 .B vimtutor
 выполняется запуск редактора
 .B Vim.
-с загруженным файлом, содержащем текст учебника. Но перед этим происходит
+с загруженным файлом, содержащем текст учебника.
-создание копии файла учебника, чтобы в нём можно было выполнять практические
-задания без опасения испортить исходный файл.
 .PP
 Практический курс, который будет открыт по команде
 .B vimtutor
 полезен для новичков, желающих научиться самым основным командам редактора
 .B Vim.
 .PP
-Через необязательный аргумент командной строки \-g даётся указание на запуск
+Необязательный аргумент [ISO639] задаётся как двух- или трёхсимвольный код языка,
-учебника в графическом интерфейсе редактора, если это, конечно, возможно.
+например, "ru" или "it", или "bar".
-При не возможности выполнить это, будет запущен консольный вариант редактора
-.B Vim.
 .PP
-Необязательный аргумент [язык] задаётся как двухсимвольный код языка, например,
+По команде
-"ru" или "it".
+.B Vimtutor
-Если аргумент [язык] не указан, то используется язык, заданный в действующих
+будет открыта созданная копии файла учебника, чтобы в нём можно было выполнять
-в настоящий момент региональных настройках. Если учебника на этом языке не
+практические задания без опасения испортить исходный файл.
-существует, то, по умолчанию, используется учебник на английском языке.
 .PP
 При работе с учебником, редактор
 .B Vim
-всегда запускается в режиме совместимости с редактором Vi.
+всегда запускается в режиме совместимости с редактором
+.B Vi.
+.SH АРГУМЕНТЫ КОМАНДНОЙ СТРОКИ
+.TP
+.BR \-l ", " \-\-language =\fIISO639\fR
+Задаёт двух- или трёхсимволный код языка. Например, "ru", "es", "bar". По
+умолчанию используется язык, заданный в действующих региональных настройках,
+если такие настройки есть. В противном случае используется английский язык.
+.TP
+.BR \-c ", " \-\-chapter =\fIНОМЕР\fR
+Задаёт номер главы учебника. Значением может быть 1 или 2. По умолчанию будет
+открыта первая глава учебника.
+.TP
+.BR \-g ", " \-\-gui
+Указывает на запуск учебника в графическом интерфейсе редактора, если это
+возможно. В противном случае будет запущен консольный вариант редактора
+.B Vim.
+.TP
+.BR \-h ", " \-\-help
+Будет показана краткая информация об аргументах и параметрах командной строки.
+.TP
+.BR \-\-list
+Будет показана информация о доступных главах и языках учебника.
+.SH ПРИМЕРЫ
+Чтобы открыть первую главу учебника на немецком языке, наберите команду
+.PP
+.nf
+.RS
+vimtutor de
+.RE
+.fi
+.PP
+Чтобы открыть вторую главу учебника на английском языке, наберите команду
+.PP
+.nf
+.RS
+vimtutor -c2
+.RE
+.fi
+.PP
+Пример с использованием полных форм аргументов командной строки для баварского
+языка с открытием первой главы учебника в графическом интерфейсе редактора
+.PP
+.nf
+.RS
+vimtutor --language bar --chapter 1 --gui
+.RE
+.fi
 .SH ФАЙЛЫ
-Здесь и далее
-.I "vim??"
-означает сокращённую запись номера версии, например, vim91 для версии редактора
-.B Vim 9.1
 .TP 15
-/usr/local/share/vim/vim??/tutor/tutor[.язык]
+/usr/local/share/vim/vim??/tutor/tutor1[.ISO639]
-Файлы с текстом учебника
+Файлы с текстом первой главы учебника
+.B Vimtutor.
+.TP 15
+/usr/local/share/vim/vim??/tutor/tutor2[.ISO639]
+Файлы с текстом второй главы учебника
 .B Vimtutor.
 .TP 15
 /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 (теперь
+Smith) из Colorado State University.
-недоступен).
+.B E-mail: bware@mines.colorado.edu
-.br
+(теперь недоступен).
+.PP
 Впоследствии учебник был доработан для использования в редакторе
 .B Vim
 Брамом Моленаром (Bram Moolenaar).
-Имена переводчиков учебника упоминаются в соответствующих файлах.
+.PP
+Имена переводчиков указаны в соответствующих файлах с переводами учебника.
 .SH СМОТРИТЕ ТАКЖЕ
 vim(1)

runtime/doc/vimtutor-ru.UTF-8.1

@@ -1,63 +1,111 @@
-.TH VIMTUTOR 1 "12 августа 2024"
+.TH VIMTUTOR 1 "04 ноября 2024"
 .SH НАЗНАЧЕНИЕ
-Программа vimtutor \[em] выполняет запуск учебника по редактору Vim.
+Программа vimtutor \[em] выполняет запуск учебника по редактору Vim
 .SH КРАТКИЙ ОБЗОР
 .br
-.B vimtutor [\-g] [язык]
+.B vimtutor [\-l | \-\-language ISO639] [\-c | \-\-chapter НОМЕР] [\-g | \-\-gui] [ISO639]
+.br
+.B vimtutor [\-h | \-\-help]
+.br
+.B vimtutor [\-\-list]
 .SH ОПИСАНИЕ
 По команде
 .B vimtutor
 выполняется запуск редактора
 .B Vim.
-с загруженным файлом, содержащем текст учебника. Но перед этим происходит
+с загруженным файлом, содержащем текст учебника.
-создание копии файла учебника, чтобы в нём можно было выполнять практические
-задания без опасения испортить исходный файл.
 .PP
 Практический курс, который будет открыт по команде
 .B vimtutor
 полезен для новичков, желающих научиться самым основным командам редактора
 .B Vim.
 .PP
-Через необязательный аргумент командной строки \-g даётся указание на запуск
+Необязательный аргумент [ISO639] задаётся как двух- или трёхсимвольный код языка,
-учебника в графическом интерфейсе редактора, если это, конечно, возможно.
+например, "ru" или "it", или "bar".
-При не возможности выполнить это, будет запущен консольный вариант редактора
-.B Vim.
 .PP
-Необязательный аргумент [язык] задаётся как двухсимвольный код языка, например,
+По команде
-"ru" или "it".
+.B Vimtutor
-Если аргумент [язык] не указан, то используется язык, заданный в действующих
+будет открыта созданная копии файла учебника, чтобы в нём можно было выполнять
-в настоящий момент региональных настройках. Если учебника на этом языке не
+практические задания без опасения испортить исходный файл.
-существует, то, по умолчанию, используется учебник на английском языке.
 .PP
 При работе с учебником, редактор
 .B Vim
-всегда запускается в режиме совместимости с редактором Vi.
+всегда запускается в режиме совместимости с редактором
+.B Vi.
+.SH АРГУМЕНТЫ КОМАНДНОЙ СТРОКИ
+.TP
+.BR \-l ", " \-\-language =\fIISO639\fR
+Задаёт двух- или трёхсимволный код языка. Например, "ru", "es", "bar". По
+умолчанию используется язык, заданный в действующих региональных настройках,
+если такие настройки есть. В противном случае используется английский язык.
+.TP
+.BR \-c ", " \-\-chapter =\fIНОМЕР\fR
+Задаёт номер главы учебника. Значением может быть 1 или 2. По умолчанию будет
+открыта первая глава учебника.
+.TP
+.BR \-g ", " \-\-gui
+Указывает на запуск учебника в графическом интерфейсе редактора, если это
+возможно. В противном случае будет запущен консольный вариант редактора
+.B Vim.
+.TP
+.BR \-h ", " \-\-help
+Будет показана краткая информация об аргументах и параметрах командной строки.
+.TP
+.BR \-\-list
+Будет показана информация о доступных главах и языках учебника.
+.SH ПРИМЕРЫ
+Чтобы открыть первую главу учебника на немецком языке, наберите команду
+.PP
+.nf
+.RS
+vimtutor de
+.RE
+.fi
+.PP
+Чтобы открыть вторую главу учебника на английском языке, наберите команду
+.PP
+.nf
+.RS
+vimtutor -c2
+.RE
+.fi
+.PP
+Пример с использованием полных форм аргументов командной строки для баварского
+языка с открытием первой главы учебника в графическом интерфейсе редактора
+.PP
+.nf
+.RS
+vimtutor --language bar --chapter 1 --gui
+.RE
+.fi
 .SH ФАЙЛЫ
-Здесь и далее
-.I "vim??"
-означает сокращённую запись номера версии, например, vim91 для версии редактора
-.B Vim 9.1
 .TP 15
-/usr/local/share/vim/vim??/tutor/tutor[.язык]
+/usr/local/share/vim/vim??/tutor/tutor1[.ISO639]
-Файлы с текстом учебника
+Файлы с текстом первой главы учебника
+.B Vimtutor.
+.TP 15
+/usr/local/share/vim/vim??/tutor/tutor2[.ISO639]
+Файлы с текстом второй главы учебника
 .B Vimtutor.
 .TP 15
 /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 (теперь
+Smith) из Colorado State University.
-недоступен).
+.B E-mail: bware@mines.colorado.edu
-.br
+(теперь недоступен).
+.PP
 Впоследствии учебник был доработан для использования в редакторе
 .B Vim
 Брамом Моленаром (Bram Moolenaar).
-Имена переводчиков учебника упоминаются в соответствующих файлах.
+.PP
+Имена переводчиков указаны в соответствующих файлах с переводами учебника.
 .SH СМОТРИТЕ ТАКЖЕ
 vim(1)