docs updated

Minor tweaks to toplevel docs as well as some doc/*.txt,
doc/variables.txt renamed to doc/params.txt, and a brand new
doc/pkglists.txt is added (thanks manowar@ for his considerations).

QUICKSTART

@@ -1,3 +1,6 @@
+English quickstart: make server-mini.iso; see also
+http://en.altlinux.org/Hasher (a large tmpfs is nice).
+
 требуется
 ~~~~~~~~~
 - ALT Linux 6.0 или выше (возможна адаптация "вниз")
@@ -18,13 +21,13 @@
 # apt-get install mkimage hasher git-core
 # hasher-useradd USER
 
-- от имени пользователя (после повторного входа):
+- от имени указанного пользователя (после повторного входа):
 $ git config --global user.email "my@email"
 $ git config --global user.name "My Name"
 $ mkdir ~/out
 
-- тестовая сборка (см. тж. lib/distro.mk, doc/variables.txt):
-$ make distro/icewm.iso
+- тестовая сборка (см. тж. lib/distro.mk, doc/params.txt):
+$ make icewm.iso
 
 ссылки
 ~~~~~~

README

@@ -1,15 +1,16 @@
 Welcome to mkimage-profiles!
 
-English quickstart: make server-mini.iso;
-see http://en.altlinux.org/Hasher (and a large tmpfs).
-
 Configurables: ~/.mkimage/profiles.mk;
-see doc/variables.txt and conf.d/README
+see doc/params.txt and conf.d/README
 
 License: GPLv2+, see COPYING
 
 Most docs are in Russian, welcome to learn it or ask for English.
-См. тж. http://www.altlinux.org/Mkimage/Profiles/m-p
+
+См. тж. http://www.altlinux.org/Mkimage/Profiles/m-p и doc/*.txt:
+- params.txt: переменные, указываемые при запуске сборки
+- features.txt: обзор подключаемых особенностей
+- vars-conf.txt: переменные, влияющие на конфигурацию образа
 
 Задача:
 - конфигурирование и создание образов на базе ALT Linux

conf.d/README

@@ -10,22 +10,27 @@
 
 Попросту говоря, copy-paste -- тревожный признак.
 
-По переменным:
+По переменным (см. тж. ../doc/vars-conf.txt):
+
+- для пользовательского окружения (live, main) предназначены
+  THE_PACKAGES, THE_LISTS, THE_GROUPS, THE_PACKAGES_REGEXP
+
+- для "обычного общего" (live, main, rescue) есть COMMON_PACKAGES
+  (NB: тоже попадают в базовую установку)
+
 - SYSTEM_PACKAGES стоит применять крайне осторожно -- эти пакеты попадут
   во все стадии, в том числе в образ чувствительной к объёму install2
   (в stage1 -- только в инструментальный чрут); применяйте для того,
   что обязано быть и в инсталяторе, и в готовой системе
-- для "обычного общего" (live, main, rescue) есть COMMON_PACKAGES
-  (NB: попадают в базовую систему)
-- для "пользовательского" окружения (live, main) предназначены
-  THE_PACKAGES, THE_LISTS, THE_GROUPS, THE_PACKAGES_REGEXP
-- для строго направленного действия служат:
+
+- для направленного действия служат:
   + STAGE1_PACKAGES, STAGE1_PACKAGES_REGEXP (первая стадия загрузки)
   + STAGE2_PACKAGES (инсталятор и спасательная/"живая" система)
   + INSTALL2_PACKAGES (инсталятор)
   + BASE_PACKAGES, BASE_LISTS, BASE_PACKAGES_REGEXP (базовая система)
   + MAIN_PACKAGES, MAIN_LISTS, MAIN_PACKAGES_REGEXP (дополнительные пакеты)
   + LIVE_PACKAGES, LIVE_LISTS, LIVE_PACKAGES_REGEXP ("живая" система)
+
 - аналогично по модулям ядра:
   + THE_KMODULES попадут в "пользовательскую" среду (live, main)
   + STAGE1_KMODULES доступны в производных от stage2 (install2, live, rescue)
@@ -33,6 +38,8 @@
   + MAIN_KMODULES будут доступны для установки с носителя
   + LIVE_KMODULES предназначены для LiveCD/LiveFlash
 
+Не стоит бояться такого разнообразия, для большинства задач достаточно THE_*.
+
 По подстановкам:
 - $(VAR) подставляются перед их записью в $(CONFIG), который distcfg.mk
 - $$(VAR) раскрываются позже, при включении $(CONFIG) и востребовании

doc/debug.txt

@@ -10,7 +10,7 @@
 
 - build/build.log
   + подробность зависит от значения переменной DEBUG,
-    которую можно передать при запуске make (см. variables.txt);
+    которую можно передать при запуске make (см. params.txt);
   + содержит коммит, из которого происходит сборка, и признак
     "грязности" рабочего каталога при наличии модификаций после
     этого коммита;

doc/pkglists.txt

@@ -0,0 +1,50 @@
+списки пакетов
+~~~~~~~~~~~~~~
+Состав пакетной базы субпрофилей определяется значенями
+следующих переменных профиля (см. тж. ../conf.d/README):
+
+- main: пакетная база для установки
+  + sub.in/main/Makefile, features.in/*/main/lib/*.mk
+  + THE_LISTS, BASE_LISTS, MAIN_LISTS
+  + THE_GROUPS, MAIN_GROUPS
+  + THE_PACKAGES, BASE_PACKAGES, MAIN_PACKAGES,
+    SYSTEM_PACKAGES, COMMON_PACKAGES
+  + THE_PACKAGES_REGEXP, BASE_PACKAGES_REGEXP, MAIN_PACKAGES_REGEXP
+  + THE_KMODULES, BASE_KMODULES, MAIN_KMODULES, BASE_KMODULES_REGEXP
+    - KFLAVOURS
+
+- stage2: общая часть installer, live, rescue
+  + sub.in/stage2/Makefile, features.in/*/stage2/lib/*.mk
+  + SYSTEM_PACKAGES, STAGE2_PACKAGES
+  + STAGE1_KMODULES, STAGE1_KMODULES_REGEXP,
+    STAGE2_KMODULES, STAGE2_KMODULES_REGEXP
+    - STAGE1_KFLAVOUR или последний из KFLAVOURS
+
+- installer: компактная "живая" система, содержащая только инсталятор
+  + см. stage2
+  + features.in/install2/install2/stage2cfg.mk,
+    features.in/*/install2/lib/*.mk
+  + INSTALL2_PACKAGES
+
+- live: пользовательский LiveCD (может содержать также инсталятор)
+  + см. stage2
+  + features.in/live/live/stage2cfg.mk,
+    features.in/*/live/lib/*.mk
+  + THE_LISTS, LIVE_LISTS
+  + THE_GROUPS, LIVE_GROUPS
+  + THE_PACKAGES, LIVE_PACKAGES, COMMON_PACKAGES
+  + THE_PACKAGES_REGEXP, LIVE_PACKAGES_REGEXP
+  + THE_KMODULES, LIVE_KMODULES
+
+- rescue: спасательный LiveCD
+  + см. stage2
+  + features.in/rescue/rescue/stage2cfg.mk
+  + RESCUE_PACKAGES, COMMON_PACKAGES
+  + RESCUE_LISTS
+
+- stage1: ядро и загрузчик второй стадии
+  + sub.in/stage1/Makefile, features.in/*/stage1/lib/*.mk
+  + STAGE1_PACKAGES, SYSTEM_PACKAGES
+  + STAGE1_PACKAGES_REGEXP
+  + STAGE1_KMODULES_REGEXP
+    - STAGE1_KFLAVOUR или последний из KFLAVOURS