Кириллица в комментариях к коду модулей
Вопрос в большей мере относится к разработчикам: используете ли вы кириллицу в комментариях при написании кода модулей или такой подход является непростительным? Речь, разумеется, о коде не для drupal.org
/**
* Строит таблицу отношений между словами в фразе.
*
* Для каждой пары слов (в т.ч. и обратной пары) в исходном массиве:
* - вычисляется расстояние (в словах);
* - фиксируется порядок расположения слов относительно друг друга;
* - в зависимости от порядка вычисляется контрольное расстояние между словами.
*
* @param $words
* Линейный массив слов исследуемой фразы. Порядок слов в исходной фразе должен
* соответствовать порядку расположения слов в данном массиве.
*
* @return
* Линейный массив, ключи которого являются идентификаторами пар слов, а
* значения - линейными массивами, содержащими следующие поля:
* - RELATIONS_DISTANCE - расстояние между словами в паре;
* - RELATIONS_ORDER - булевый пареметр, принимающий значение TRUE в случае когда второе
* слово из пары находится после первого;
* - RELATIONS_XDISTANCE - контрольное расстяние.
*
* @TODO:
* - Адекватная работа при отсутсвии слова в индексе.
*/
function words_relations($words) {
// Индексная таблица слов.
global $index;
* Строит таблицу отношений между словами в фразе.
*
* Для каждой пары слов (в т.ч. и обратной пары) в исходном массиве:
* - вычисляется расстояние (в словах);
* - фиксируется порядок расположения слов относительно друг друга;
* - в зависимости от порядка вычисляется контрольное расстояние между словами.
*
* @param $words
* Линейный массив слов исследуемой фразы. Порядок слов в исходной фразе должен
* соответствовать порядку расположения слов в данном массиве.
*
* @return
* Линейный массив, ключи которого являются идентификаторами пар слов, а
* значения - линейными массивами, содержащими следующие поля:
* - RELATIONS_DISTANCE - расстояние между словами в паре;
* - RELATIONS_ORDER - булевый пареметр, принимающий значение TRUE в случае когда второе
* слово из пары находится после первого;
* - RELATIONS_XDISTANCE - контрольное расстяние.
*
* @TODO:
* - Адекватная работа при отсутсвии слова в индексе.
*/
function words_relations($words) {
// Индексная таблица слов.
global $index;
// Таблица отношений.
$relations = array();
// Количество слов в массиве.
$words_count = count($words);
// Цикл перебора слов.
for ($first_word=0; $first_word<$words_count; $first_word++) {
for ($second_word=0; $second_word<$words_count; $second_word++) {
