Docs

Материал из ALT Linux Wiki

Версия 06:19, 8 ноября 2008 (просмотреть исходный код) MikhailGusarov (обсуждение | вклад) ← Предыдущая правка		Версия 17:43, 13 ноября 2009 (просмотреть исходный код) IgorVlasenko (обсуждение | вклад) Следующая правка →
Строка 1:		Строка 1:
-	[[Category:Devel]]	+	{{span|font-size: 180%|}}
		+	{{DraftPolicy
		+	|responsible=Igor Vlasenko
		+	}}
		+
		+	== Полиси по упаковке Info файлов ==
		+
	== Правила упаковки документации ==		== Правила упаковки документации ==

---

Версия 17:43, 13 ноября 2009

Черновик политики Sisyphus

Автор(ы) — Igor Vlasenko

Полиси по упаковке Info файлов

Правила упаковки документации

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

• стандартных файлов INSTALL, содержащих строку "These are generic installation instructions.". Эти файлы создаются путем копирования /usr/share/automake-*/INSTALL в процессе работы automake.
• пустых файлов NEWS и т.д.
• файлов стандартных лицензий
• руководств по сборке/установке программы, содержащие тривиальные рекомендации про ./configure && make && make install
• файлов вида ChangeLog, генерирующихся из системы контроля версий и содержащих просто список коммитов

Документация для разработчиков (описание API, примеры и т.д.) пакуется, в зависимости от размера

• в -devel-пакет, если размер документации меньше остального содержимого пакета
• в -doc (или -devel-doc, если в -doc находится документация для пользователей), в противном случае

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