view README.rux.txt @ 34854:97b5457962ed v9.1.0296

patch 9.1.0296: regexp: engines do not handle case-folding well Commit: https://github.com/vim/vim/commit/7a27c108e0509f3255ebdcb6558e896c223e4d23 Author: Christian Brabandt <cb@256bit.org> Date: Tue Apr 9 22:53:19 2024 +0200 patch 9.1.0296: regexp: engines do not handle case-folding well Problem: Regex engines do not handle case-folding well Solution: Correctly calculate byte length of characters to skip When the regexp engine compares two utf-8 codepoints case insensitively it may match an adjacent character, because it assumes it can step over as many bytes as the pattern contains. This however is not necessarily true because of case-folding, a multi-byte UTF-8 character can be considered equal to some single-byte value. Let's consider the pattern '?' and the string 's'. When comparing and ignoring case, the single character 's' matches, and since it matches Vim will try to step over the match (by the amount of bytes of the pattern), assuming that since it matches, the length of both strings is the same. However in that case, it should only step over the single byte value 's' so by 1 byte and try to start matching after it again. So for the backtracking engine we need to ensure: - we try to match the correct length for the pattern and the text - in case of a match, we step over it correctly The same thing can happen for the NFA engine, when skipping to the next character to test for a match. We are skipping over the regstart pointer, however we do not consider the case that because of case-folding we may need to adjust the number of bytes to skip over. So this needs to be adjusted in find_match_text() as well. A related issue turned out, when prog->match_text is actually empty. In that case we should try to find the next match and skip this condition. fixes: #14294 closes: #14433 Signed-off-by: Christian Brabandt <cb@256bit.org>
author Christian Brabandt <cb@256bit.org>
date Tue, 09 Apr 2024 23:00:08 +0200
parents 62e99aaa4fcf
children d1b878fce76f
line wrap: on
line source

README.rux.txt для версии 9.1 программы Vim — Vi IMproved.


ЧТО ТАКОЕ РЕДАКТОР VIM?

Программа Vim — это значительно улучшенная версия старого доброго редактора Vi
из системы UNIX.  При разработке этого редактора было добавлено множество новых
возможностей: многоуровневая отмена изменений, подсветка синтаксиса, журнал
командной строки, интерактивная справка, проверка орфографии, подстановка
наименований файлов и команд, операции с произвольными блоками текста,
встроенный язык программирования и т. д.  Также доступен графический интерфейс
пользователя (GUI).  И при этом сохраняется совместимость с редактором Vi,
и те, у кого Vi «в крови», будут чувствовать себя как дома.  Подробности о
различиях с редактором Vi см. в файле "runtime/doc/vi_diff.txt".

Этот редактор очень удобен для работы с исходным кодом программ, а также
разного рода других текстовых файлов.  Все команды вводятся набором обычных
символов клавиатуры, поэтому те, кто освоил десятипальцевый метод печати, могут
работать очень быстро.  Кроме того, пользователи могут назначить на
функциональные клавиши клавиатуры необходимые команды, и использовать
манипулятор «мышь».

Редактор Vim работает в ОС MS Windows (7, 8, 10, 11), macOS, Haiku, VMS и
практически во всех UNIX-подобных системах.  А перенос на другие платформы не
должен представлять особой сложности.
Предыдущие версии редактора Vim работают в операционных системах OS/2, MS-DOS,
MS Windows 95/98/Me/NT/2000/XP/Vista, AmigaDOS, Atari MiNT, BeOS и RISC OS.
Но поддержка этих версий больше не осуществляется.


ПРЕДОСТАВЛЕНИЕ РЕДАКТОРА Vim

Для установки редактора Vim можно воспользоваться привычным диспетчером пакетов.
В системах Mac и Linux уже предустановленна начальная версия программы Vim,
но вам все равно нужно установить редактор Vim, если вы хотите получить больше
возможностей.

Существуют отдельные версии для Unix, PC, Amiga и некоторых других систем.
Данный файл README.rux.txt поставляется вместе с архивом рабочих файлов
программы.  Этот архив включает в себя документацию, файлы подсветки синтаксиса
и другие файлы, которые используются редактором во время работы.  Чтобы
запустить программу Vim, вы должны получить либо архив с исполняемыми файлами,
либо архив с исходным кодом.  Какой из них вам нужен, зависит от того, на какой
системе вы хотите запустить редактор Vim, и есть ли для этой системы
исполняемые файлы или вы должны компилировать программу самостоятельно.
Чтобы узнать о доступных в настоящее время пакетах программы, посмотрите на
веб‐странице https://www.vim.org/download.php.

Несколько полезных мест, где можно получить последнюю версию редактора Vim:
* Посмотрите в git-хранилище на GitHub: https://github.com/vim/vim.
* Получить исходный код в виде архива: https://github.com/vim/vim/releases.
* Получить исполняемый файл для ОС Windows из хранилища vim-win32-installer:
https://github.com/vim/vim-win32-installer/releases.


