• Michael Shigorin's avatar
    full-view docs update · ddf0c5b7
    Michael Shigorin authored
    - toplevel README received some long-needed refactoring
      + lowlevel detail moved, well, to lowlevel READMEs
    - reflected more thoroughly that m-p is not about distros anymore
    - dropped features.in/00example/README.en: it's already out-of-date
      a bit, and there's no perceived need in thorough English docs so far
    - wiki article got split into parts and somewhat rewritten, links updated
    - mv doc/{CodingStyle,style.txt}
    ddf0c5b7
Name
Last commit
Last update
..
00example Loading commit data...
bootloader Loading commit data...
build-distro Loading commit data...
build-ve Loading commit data...
cleanup Loading commit data...
dev Loading commit data...
dos Loading commit data...
firmware Loading commit data...
hdt Loading commit data...
install2 Loading commit data...
live Loading commit data...
lowmem Loading commit data...
memtest Loading commit data...
pack Loading commit data...
powerbutton Loading commit data...
rescue Loading commit data...
stage2 Loading commit data...
syslinux Loading commit data...
x11 Loading commit data...
Makefile Loading commit data...
README Loading commit data...
Этот каталог содержит т.н. фичи (features, особенности) --
каталоги, содержимое каждого из которых реализует одну из
подключаемых автономных возможностей образа.

Каждая фича должна содержать задействуемый при построении
конфигурации будущего образа файл config.mk, включаемый
в ../Makefile; он может описывать одну или более целей
вида use/*, дополняющих конфигурацию, и при наличии
дополнительных хуков для копирования или generate.*
должен добавить имя фичи в $(FEATURES).

На этапе генерации сборочного профиля фичи рассматриваются
после инициализации профиля (см. ../image.in/) и копирования
субпрофилей (см. ../sub.in/).  Для каждой фичи, указанной
в $(FEATURES), копируются подкаталоги сообразно субпрофилям,
а также производится обработка {tagged/,}{image-},scripts.d/
(см. cleanup/ в качестве примера); затем выполняется скрипт
generate.sh и задействуется generate.mk (при их наличии).

  NB: тегированные скрипты являются экспериментальными,
      возможны недоработки и существенные изменения!

Если фича дополняет хуками семейство целевых субпрофилей,
построенных на одном базовом, можно воспользоваться подкаталогом
с именем исходного базового субпрофиля (см. $src, $dst в Makefile).

Каталог lib/ является специфическим для фич, определяющих
построение конкретного вида образа -- см. build-*/.

Несложный пример содержится в 00example/, более близкий к жизни
и нынешним пределам возможностей метапрофиля -- в syslinux/.

Основные фичи для построения дистрибутивных образов:
- stage1: propagator, ядро инсталятора и initrd в т.ч. с firmware
- stage2: базовый live-образ (и модули ядра, соответствующие stage1);
  используется фичами install2, live, rescue
- main: пакетная база