mkimage-profiles

History

Gleb Fotengauer-Malinovskiy 1432bb1607 add dummy distro/livecd-install sub.in/stage2/image-scripts.d/99cleanup-boot, livecd-install need /boot files too		2012-04-09 22:44:11 +03:00
..
alien.mk	initial alien image support	2012-03-26 22:40:40 +03:00
desktop.mk	syslinux configuration revisited	2012-03-31 21:08:09 +03:00
live.mk	add dummy distro/livecd-install	2012-04-09 22:44:11 +03:00
README	READMEs: pkglist related clarification	2012-04-09 22:21:10 +03:00
server.mk	conf.d/server.mk += server-nano	2012-04-02 17:16:27 +03:00

README

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Этот каталог содержит включаемые фрагменты конфигурации образов с тем,
чтобы было удобнее параллельно разрабатывать специфические дистрибутивы
и VE без излишних merge conflict'ов.

Следует понимать, что основная цель появления mkimage-profiles на свет
-- это уменьшение "форков" внутри семейства дистрибутивных профилей.
Поэтому при возможности следует всё-таки работать над общей базовой
частью, включая скриптовые хуки и списки пакетов, а также оптимизировать
граф зависимостей между конфигурациями образов.

Попросту говоря, copy-paste -- тревожный признак.

По переменным:
- SYSTEM_PACKAGES стоит применять крайне осторожно -- эти пакеты попадут
  во все стадии, в том числе в образ чувствительной к объёму install2
  (в stage1 -- только в инструментальный чрут); применяйте для того,
  что обязано быть и в инсталяторе, и в готовой системе
- для "обычного общего" (live, main, rescue) есть COMMON_PACKAGES
  (NB: попадают в базовую систему)
- для "пользовательского" (live, main) есть THE_GROUPS, THE_LISTS
  и THE_PACKAGES
- аналогично по модулям ядра:
  + STAGE1_KMODULES доступны в производных от stage2 (install2, live, rescue)
  + BASE_KMODULES попадут в установку по умолчанию
  + MAIN_KMODULES будут доступны для установки с носителя
  + LIVE_KMODULES предназначены для LiveCD/LiveFlash
  + THE_KMODULES попадут в "пользовательские" окружения
    (live и установленную систему)

По подстановкам:
- $(VAR) подставляются перед их записью в $(CONFIG), который distcfg.mk
- $$(VAR) раскрываются позже, при включении $(CONFIG) и востребовании
  значений; в этом случае их значения могут изменяться до окончания
  конфигурации, а также зависеть от значений других переменных

По спискам пакетов:
- на этапе экспериментирования можно забивать прямо в описание образа
- при фиксации состояния стоит воспользоваться существующими списками,
  а дополнительные оформить как можно более чётко обособленными по тем
  задачам, для решения которых они и подобраны
- повторяющиеся логически связанные группы списков может иметь смысл
  выделить в фичу (см., например, power или x11)
- если явной фичи не наблюдается, но у группы дистрибутивов намечается
  заметная общая часть -- её можно выделить в промежуточную цель вида
  distro/.name, не являющуюся самостоятельно собираемой

README Unescape Escape

README