КОМПИЛЯЦИЯ РЕДАКТОРА Vim

Если для вашей системы уже есть готовые исполняемые файлы, вам не нужно самому
компилировать редактор Vim.  Если вы скачали архив с исходным кодом, то всё
необходимое для компиляции программы Vim находится в каталоге "src".
Инструкции смотрите в файле src/INSTALL.


УСТАНОВКА ПРОГРАММЫ Vim

Инструкции для конкретной системы смотрите в одном из нижеуказанных файлов.
Или в каталоге READMEdir (на https://github.com/vim/vim), или в основном
каталоге (если вы распаковываете архив):

README_ami.txt		Amiga
README_unix.txt		Unix
README_dos.txt		MS-DOS и MS Windows
README_mac.txt		Macintosh
README_haiku.txt	Haiku
README_vms.txt		VMS

Существует ещё несколько файлов README_*.txt, в зависимости от предоставляемого
пакета.


ДОКУМЕНТАЦИЯ ПО РЕДАКТОРУ Vim

Учебник Vim — это часовой практический курс для начинающих.  Как правило, для
работы с ним нужно набрать команду "vimtutor".  Чтобы получить дополнительную
информацию, смотрите раздел документации ":help tutor".

Лучше всего воспользоваться командой ":help" в редакторе Vim.  Если у вас ещё
нет исполняемого файла программы, прочитайте файл "runtime/doc/help.txt".
В нём содержатся отсылки на другие полезные файлы документации.  Руководство
пользователя можно читать как книгу, и оно рекомендуется для обучения работе
с редактором Vim.  Смотрите ":help user-manual".


ЛИЦЕНЗИОННЫЕ ПРАВА

Редактор Vim является благотворительным программным обеспечением.
Использование и копирование программы Vim не ограничено, однако рекомендуется
сделать добровольное пожертвование для нуждающихся детей в Уганде.  Чтобы узнать
подробности, прочитайте, пожалуйста, файл "runtime/doc/uganda.rux" (введите
команду ":help uganda" в редакторе Vim).

Краткое описание лицензии.
Нет никаких ограничений на использование или распространение немодифицированной
копии программы Vim.  Части программы Vim также могут предоставляться отдельно,
но текст лицензии Vim всегда должен быть включён в поставку.
Для модифицированных версий программы действует несколько ограничений.
Лицензия Vim совместима с лицензией GNU GPL, вы можете компилировать
и распространять программу Vim с библиотеками, лицензированными под GNU GPL.


ФИНАНСОВАЯ ПОДДЕРЖКА ДЛЯ РАЗРАБОТКИ РЕДАКТОРА Vim

Устранение ошибок и добавление новых функциональных возможностей требует
вложения немалого количества времени и сил.  Выразить признательность за труд
и подкрепить заинтересованность разработчиков программы в дальнейшей работе
над редактором Vim можно с помощью оказания финансовой поддержки.

Пожертвованные вами деньги будут в основном направлены на оказание помощи детям
Уганды, см. "runtime/doc/uganda.rux".  Однако в любом случае финансирование
будет способствовать повышению заинтересованности команды разработчиков
в продолжении работы над редактором Vim!

Самая свежая информация об оказании финансовой поддержки публикуется на
веб-сайте программы Vim:
	https://www.vim.org/sponsor/


ПОМОЩЬ В РАЗРАБОТКЕ РЕДАКТОРА Vim

Если вы хотите помочь сделать редактор Vim лучше, смотрите файл CONTRIBUTING.md.


ДОПОЛНИТЕЛЬНАЯ ИНФОРМАЦИЯ

Для системе macOS вы може использовать MacVim:  https://macvim.org

Последние новости о редакторе Vim можно найти на его домашней странице:
	https://www.vim.org/

Если у вас возникли вопросы, посмотрите полезные советы или документацию по
редактору Vim:
	https://www.vim.org/docs.php
	https://vim.fandom.com/wiki/Vim_Tips_Wiki

Если у вас все ещё остались вопросы или есть сложности, воспользуйтесь одним
из списков рассылки, чтобы обсудить их с пользователями и разработчиками:
	https://www.vim.org/maillist.php

Если ничего не помогает, сообщайте об ошибках непосредственно в список рассылки
vim-dev:
	<vim-dev@vim.org>


ОСНОВНОЙ АВТОР ПРОГРАММЫ

Большая часть редактора Vim была создана Брамом Моленаром <Bram@vim.org>,
см. ":help Bram-Moolenaar"

Присылайте все прочие комментарии, исправления, цветы и предложения в список
рассылки vim-dev:
	<vim-dev@vim.org>