From 87406c33c7e073e0f33b2dd79dacda5ef4e4e238 Mon Sep 17 00:00:00 2001
From: RestorerZ <restorer@mail2k.ru>
Date: Thu, 10 Jul 2025 20:52:18 +0200
Subject: [PATCH] runtime(help_ru): Update help_ru syntax script

closes: #17718

Signed-off-by: RestorerZ <restorer@mail2k.ru>
Signed-off-by: Christian Brabandt <cb@256bit.org>
---
 runtime/syntax/help_ru.vim | 98 +++++++++++++++++++-------------------
 1 file changed, 50 insertions(+), 48 deletions(-)

diff --git a/runtime/syntax/help_ru.vim b/runtime/syntax/help_ru.vim
index 67df7e1240..d393405f98 100644
--- a/runtime/syntax/help_ru.vim
+++ b/runtime/syntax/help_ru.vim
@@ -1,7 +1,7 @@
 " Vim syntax file
 " Language:     Russian Vim program help files *.rux
-" Maintainer:   Restorer (restorers@users.sourceforge.net DEFUNCT)
-" Last Change:  04 Aprl 2017
+" Maintainer:   Restorer, <restorer@mail2k.ru>
+" Last Change:  2025 Jul 07
 " 
 
 " Проверяем язык локали и установки опции 'helplang'
@@ -10,56 +10,58 @@ if (v:lang !~? 'ru' || v:lang !~? 'russian') && &helplang !~? 'ru'
   finish
 endif
 
-" Подсветка русских гиперссылок
+" Определение синтаксиса русских гиперссылок
 syntax match helpHyperTextJump	"\\\@<!|[^"*~# |]\+|" contains=helpBar
 syntax match helpHyperTextEntry	"\*[^"*|]\+\*\s"he=e-1 contains=helpStar
 syntax match helpHyperTextEntry	"\*[^"*|]\+\*$" contains=helpStar
 
-" Заголовок статьи, раздела и т. п.
-syntax match helpHeadline   "^[А-ЯЁ]\{2}[ .]\=[-,А-ЯЁA-Z0-9 .()]*"
+" Определение синтаксиса статьи, подраздела и т. п.
+syntax match helpHeadline	"^[А-ЯЁ]\{2,}[ .]\=[-,А-ЯЁA-Z0-9 .()]*"
 
