The OpenNET Project / Index page

[ новости /+++ | форум | теги | ]



Индекс форумов
Составление сообщения

Исходное сообщение
"Релиз компилятора Rakudo 2022.02 для языка программирования ..."
Отправлено Самокатофил, 18-Фев-22 18:17 
>> При изменении порядка аргументов функции нужно апдейтить документацию, потому что смотрят документацию, а не порядок аргументов функции в исходном коде.
> Я ж уже писал про это. Во многих реальных проектах документация на
> функции часто бывает устаревшей или вообще отсутствует. Особенно для внутренних функций
> модуля, не для API-функций. В идеале, конечно документация всегда должна быть
> и должна апдейтиться. Но увы, далеко не всегда так бывает.

В Perl принято писать POD. А документацию ради документации конечно, никто не пишет.

>> смотрят документацию, а не порядок аргументов функции в исходном коде
> Это правда для API-функций популярных библиотек. И почти всегда неправда для внутренних
> функций.

Ну дали тебе сигнатуры. Твой аргумент устарел лет на 8.

> Чтобы далеко за примером не ходить, вот исходник, на который выше ссылку
> кидали:
> https://github.com/uutils/coreutils/blob/main/src/uu/mktemp/...
> В файле определено несколько функций, у скольких из них есть документация? Спойлер:
> ни у одной.

И чем им поможет в данном случае параметры? Ты высасываешь из пальца аргументы к своему синдрому утёнка. Перловщикам не нужны сигнатуры en masse. Это подтверждается практикой, и я, как перловщик, говорю тебе об этом прямо, face to face. Что нужно для рефакторинга я тебе написал выше. Твои аргументы -- детский сад. Прости, не б обиду, дружище, но реально, это такая мелочь, что я просто не знаю как сказать это так, чтобы тебя не обидеть.

 

Ваше сообщение
Имя*:
EMail:
Для отправки ответов на email укажите знак ! перед адресом, например, !user@host.ru (!! - не показывать email).
Более тонкая настройка отправки ответов производится в профиле зарегистрированного участника форума.
Заголовок*:
Сообщение*:
  Введите код, изображенный на картинке: КОД
 
При общении не допускается: неуважительное отношение к собеседнику, хамство, унизительное обращение, ненормативная лексика, переход на личности, агрессивное поведение, обесценивание собеседника, провоцирование флейма голословными и заведомо ложными заявлениями. Не отвечайте на сообщения, явно нарушающие правила - удаляются не только сами нарушения, но и все ответы на них. Лог модерирования.



Партнёры:
PostgresPro
Inferno Solutions
Hosting by Hoster.ru
Хостинг:

Закладки на сайте
Проследить за страницей
Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру