Вход:  Пароль:  
FreeSource: AltLinux/Sisyphus/devel/Docs ...
Free Source | Каталог | Изменения | НовыеКомментарии | Пользователи | Регистрация |
Эта страница была перенесена на altlinux.org. Текст на freesource.info заморожен.

Советы по упаковке документации


Упаковке подлежит вся документация, поставляемая с программой/библиотекой, за исключением отдельных случаев:


Девелоперская документация библиотек, нужная лишь для разработки использующих эти библиотеки программ (руководства по API, примеры и т.д.) пакуются либо в -devel, либо в отдельный пакет (см. ниже).


Если объем документации сравним (а то и резко больше) объема остальных файлов пакета (как правило это пакет lib*-devel, содержащий небольшой /usr/include и более тяжелый /usr/share/doc, например старый libalsa-devel, стоит задуматься о выделении /usr/share/doc (возможно, за исключением NEWS и т.д.) в отдельный пакет lib*-doc либо lib*-devel-doc (нужно определиться с политикой именования). Примеры использования библиотеки/модуля, если они достаточно тяжелые, стоит паковать в отдельный foo-examples.


Часто пакет содержит очень объемистый файл Changelog и/или (реже) NEWS. Такие файлы необходимо сжимать перед упаковкой. Сжатию подлежат файлы более 100 килобайт, а также файлы, сжатием которых достигается значительный выигрыш в размере бинарного либо установленного пакета.

Ссылки


Ссылок на эту страницу нет


 
Файлов нет. [Показать файлы/форму]
Комментариев нет. [Показать комментарии/форму]