-" Наименование справочника
-" новый заголовок
-" syntax match helpVim      "\<СПРАВОЧНИК ПО РЕДАКТОРУ VIM\>"
-"старый заголовок
-syntax match helpVim      "\<СПРАВОЧНИК ПО .*"
-" новый заголовок
-"syntax match helpVim      "\<РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ РЕДАКТОРОМ VIM\>"
-"syntax match helpVim      "\<автор\%[ы:] .*$"
-"старый заголовок
-syntax match helpVim      "\<РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ .*"
-" Подсветка примечаний в тексте, начала примеров и т.п.
-syntax keyword helpNote     Примечание. Совет. Пример. Примеры:
-syntax keyword helpWarning   Внимание!
-" в старой версии документации
-syntax keyword helpNote     Замечание:
-" в старой версии документации
-syntax keyword helpWarning   ВНИМАНИЕ! Предупреждение:
-" Подсветка Ex-команд в документации Vim
-syntax match helpCommand     "\":[A-Za-z!]\+\""hs=s+1,he=e-1
-" Подсветка специальных обозначений
-syntax match helpSpecial    "{[-а-яёА-ЯЁ0-9'":%#=[\]<>.,]\+}"
-syntax match helpSpecial    "{[-а-яёА-ЯЁ0-9'"*+/:%#=[\]<>.,]\+}"
-syntax match helpSpecial    "\s\[[-а-яё^А-ЯЁ0-9_]\{2,}]"ms=s+1
-syntax match helpSpecial    "<[-а-яёА-ЯЁ0-9_]\+>"
-syntax match helpSpecial    "\[диапазон]"
-syntax match helpSpecial    "\[счётчик]"
-syntax match helpSpecial    "\[число]"
-syntax match helpSpecial    "\[+число]"
-syntax match helpSpecial    "\[-число]"
-syntax match helpSpecial    "\[кол-во]"
-syntax match helpSpecial    "\[строка]"
-syntax match helpSpecial    "\[смещение]"
-syntax match helpSpecial    "\[параметр]"
-syntax match helpSpecial    "\[параметры]"
-syntax match helpSpecial    "CTRL-{символ}"
-syntax region helpNotVi     start="{Доступно только" start="{В редкторе Vim" start="{В редакторе Vi" end="}" contains=helpLeadBlank,helpHyperTextJump
-" Подсветка примечаний переводчика
-syntax region helpTrnsNote  start="\[Прим. перевод." end="]" contains=helpComment
-" Определение группы подсветки Ex-команд в документации Vim
-"hi def link helpCommand     vimCommand
-" Определение группы подсветки примечаний переводчика
-hi def link helpTrnsNote    Comment
-" hi def link helpTrnsNote    Comment
+" Определение синтаксиса заголовка основного файла справки
+syntax match helpVim		"\<РЕДАКТОР VIM — общий обзор\>"
+" Определение синтаксиса наименования справочника
+syntax match helpVim		"\<СПРАВОЧНИК ПО РЕДАКТОРУ VIM\>"
+" Определение синтаксиса наименования руководства пользователя
+syntax match helpVim		"\<РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ ПО РЕДАКТОРУ VIM\>"
+" Определение синтаксиса автора справочника, руководства пользователя
+syntax match helpAutor		"^\s\+\<автор\%[ы:] .*$"
+" Определение синтаксиса примечаний в тексте, начала примеров и т. п.
+syntax keyword helpNote		Примечание\. Совет\. Пример\. Прмимер, Примеры:
+syntax keyword helpWarning	Внимание!
+syntax keyword helpDeprecated	Недействующий Недействующая Недействующее
+syntax keyword helpDeprecated	недейстующиий недействующая недействующее
+syntax keyword helpDeprecated	Устаревший Устаревшая Устаревшее
+syntax keyword helpDeprecated	устаревший устаревшая устаревшее
+" Определение синтаксиса Ex-команд в документации Vim (старый стиль)
+syntax match helpCommand	~\":\w\+\%[!]\"~hs=s+1,he=e-1
+" Определение синтаксиса специальных обозначений
+syntax match helpSpecial	"{[-а-яёА-ЯЁ0-9'":%#=[\]<>.,]\+}"
+syntax match helpSpecial	"{[-а-яёА-ЯЁ0-9'"*+/:%#=[\]<>.,_]\+}"
+syntax match helpSpecial	"\s\[[-а-яё^А-ЯЁ0-9_]\{2,}]"ms=s+1
+syntax match helpSpecial	"<[-а-яёА-ЯЁ0-9_]\+>"
+syntax match helpSpecial	"\[диапазон]"
+syntax match helpSpecial	"\[счётчик]"
+syntax match helpSpecial	"\[число]"
+syntax match helpSpecial	"\[+число]"
+syntax match helpSpecial	"\[-число]"
+syntax match helpSpecial	"\[кол-во]"
+syntax match helpSpecial	"\[строка]"
+syntax match helpSpecial	"\[смещение]"
+syntax match helpSpecial	"\[параметр]"
+syntax match helpSpecial	"\[параметры]"
+syntax match helpSpecial	"CTRL-{символ}"
+syntax region helpNotVi		start="{Доступно только" start="{В редкторе Vim" start="{В редакторе Vi" end="}" contains=helpLeadBlank,helpHyperTextJump
+" Определение синтаксиса примечаний переводчика
+syntax region helpTrnsNote	start="\[Примеч\. перев\. — " end="\]\." contains=helpComment
+" Группа подсветки синтаксиса Ex-команд внутри строки документации Vim
+hi def link helpCommand		VimCommand
+" Группа подсветки синтаксиса примеров в документации Vim
+hi def link helpExample		SpecialComment
+"hi def link helpExample		PreCondit
+" Группа подсветки синтаксиса примечаний переводчика
+hi def link helpTrnsNote	Comment
+" Группа подсветки синтаксиса автора справочника, руководства пользователя
+hi def link helpAutor		HelpVim
 "
 " vim: ts=8 sw=2