From e93d6cabcabc4426b16abc90da57e09136f27e10 Mon Sep 17 00:00:00 2001
From: Michael Shigorin <mike@altlinux.org>
Date: Mon, 2 Jan 2012 17:52:48 +0200
Subject: [PATCH] docs: minor updates

doc/variables.txt was missing the already-existing BUILDLOG
variable description, and ARCHES got added during multi-target
toplevel rewrite.  Other minor fixes come as appropriate.
---
 QUICKSTART          |  1 +
 doc/assumptions.txt |  3 +++
 doc/variables.txt   | 18 +++++++++++++++++-
 features.in/README  |  2 +-
 lib/README          |  2 +-
 5 files changed, 23 insertions(+), 3 deletions(-)

diff --git a/QUICKSTART b/QUICKSTART
index 71a6dd48..ae03404e 100644
--- a/QUICKSTART
+++ b/QUICKSTART
@@ -21,6 +21,7 @@
 - от имени пользователя (после повторного входа):
 $ 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
diff --git a/doc/assumptions.txt b/doc/assumptions.txt
index 58e664bf..44cc6447 100644
--- a/doc/assumptions.txt
+++ b/doc/assumptions.txt
@@ -1,5 +1,8 @@
 предположения фрагментов кода об окружении
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+NB: пути приводятся от верхнего уровня
+
 - pkg.in/lists/Makefile
   + ожидает, что названия пакаджлистов указываются в переменных
     вида *_LISTS, и копирует в генерируемый профиль только их
diff --git a/doc/variables.txt b/doc/variables.txt
index 2db9681f..cf54dd8e 100644
--- a/doc/variables.txt
+++ b/doc/variables.txt
@@ -9,12 +9,18 @@
   + см. ../image.in/Makefile, apt.conf.sample
 
 - ARCH
-  + задаёт целевую архитектуру образа
+  + задаёт целевую архитектуру образов
   + значение: пусто (по умолчанию авто), i586 или x86_64
   + см. ../lib/build.mk
 
+- ARCHES
+  + задаёт набор целевых архитектур образов
+  + значение: пусто (по умолчанию авто) либо список через пробел
+  + см. ../Makefile
+
 - BELL
   + подаёт сигнал после завершения сборки
+  + значение: пусто (по умолчанию нет) либо любая строка
   + см. ../lib/build.mk
 
 - BUILDDIR
@@ -22,6 +28,16 @@
   + значение: пусто (по умолчанию авто) либо строка
   + см. ../lib/profile.mk
 
+- BUILDDIR_PREFIX
+  + задаёт префикс каталога генерируемого профиля и сборки
+  + значение: строка; по умолчанию выбирается алгоритмически
+  + см. ../main.mk
+
+- BUILDLOG
+  + задаёт путь к файлу журнала сборки/очистки
+  + значение: по умолчанию $(BUILDDIR)/build.log либо строка
+  + см. ../lib/log.mk
+
 - CHECK
   + включает режим проверки сборки конфигурации
   + значение: пусто (по умолчанию) либо любая строка
diff --git a/features.in/README b/features.in/README
index afc6f74f..4629e2f2 100644
--- a/features.in/README
+++ b/features.in/README
@@ -4,7 +4,7 @@
 
 Каждая фича должна содержать задействуемый при построении
 конфигурации будущего образа файл config.mk, включаемый
-в ../Makefile; он может описывать одну или более целей
+в ../main.mk; он может описывать одну или более целей
 вида use/*, дополняющих конфигурацию, и при наличии
 дополнительных хуков для копирования или generate.*
 обязан добавить имя фичи в $(FEATURES), для чего
diff --git a/lib/README b/lib/README
index b9fdffa2..e3074102 100644
--- a/lib/README
+++ b/lib/README
@@ -3,5 +3,5 @@
 конфигурации образа и генерации соответствующего
 профиля для сборки; см. тж. ../conf.d/.
 
-Следует помнить, что будучи включаемыми в ../Makefile,
+Следует помнить, что будучи включаемыми в ../main.mk,
 они работают в каталоге верхнего уровня.