[newbies] [Bug 39461] [3.4] join bne@
Николай Бурыкин
burykin на basealt.ru
Пт Апр 9 15:18:04 MSK 2021
Добрый день.
> Есть замечания по упаковке документации:
>
> 1) Не следует добавлять зависимость на основной пакет:
> Requires: %name = %version-%release
>
> Документацию вполне можно установить и читать и без него. Это не
> самое распространённое действие, но вполне допустимое: например,
> пользователь может захотеть ознакомиться с документацией к пакету
> перед его установкой, чтоб решить, нужно ли его вовсе устанавливать.
>
> 2) Документацию следует делать noarch:
> BuildArch: noarch
>
> 3) Примеры (*.ebrc) лучше установить в отдельный пакет examples.
> Он тоже должен быть noarch в данном случае.
>
> Так же смотрите рекомендации по упаковке документации и примеров:
> https://www.altlinux.org/Package_Splitting#Документация_и_примеры
> В общем-то, все вышеуказанные замечания там описаны.
>
> Из правила noarch в редких случаях возможны исключения: например,
> когда примеры архитектурно-зависимы. Кроме того у нас были случаи,
> когда документация на разных архитектурах генерировалась разная —
> но это очень редкая ситуация.
>
> Кроме того, есть замечание по sed: в аргументе подстановки лучше
> использовать макрос %_docdir, чем непосредственно указывать путь:
> sed -i "s|/usr/share/doc/%name|%_docdir/%name-%version|" CMakeLists.txt
>
> Результат сборки будет тот же, но на случай, если в будущем кому-то
> приспичит поменять /usr/share/doc на что-то ещё, будет проще на
> уровне дистрибутива всё это исправлять.
>
> В остальном всё хорошо.
>
> Для исправленного варианта тег пересоздайте без инкремента, т.к.
> эта версия в Сизиф ещё не попала.
Замечания вроде все исправил. Отправил в новую сборку
http://git.altlinux.org/tasks/index/sisyphus/eperm/269289/
Интересно, мне казалось я перечитал все статьи, касающиеся сборки
пакетов на вики.
Тем не менее
https://www.altlinux.org/Package_Splitting#Документация_и_примеры
я как-то пропустил. Вообще на неё не натыкался. За неё отдельное спасибо.
----------- следующая часть -----------
Вложение в формате HTML было удалено...
URL: <http://lists.altlinux.org/pipermail/devel-newbies/attachments/20210409/be915a33/attachment.html>
Подробная информация о списке рассылки devel-newbies