1.1.51-alt1

- current updates

.gear/mkimage-profiles.spec

@@ -0,0 +1,431 @@
+Name: mkimage-profiles
+Version: 1.1.51
+Release: alt1
+
+Summary: ALT Linux based distribution metaprofile
+License: GPLv2+
+Group: Development/Other
+
+Url: http://altlinux.org/m-p
+Source: %name-%version.tar
+Packager: Michael Shigorin <mike@altlinux.org>
+
+BuildArch: noarch
+BuildRequires: rsync asciidoc-a2x xmlgraphics-fop fonts-ttf-dejavu
+
+Requires: rsync git-core
+Requires: time schedutils sfdisk
+Requires: mkimage >= 0.2.5
+Requires: mkimage-preinstall
+
+# Recommends: graphviz qemu-img
+
+%define mpdir %_datadir/%name
+%add_findreq_skiplist %mpdir/*.in/*
+
+%define docs $HOME/docs
+
+%package doc
+Summary: %name documentation
+Group: Development/Documentation
+BuildRequires: java /proc
+
+%description
+mkimage-profiles is a collection of bits and pieces useful for
+distributions construction: it contains package lists, features,
+and whole subprofiles (like "rescue" building block) for you
+to choose from, and some ready-made image recipes as well.
+
+Make no mistake: constructing distributions isn't just fun, it takes
+a lot of passion and knowledge to produce a non-trivial one.  So m-p
+(the short alias for mkimage-profiles) is complex too.  If you need
+-- or want -- to make just a few tweaks to an existing recipe, it might
+be easier to comprehend the generated profile (aka builddir) which
+contains only the needed subprofiles, script hooks and package lists
+and is way more compact.
+
+Virtual environment template caches (OpenVZ/LXC) can be made either.
+
+In short, setup hasher (http://en.altlinux.org/hasher) and here we go:
+  cd %mpdir
+  head README
+  make syslinux.iso
+
+But if you're into regular distro hacking and are not afraid of make
+and modest metaprogramming (some code generation and introspection),
+welcome to the metaprofile itself; read the docs and get the git:
+%url
+
+%description doc
+This package holds developer docs for %name
+as a book in HTML and PDF formats.
+
+%prep
+%setup
+
+%build
+make BUILDDIR=%docs docs
+
+%install
+mkdir -p %buildroot%mpdir
+cp -a * %buildroot%mpdir
+
+%files
+%mpdir/
+
+%files doc
+%doc README
+%doc QUICKSTART
+%doc %docs/*
+
+%changelog
+* Mon Nov 10 2014 Michael Shigorin <mike@altlinux.org> 1.1.51-alt1
+- current updates
+
+* Mon Oct 27 2014 Michael Shigorin <mike@altlinux.org> 1.1.50-alt1
+- minor tweaks
+
+* Mon Oct 13 2014 Michael Shigorin <mike@altlinux.org> 1.1.49-alt1
+- pkglist updates
+
+* Mon Sep 29 2014 Michael Shigorin <mike@altlinux.org> 1.1.48-alt1
+- (sysv)init: exclude systemd explicitly
+
+* Mon Sep 22 2014 Michael Shigorin <mike@altlinux.org> 1.1.47-alt1
+- kpackages() argswap
+
+* Mon Sep 15 2014 Michael Shigorin <mike@altlinux.org> 1.1.46-alt1
+- regular fixes
+
+* Mon Sep 01 2014 Michael Shigorin <mike@altlinux.org> 1.1.45-alt1
+- starterkits alpha
+
+* Mon Aug 18 2014 Michael Shigorin <mike@altlinux.org> 1.1.44-alt1
+- connman fixup
+
+* Mon Aug 04 2014 Michael Shigorin <mike@altlinux.org> 1.1.43-alt1
+- fixed package build
+
+* Mon Jul 28 2014 Michael Shigorin <mike@altlinux.org> 1.1.42-alt1
+- current bits
+
+* Mon Jul 07 2014 Michael Shigorin <mike@altlinux.org> 1.1.41-alt1
+- post-214 fixups
+
+* Mon Jun 30 2014 Michael Shigorin <mike@altlinux.org> 1.1.40-alt1
+- systemd-214
+
+* Mon Jun 16 2014 Michael Shigorin <mike@altlinux.org> 1.1.39-alt1
+- starterkits-20140612
+
+* Mon Jun 02 2014 Michael Shigorin <mike@altlinux.org> 1.1.38-alt1
+- mksquashfs 4.3 support
+
+* Mon May 26 2014 Michael Shigorin <mike@altlinux.org> 1.1.37-alt1
+- use/browser
+
+* Mon May 19 2014 Michael Shigorin <mike@altlinux.org> 1.1.36-alt1
+- regular-lxqt
+
+* Mon May 12 2014 Michael Shigorin <mike@altlinux.org> 1.1.35-alt1
+- yet another rescue week
+
+* Mon May 05 2014 Michael Shigorin <mike@altlinux.org> 1.1.34-alt1
+- remember Odessa
+
+* Mon Apr 28 2014 Michael Shigorin <mike@altlinux.org> 1.1.33-alt1
+- net-eth tweaks
+
+* Mon Apr 21 2014 Michael Shigorin <mike@altlinux.org> 1.1.32-alt1
+- regular-rescue week
+
+* Mon Apr 14 2014 Michael Shigorin <mike@altlinux.org> 1.1.31-alt1
+- live: refactoring
+- forensics mode
+
+* Mon Apr 07 2014 Michael Shigorin <mike@altlinux.org> 1.1.30-alt1
+- robotics support
+
+* Mon Mar 31 2014 Michael Shigorin <mike@altlinux.org> 1.1.29-alt1
+- mediacheck feature
+
+* Mon Mar 24 2014 Michael Shigorin <mike@altlinux.org> 1.1.28-alt1
+- install2: more cleanups
+
+* Mon Mar 17 2014 Michael Shigorin <mike@altlinux.org> 1.1.27-alt1
+- don't insist on k-m-r8168
+- codebase deduplication
+
+* Mon Mar 10 2014 Michael Shigorin <mike@altlinux.org> 1.1.26-alt1
+- docs week
+- deflogin: empty ROOTPW explicitly ignored (potential security fix)
+
+* Mon Mar 03 2014 Michael Shigorin <mike@altlinux.org> 1.1.25-alt1
+- regular updates
+
+* Mon Feb 10 2014 Michael Shigorin <mike@altlinux.org> 1.1.24-alt1
+- service bridge
+
+* Mon Feb 03 2014 Michael Shigorin <mike@altlinux.org> 1.1.23-alt1
+- live, net*, syslinux fixes (see also #26608)
+
+* Mon Jan 27 2014 Michael Shigorin <mike@altlinux.org> 1.1.22-alt1
+- ahci kludge (see #29705) :(
+
+* Mon Jan 20 2014 Michael Shigorin <mike@altlinux.org> 1.1.21-alt1
+- rescue tweaks
+
+* Mon Jan 13 2014 Michael Shigorin <mike@altlinux.org> 1.1.20-alt1
+- support for CIFS installation method (sin@)
+- glibc-locales for regular images (closes: #29693)
+
+* Mon Dec 30 2013 Michael Shigorin <mike@altlinux.org> 1.1.19-alt1
+- regular fixes
+
+* Mon Dec 23 2013 Michael Shigorin <mike@altlinux.org> 1.1.18-alt1
+- efi updates
+
+* Mon Dec 16 2013 Michael Shigorin <mike@altlinux.org> 1.1.17-alt1
+- refind branding
+
+* Mon Dec 09 2013 Michael Shigorin <mike@altlinux.org> 1.1.16-alt1
+- e18
+
+* Mon Dec 02 2013 Michael Shigorin <mike@altlinux.org> 1.1.15-alt1
+- regular fixups
+
+* Mon Nov 25 2013 Michael Shigorin <mike@altlinux.org> 1.1.14-alt1
+- important bugfix: THE_PACKAGES weren't getting through to .base
+- regular-sysv-tde related churn
+
+* Mon Nov 04 2013 Michael Shigorin <mike@altlinux.org> 1.1.13-alt1
+- rescue friday
+
+* Mon Oct 21 2013 Michael Shigorin <mike@altlinux.org> 1.1.12-alt1
+- live-builder update
+
+* Mon Oct 14 2013 Michael Shigorin <mike@altlinux.org> 1.1.11-alt1
+- luks better
+
+* Mon Sep 30 2013 Michael Shigorin <mike@altlinux.org> 1.1.10-alt1
+- regular tweaks
+
+* Mon Sep 23 2013 Michael Shigorin <mike@altlinux.org> 1.1.9-alt1
+- regular fixes
+
+* Mon Sep 16 2013 Michael Shigorin <mike@altlinux.org> 1.1.8-alt1
+- armh/p7/ve fixes
+
+* Mon Aug 26 2013 Michael Shigorin <mike@altlinux.org> 1.1.7-alt1
+- minor fixes
+
+* Mon Aug 12 2013 Michael Shigorin <mike@altlinux.org> 1.1.6-alt1
+- vm-net retired
+
+* Mon Aug 05 2013 Michael Shigorin <mike@altlinux.org> 1.1.5-alt1
+- armh related fixes
+
+* Mon Jul 29 2013 Michael Shigorin <mike@altlinux.org> 1.1.4-alt1
+- assorted fixups
+
+* Mon Jul 22 2013 Michael Shigorin <mike@altlinux.org> 1.1.3-alt1
+- armh fixes and tweaks
+
+* Mon Jul 15 2013 Michael Shigorin <mike@altlinux.org> 1.1.2-alt1
+- control and sound features
+
+* Mon Jul 01 2013 Michael Shigorin <mike@altlinux.org> 1.1.1-alt1
+- cuboxism
+
+* Mon Jun 17 2013 Michael Shigorin <mike@altlinux.org> 1.1.0-alt1
+- 1.1.x branch: public alpha development status
+  + new subprofile: rootfs
+  + new features: armh*, deflogin, init, services
+  + refactored features: build-*, efi, fonts, live, x11*
+  + tar2vm got rewritten as tar2fs, gained ARM support
+- minor spec metadata update
+
+* Mon Jun 17 2013 Michael Shigorin <mike@altlinux.org> 1.0.0-alt1
+- 1.0
+
+* Mon Jun 10 2013 Michael Shigorin <mike@altlinux.org> 0.9.16-alt1
+- 1.0pre
+
+* Mon May 27 2013 Michael Shigorin <mike@altlinux.org> 0.9.15-alt1
+- +installer
+
+* Mon May 20 2013 Michael Shigorin <mike@altlinux.org> 0.9.14-alt1
+- more regular fixes
+
+* Mon May 13 2013 Michael Shigorin <mike@altlinux.org> 0.9.13-alt1
+- regular fixes
+
+* Mon Apr 22 2013 Michael Shigorin <mike@altlinux.org> 0.9.12-alt1
+- four weeks later...
+
+* Mon Mar 25 2013 Michael Shigorin <mike@altlinux.org> 0.9.11-alt1
+- persistent icewm
+
+* Mon Mar 18 2013 Michael Shigorin <mike@altlinux.org> 0.9.10-alt1
+- fonts: axios!
+
+* Tue Feb 26 2013 Michael Shigorin <mike@altlinux.org> 0.9.9-alt1
+- regular refactoring
+
+* Tue Feb 19 2013 Michael Shigorin <mike@altlinux.org> 0.9.8.1-alt1
+- works with make-initrd 0.8.1+ (see #28578)
+
+* Mon Feb 18 2013 Michael Shigorin <mike@altlinux.org> 0.9.8-alt1
+- live fixes/tweaks galore
+
+* Mon Feb 11 2013 Michael Shigorin <mike@altlinux.org> 0.9.7-alt1
+- going nightly
+
+* Mon Feb 04 2013 Michael Shigorin <mike@altlinux.org> 0.9.6-alt1
+- assorted fixes
+
+* Mon Jan 21 2013 Michael Shigorin <mike@altlinux.org> 0.9.5-alt1
+- homeros
+
+* Mon Jan 14 2013 Michael Shigorin <mike@altlinux.org> 0.9.4-alt1
+- restricted boot
+
+* Mon Dec 31 2012 Michael Shigorin <mike@altlinux.org> 0.9.3-alt1
+- regular images
+
+* Mon Dec 17 2012 Michael Shigorin <mike@altlinux.org> 0.9.2-alt1
+- enhanced uefi support
+
+* Mon Dec 03 2012 Michael Shigorin <mike@altlinux.org> 0.9.1-alt1
+- initial kde4 support
+
+* Mon Nov 19 2012 Michael Shigorin <mike@altlinux.org> 0.9.0-alt1
+- initial uefi, luks, armh support
+- enhanced arm, gnome3/systemd, vm support
+
+* Sun Nov 11 2012 Michael Shigorin <mike@altlinux.org> 0.8.7-alt1
+- regressions--
+
+* Mon Nov 05 2012 Michael Shigorin <mike@altlinux.org> 0.8.6-alt1
+- docs subpackage (HTML/PDF book)
+
+* Mon Oct 29 2012 Michael Shigorin <mike@altlinux.org> 0.8.5-alt1
+- diffable logs
+- AMD APU support
+
+* Tue Oct 16 2012 Michael Shigorin <mike@altlinux.org> 0.8.4-alt1
+- worked around enhancements in current make-initrd-propagator
+  (thus fixed live image boot, finally)
+
+* Mon Oct 15 2012 Michael Shigorin <mike@altlinux.org> 0.8.3-alt1
+- make-3.82 support
+- fixed live image boot to some extent (see #27640, #27852)
+
+* Mon Sep 24 2012 Michael Shigorin <mike@altlinux.org> 0.8.2-alt1
+- fixed build with recent make-initrd-propagator
+
+* Mon Sep 03 2012 Michael Shigorin <mike@altlinux.org> 0.8.1-alt1
+- misc fixes
+
+* Mon Aug 13 2012 Michael Shigorin <mike@altlinux.org> 0.8.0-alt1
+- stage2@live
+
+* Mon Aug 06 2012 Michael Shigorin <mike@altlinux.org> 0.7.6-alt1
+- minor improvements
+
+* Mon Jul 30 2012 Michael Shigorin <mike@altlinux.org> 0.7.5-alt1
+- a bunch of fixups and cleanups
+
+* Mon Jul 16 2012 Michael Shigorin <mike@altlinux.org> 0.7.4-alt1
+- ppc builds
+
+* Mon Jul 09 2012 Michael Shigorin <mike@altlinux.org> 0.7.3-alt1
+- arm builds
+
+* Mon Jul 02 2012 Michael Shigorin <mike@altlinux.org> 0.7.2-alt1
+- simply fixes
+
+* Mon Jun 25 2012 Michael Shigorin <mike@altlinux.org> 0.7.1-alt1
+- vm improvements and assorted tweaks/fixes
+
+* Mon Jun 18 2012 Michael Shigorin <mike@altlinux.org> 0.7.0-alt1
+- new features:
+  + initial build-vm
+  + plymouth
+
+* Mon May 28 2012 Michael Shigorin <mike@altlinux.org> 0.6.8-alt1
+- minor bugfixes
+
+* Mon May 21 2012 Michael Shigorin <mike@altlinux.org> 0.6.7-alt1
+- docs updates
+
+* Mon May 14 2012 Michael Shigorin <mike@altlinux.org> 0.6.6-alt1
+- build helpers refactored
+- initial frontend support
+
+* Mon May 07 2012 Michael Shigorin <mike@altlinux.org> 0.6.5-alt1
+- branding feature
+
+* Mon Apr 23 2012 Michael Shigorin <mike@altlinux.org> 0.6.4-alt1
+- simply better (tm)
+
+* Mon Apr 09 2012 Michael Shigorin <mike@altlinux.org> 0.6.3-alt1
+- massive squashfs tuning
+
+* Mon Apr 02 2012 Michael Shigorin <mike@altlinux.org> 0.6.2-alt1
+- better live-webkiosk and initial live-flightgear
+- cleanup, syslinux, xorg feature tweaks
+
+* Mon Mar 26 2012 Michael Shigorin <mike@altlinux.org> 0.6.1-alt1
+- ISO9660 metadata support
+- initial alien VE image
+
+* Mon Mar 19 2012 Michael Shigorin <mike@altlinux.org> 0.6.0-alt1
+- reports (targets graph)
+
+* Mon Mar 12 2012 Michael Shigorin <mike@altlinux.org> 0.5.7-alt1
+- distro tweaks
+
+* Mon Feb 20 2012 Michael Shigorin <mike@altlinux.org> 0.5.6-alt1
+- minor fixups
+
+* Mon Feb 06 2012 Michael Shigorin <mike@altlinux.org> 0.5.5-alt1
+- live-related tweaks (including live.hooks support)
+- terminal server and webkiosk images
+
+* Mon Jan 16 2012 Michael Shigorin <mike@altlinux.org> 0.5.4-alt1
+- better diags for initial deployment
+
+* Mon Jan 02 2012 Michael Shigorin <mike@altlinux.org> 0.5.3-alt1
+- multi-target, multi-arch, single-job builds
+
+* Mon Dec 19 2011 Michael Shigorin <mike@altlinux.org> 0.5.2-alt1
+- THE_{KMODULES,PACKAGES,LISTS,GROUPS}
+- incremental development, refactoring and bugfixing
+
+* Fri Dec 02 2011 Michael Shigorin <mike@altlinux.org> 0.5.1-alt1
+- generic VE archive type (added cpio and xz either)
+- minor additions/fixes
+
+* Mon Nov 21 2011 Michael Shigorin <mike@altlinux.org> 0.5.0-alt1
+- add_feature for autoregistration (simple but invasive)
+- added features: isomd5sum, repo, systemd
+- changed features: powerbutton -> power
+
+* Tue Nov 08 2011 Michael Shigorin <mike@altlinux.org> 0.4.3.2-alt1
+- mkimage version required/checked
+
+* Mon Nov 07 2011 Michael Shigorin <mike@altlinux.org> 0.4.3.1-alt1
+- CLEAN by default unless DEBUG
+
+* Mon Nov 07 2011 Michael Shigorin <mike@altlinux.org> 0.4.3-alt2
+- include %mpdir/ itself as well
+
+* Mon Nov 07 2011 Michael Shigorin <mike@altlinux.org> 0.4.3-alt1
+- enhancements to logging
+- NICE variable: employ nice(1) and ionice(1) if available
+- features.in/syslinux: banner tweaked to include target name
+- features.in/live: set up unicode locale/consolefont
+
+* Wed Nov 02 2011 Michael Shigorin <mike@altlinux.org> 0.4.2-alt1
+- initial package

.gear/rules

@@ -0,0 +1,2 @@
+spec: .gear/mkimage-profiles.spec
+tar: v@version@:.

.gear/tags/9873ef00763476e979b938961f22c0e65d4e2c97

@@ -0,0 +1,6 @@
+object 3261d946336eea5546f83b400331e703227e1b0f
+type commit
+tag v1.1.50
+tagger Michael Shigorin <mike@altlinux.org> 1414443321 +0300
+
+tweaks

.gear/tags/list

@@ -0,0 +1 @@
+9873ef00763476e979b938961f22c0e65d4e2c97 v1.1.50

Makefile

@@ -1,45 +1,73 @@
-# steps to build a distribution image:
-# --- here
-# 1. initialize new profile (BUILDDIR) as a copy of image.in/
-# 2. configure distro
-# 3. copy subprofiles, script hooks, and package lists/groups
-#    from metaprofile to new profile (as needed)
-# --- in BUILDDIR
-# 4. build subprofiles and subsequently the image
+# umbrella mkimage-profiles makefile:
+# iterate over multiple goals/arches,
+# collect proceedings
 
-all help:
-	@echo '** available distribution targets:'
-	@echo $(IMAGES) | fmt -sw"$$((COLUMNS>>1))" | column -t
+# preferences
+-include $(HOME)/.mkimage/profiles.mk
 
-# most of the actual work done elsewhere
-include clean.mk
-include profile.mk
-include distro.mk
-include log.mk
-include iso.mk
+# for immediate assignment
+ifndef ARCH
+ARCH := $(shell arch \
+	| sed 's/i686/i586/; s/armv7.*/armh/; s/armv.*/arm/; s/ppc.*/ppc/')
+endif
 
-# we can't use implicit rules for top-level targets, only for prereqs
-# NB: what about static pattern rules?
-# TODO: move into libdistro?
-DISTROS := $(shell sed -n 's,^distro/\([^:.]\+\):.*$$,\1,p' distro.mk)
-IMAGES := $(addsuffix .iso,$(DISTROS))
+ifndef ARCHES
+ARCHES := $(ARCH)
+endif
 
-# to be passed into distcfg.mk
-IMAGEDIR ?= $(shell [ -d "$$HOME/out" -a -w "$$HOME/out" ] \
-	&& echo "$$HOME/out" \
-	|| echo "$(BUILDDIR)/out" )
-IMAGENAME ?= mkimage-profiles-$(ARCH).iso
+export ARCHES ARCH
 
-$(IMAGES): %.iso: | profile/init distro/% boot/isolinux profile/populate iso
-	@# TODO: run automated tests (e.g. iso size)
-	@OUTNAME="$(@:.iso=)-$(DATE)-$(ARCH).iso"; \
-	 OUTPATH="$(IMAGEDIR)/$$OUTNAME"; \
-		test -s "$(IMAGEDIR)/$(IMAGENAME)" && \
-		mv "$(IMAGEDIR)/$(IMAGENAME)" "$$OUTPATH" && \
-		echo "** image: $$OUTPATH" && \
-		ln -sf "$$OUTNAME" "$(IMAGEDIR)/$@" && \
-		ln -sf "$@" "$(IMAGEDIR)/mkimage-profiles.iso"; \
-		if [ -n "$(DEBUG)" ]; then \
-			cp -a "$(BUILDLOG)" "$$OUTPATH.log"; \
-			cp -a "$(CONFIG)" "$$OUTPATH.cfg"; \
-		fi
+export PATH := $(CURDIR)/bin:$(PATH)
+
+# supervise target tracing; leave stderr alone
+ifdef REPORT
+export REPORT_PATH := $(shell mktemp --tmpdir mkimage-profiles.report.XXXXXXX)
+POSTPROC := | report-filter > $(REPORT_PATH)
+endif
+
+# recursive make considered useful for m-p
+MAKE += -r --no-print-directory
+
+DIRECT_TARGETS := help help/distro help/ve help/vm clean distclean check
+.PHONY: $(DIRECT_TARGETS)
+
+# these build nothing so no use of reports either
+$(DIRECT_TARGETS):
+	@$(MAKE) -f main.mk REPORT= $@
+
+export NUM_TARGETS := $(words $(MAKECMDGOALS))
+
+# for pipefail
+SHELL = /bin/bash
+
+# don't even consider remaking a configuration file
+.PHONY: $(HOME)/.mkimage/profiles.mk
+
+# real targets need real work
+%:
+	@n=1; \
+	set -o pipefail; \
+	say() { echo "$$@" >&2; }; \
+	if [ "$(NUM_TARGETS)" -gt 1 ]; then \
+		n="`echo $(MAKECMDGOALS) \
+		| tr '[[:space:]]' '\n' \
+		| grep -nx "$@" \
+		| cut -d: -f1`"; \
+		say "** goal: $@ [$$n/$(NUM_TARGETS)]"; \
+	fi; \
+	for ARCH in $(ARCHES); do \
+		if [ "$$ARCH" != "$(firstword $(ARCHES))" ]; then say; fi; \
+		say "** ARCH: $$ARCH"; \
+		if $(MAKE) -f main.mk ARCH=$$ARCH $@ $(POSTPROC); then \
+			if [ -n "$$REPORT" ]; then \
+				$(MAKE) -f reports.mk ARCH=$$ARCH; \
+			fi; \
+		fi; \
+	done; \
+	if [ "$$n" -lt "$(NUM_TARGETS)" ]; then say; fi
+
+docs:
+	@$(MAKE) -C doc
+
+docs-publish:
+	@$(MAKE) -C doc publish

QUICKSTART

@@ -0,0 +1,54 @@
+English quickstart: make syslinux.iso (after setting up
+http://en.altlinux.org/Hasher; large tmpfs helps a lot).
+
+требуется
+~~~~~~~~~
+- ALT Linux 6.0 или выше (возможна адаптация "вниз")
+- установленный mkimage (свежий, как и hasher)
+- пользователь с правом запуска hasher
+
+полезно
+~~~~~~~
+- смонтированный tmpfs на несколько гигабайт
+  * например, в /tmp или /home/USER/hasher
+  * каталог из prefix в /etc/hasher-priv/system
+- установленный git-core
+- настроенный ~/.gitconfig
+
+команды
+~~~~~~~
+от имени root::
+----
+# apt-get install mkimage mkimage-preinstall hasher git-core
+# hasher-useradd USER
+----
+
+от имени указанного пользователя (после повторного входа)::
+----
+$ git config --global user.email "my@email"
+$ git config --global user.name "My Name"
+$ mkdir -p ~/out ~/tmp
+----
+
+тестовая сборка::
+----
+$ make syslinux.iso
+----
+
+список доступных целей::
+----
+$ make help
+----
+
+переменные, влияющие на результат (подробнее в doc/params.txt)::
+---
+$ make ARCH=i586 APTCONF=~/apt/apt.conf.i586 REPORT=1 ve/generic.tar
+---
+
+ссылки
+~~~~~~
+- http://www.altlinux.org/tmpfs
+- http://www.altlinux.org/hasher
+- http://www.altlinux.org/mkimage
+- http://www.altlinux.org/m-p
+- http://www.altlinux.org/m-p-howto ("как поправить под себя")

README

@@ -1,70 +1,79 @@
-see also http://www.altlinux.org/Mkimage/Profiles/next
+== Welcome to m-p! ==
 
-quickstart: make server-base.iso
-(NB: requires configured http://en.altlinux.org/Hasher)
+*Brief summary*
 
-configurables: ~/.mkimage/profiles.mk,
-see doc/profiles.mk.sample and libdistro.mk
+  Configurables: ~/.mkimage/profiles.mk;
+  see doc/params.txt and conf.d/README
 
-license: GPLv2+, see COPYING
+  License: GPLv2+, see COPYING
+
+  Most docs are in Russian, welcome to learn it or ask for English.
+
+Задача:
+
+* конфигурирование и создание образов на базе ALT Linux
 
 Концепция:
-- метапрофиль служит репозиторием для построения индивидуального
-  профиля, по которому создаётся итоговый дистрибутив
-- для одноразовых модификаций можно подправить сгенерированный
-  профиль, для долгосрочной разработки стоит вливать правки
-  в метапрофиль (что требует больше навыков и времени)
+
+* конфигурация, как и образ -- объект постадийной сборки
+* метапрофиль служит репозиторием для построения индивидуального
+  профиля, по которому создаётся итоговый образ
 
 Особенности:
-- метапрофиль может быть полностью read-only при сборке
-- для сборки подыскивается предпочтительно tmpfs
-- в профиль копируются только нужные объекты;
+
+* метапрофиль при сборке может быть доступен только на чтение
+* для сборки подыскивается предпочтительно tmpfs
+* в профиль копируются только нужные объекты;
   он автономен относительно метапрофиля
 
 Стадии работы:
-- инициализация дистрибутивного профиля
-- сборка конфигурации дистрибутива
-- наполнение дистрибутивного профиля
-- сборка дистрибутива
+
+* инициализация сборочного профиля
+* сборка конфигурации образа
+* наполнение сборочного профиля
+* сборка образа
 
 Объекты:
-- дистрибутивы:
-  + описываются в distro.mk
-  + могут основываться один на другом
-  + включают один или более субпрофилей по надобности
-  + желательно избегать множественного наследования, см. тж. фичи
-- субпрофили:
-  + список собирается в $(SUBPROFILES)
-  + базовые комплекты помещены в подкаталогах под sub.in/;
-    их наборы скриптов могут расширяться фичами
-    - stage1: propagator, ядро инсталятора и initrd в т.ч. с firmware
-    - stage2: базовый live-образ (и модули ядра, соответствующие stage1);
-      используется только с модификаторами (см. соответствующие фичи):
-      + stage2/install2: инсталятор
-      + stage2/live: LiveCD
-      + stage2/rescue: спасательная система
-    - main: пакетная база к инсталяции (обязательная и дополнительная)
-- фичи:
-  + список собирается в $(FEATURES)
-  + законченные блоки функциональности (или наборы таковых)
-  + описываются в индивидуальных features.in/*/config.mk
-  + могут зависеть друг от друга и требовать субпрофили
-  + при сборке $(BUILDDIR) содержимое указанных в $(FEATURES) фич
-    (подкаталоги, соответствующие входящим в дистрибутив субпрофилям
-    под их итоговыми названиями -- например, live, а не stage2/live) 
-    добавляется в профиль; затем выполняются generate.sh, generate.mk
-- списки пакетов (*_LISTS): просьба по возможности избегать дублирования
-  NB: перечисленные в этих переменных файлы автоматически копируются
-  в порождаемый профиль => не следует указывать пакаджлисты напрямую
-- индивидуальные пакеты (*_PACKAGES): следует крайне осторожно пользоваться
-  COMMON_PACKAGES -- эти пакеты попадут во все стадии, в том числе в образ
-  чувствительной к объёму install2 (в stage1 -- только в инструментальный
-  чрут); применяйте для того, что обязано быть и в инсталяторе, и в готовой
-  системе
+
+* дистрибутивы и виртуальные среды/машины:
+** описываются в conf.d/*.mk
+** могут основываться на предшественниках, расширяя их
+** дистрибутивы также включают один или более субпрофилей по надобности
+** желательно избегать множественного наследования, см. тж. фичи
+* субпрофили:
+** список собирается в $(SUBPROFILES)
+** базовые комплекты помещены в подкаталогах под sub.in/;
+   их наборы скриптов могут расширяться фичами
+* фичи:
+** законченные блоки функциональности (или наборы таковых)
+** описываются в индивидуальных features.in/*/config.mk
+** могут требовать другие фичи, а также субпрофили
+** накопительный список собирается в $(FEATURES)
+** при сборке $(BUILDDIR) содержимое фич добавляется в профиль
+* списки пакетов (*_LISTS):
+** просьба по возможности избегать дублирования (см. bin/pkgdups)
+* индивидуальные пакеты (*_PACKAGES): см. тж. conf.d/README
 
 Результат:
-- при успешном завершении сборки образ называется сообразно
-  дистрибутиву и укладывается в $(IMAGEDIR):
-  + указанный явно,
-  + либо ~/out/ (если возможно),
-  + или $(BUILDDIR)/out/ иначе
+
+* при успешном завершении сборки образ называется по имени цели
+  и укладывается в $(IMAGEDIR):
+** указанный явно,
+** либо ~/out/ (если возможно),
+** или $(BUILDDIR)/out/ иначе
+* формируются отчёты, если запрошены (REPORT)
+
+См. тж.:
+
+* http://altlinux.org/m-p: обзорная документация, в т.ч. howto
+* doc/:
+** params.txt: переменные, указываемые при запуске сборки
+** pkglists.txt: формирование состава образа
+** features.txt: обзор подключаемых особенностей
+
+Примечание: пути в документации задаются от каталога верхнего уровня,
+если не указаны как относительные в явном виде (./) или по смыслу.
+
+Удачи; что не так -- пишите.
+
+Michael Shigorin <mike@altlinux.org>

bin/columnize

@@ -0,0 +1,36 @@
+#!/bin/bash
+# columnize.sh
+# Take a list of values and output them in a nicely formatted column view.
+# Author: Loïc Cattani "Arko" <loic cattani at gmail com>
+# https://github.com/Arko/Columnize
+
+values=($*)
+longest_value=0
+
+# Find the longest value
+for value in ${values[@]}; do
+	if [[ ${#value} -gt $longest_value ]]; then
+		longest_value=${#value}
+	fi
+done
+
+# Compute column span
+term_width=${COLUMNS:-$(tput cols)}
+(( columns = $term_width / ($longest_value + 2) ))
+
+# Print values with pretty column width
+curr_col=0
+for value in ${values[@]}; do
+	value_len=${#value}
+	echo -n $value
+	(( spaces_missing = $longest_value - $value_len + 2 ))
+	printf "%*s" $spaces_missing
+	(( curr_col++ ))
+	if [[ $curr_col == $columns ]]; then
+		echo
+		curr_col=0
+	fi
+done
+
+# Make sure there is a newline at the end
+if [[ $curr_col != 0 ]]; then echo; fi

bin/mktmpdir

@@ -1,20 +1,53 @@
 #!/bin/sh
 # analyze free space, preferring tmpfs over really many gigaz
+# and taking into account configured hasher workdir prefices
 
 # hope there aren't spaces in RM's $HOME are they?
-DIRS="$TMP $TMPDIR $HOME/hasher /tmp /var/tmp"
-MINSIZE=1048576		# face control criterion
+DIRS="$TMP $TMPDIR $HOME/hasher /tmp /var/tmp .."
+MINSIZE=262144		# face control criterion
 
-# pick existing, writeable, >1Gb free space dirs
+# poor man's SourceIfExists()
+try_source() { [ -f "$1" ] && . "$1"; }
+
+# hasher accepted ones
+get_prefices()
+{
+	try_source /etc/hasher-priv/system || exit 1
+	try_source `/usr/libexec/hasher-priv/getconf.sh`
+	echo "$prefix" | tr ':' '\n' | while read i; do realpath "$i"; done
+}
+
+# drop candidates that hasher won't handle anyways
+# NB: doesn't take --number into account,
+# prefix lists are defined by the primary configuration
+contemplate_dirs()
+{
+	for d in "$@"; do
+		D="`realpath "$d"`";
+		for p in `get_prefices`; do
+			[ "${D#$p}" = "$D" ] || echo "$D";
+		done;
+	done \
+	| uniq	# _not_ sort -u
+}
+
+# hasher emits no meaningful errors regarding those, sigh
+check_options()
+{
+	! egrep -q "^$1 $2 .*no(dev|exec)" /proc/mounts
+}
+
+# pick existing, writeable, >256M free space dirs
 # rank them wrt type: tmpfs > realfs > rootfs
 choose_tmpdir() {
-	for i in $DIRS; do
+	for i in "$@"; do
 		[ -d "$i" -a -w "$i" ] || continue
 		echo -n "$i "
-		df -Tl "$i" | tail -1
+		df -PT "$i" | tail -1
 	done \
 	| sort -unk6 \
 	| while read dir dev fstype size used free percent mnt; do
+		check_options "$dev" "$mnt" || continue
 		[ "$free" -gt "$MINSIZE" ] || continue
 		[ "$fstype" = "tmpfs" ] && { echo "2 $dir $free"; continue; }
 		[ "$mnt" = "/" ] && { echo "0 $dir $free"; continue; }
@@ -25,5 +58,24 @@ choose_tmpdir() {
 	| cut -f2 -d' '
 }
 
-DIR="`choose_tmpdir`"
-mktemp -d "${1:-tmpdir}.XXXXXXXXXX" --tmpdir="${DIR:-..}"
+# bringing it all together
+TMPDIRS="`contemplate_dirs $DIRS`"
+if [ -z "$TMPDIRS" ]; then
+	echo "error: no suitable directories found;"
+	echo "please check QUICKSTART, filesystem and hasher setup"
+	echo "(mount enough tmpfs into /tmp or fix hasher-priv prefix?)"
+	exit 1
+fi >&2
+
+TEMP="`choose_tmpdir $TMPDIRS`"
+if [ -z "$TEMP" ]; then
+	echo "error: no suitable directories found;"
+	echo "please check hasher docs and filesystem setup"
+	echo "(nodev and/or noexec on an otherwise suitable filesystem?)"
+	exit 1
+fi >&2
+
+DIR="$TEMP/`dirname "$1"`"
+NAME="`basename "${1:-tmpdir}"`"
+mkdir -p "$DIR"	# in case $1 contains slash(es)
+mktemp -d "$NAME.XXXXXXX" --tmpdir="${DIR%/.}"

bin/mp-commit

@@ -0,0 +1,27 @@
+#!/bin/sh
+# commit the directory ($1) with a message ($2) to git
+
+. shell-error
+
+INIT=
+if [ "$1" = "-i" ]; then
+	INIT=yes
+	shift
+fi
+
+[ -d "$1" ] || fatal "$1 is not an existing directory"
+
+if type -t git >&/dev/null && pushd "$1" >/dev/null; then
+	if [ -z "$(git config --global user.name)" ]; then
+		exit 0
+	fi
+	if [ -n "$INIT" -a ! -d .git ]; then
+		git init -q || fatal "git init failed"
+	fi
+	if [ -n "$(git status -s)" ]; then
+		git add . \
+		&& git commit -qam "$2" \
+		|| fatal "git add/commit failed"
+	fi
+	popd >/dev/null
+fi

bin/mp-showref

@@ -0,0 +1,11 @@
+#!/bin/sh
+# report on git repo in the current directory
+
+if type -t git >&/dev/null; then
+	if pushd "$1" >/dev/null && [ -d .git ]; then
+		git show-ref --head -ds -- HEAD
+		git status -s
+		echo
+		popd >/dev/null
+	fi
+fi

bin/pkgdups

@@ -0,0 +1,20 @@
+#!/bin/sh
+# a script to help weed out duplicate packages
+# contained in package lists given as arguments
+#
+# Requires: libshell
+
+. /bin/shell-quote
+
+sort "$@" \
+| grep -v '^ *#' \
+| sed  -s 's,[ 	]\+, ,g' \
+| grep -v '^ *$' \
+| uniq -cd \
+| while read num str; do
+	echo -n "$str: $num ";
+	pattern="`quote_sed_regexp "$str"`"
+	grep -l "^$pattern$" "$@" | tr '\n' ' '
+	echo
+done \
+| sort -rn -t: -k2

bin/report-filter

@@ -0,0 +1,4 @@
+#!/bin/sh
+# filter worker make stdout for report scripts
+
+grep '^trace:building ' | uniq

bin/report-targets

@@ -0,0 +1,33 @@
+#!/bin/sh
+
+echo "digraph {"
+echo "  { node [fontname=Helvetica,fontsize=20];"
+
+while read first second third rest; do
+	FROM=; TO=
+	case "$first" in
+	"trace:building")
+		case "$third" in
+		"->")
+			FROM="$second"; TO="$rest";;
+		*)
+			continue;;
+		esac
+		;;
+	*)
+		continue;;
+	esac
+	[ -n "$FROM" -a -n "$TO" ] || continue
+	for to in $TO; do
+		out="  \"$FROM\" -> \"$to\""
+		case $to in
+		*distro/*|*vm/*)
+			echo "$out [weight=10];";;
+		*)
+			echo "$out";;
+		esac
+	done
+done
+
+echo "  }"
+echo "}"

bin/report-targets2vars

@@ -0,0 +1,52 @@
+#!/bin/sh
+
+DISTCFG=build/distcfg.mk
+[ -s "$DISTCFG" ] || exit 1
+
+VARIABLES=
+
+echo "graph { rankdir=LR;"
+echo "  { node [height=.1,width=.3,fontname=Helvetica,fontsize=10];"
+
+feat_vars()
+{
+FEATURE=
+	while read first second rest; do
+		case "$first" in
+		\#[A-Z]*)
+			continue;;	# overridden feature
+		\#)			# feature mark
+			case "$second" in
+			profile/*)
+				FEATURE=;;
+			*)
+				FEATURE="$second";;
+			esac
+			;;
+		*)
+			case "$second" in
+			=|+=|?=)
+				case "$first" in
+				DISTCFG_MK|SUBPROFILES|FEATURES|IMAGE*|MKIMAGE_*)
+					continue;;
+				*)
+					VAR="$first"
+					VARIABLES="$VARIABLES; $VAR"
+					;;
+				esac
+				;;
+			*)
+				continue;;
+			esac
+			;;
+		esac
+		[ -n "$FEATURE" -a -n "$VAR" ] || continue
+		echo "  \"$FEATURE\" -- \"$VAR\";"
+	done < "$DISTCFG"
+	echo "  { node [shape=box]$VARIABLES; }"
+}
+
+feat_vars | LC_COLLATE=C sort -ru
+
+echo "  }"
+echo "}"

bin/tags2lists

@@ -29,4 +29,8 @@ transformed="$(sed \
 	-e "s, *( *, ( ,g" \
 	-e "s, *) *, ) ,g")"
 
-[ -z "$transformed" ] || find $transformed | sed 's,^\./,,'
+[ "$DEBUG" = 2 ] && echo "`basename $0`: transformed = \"$transformed\"" >&2
+[ -z "$transformed" ] ||
+	find $transformed \
+	| sed 's,^\./,,' \
+	| egrep -v '(\.sw.|~)$'

bin/tar2fs

@@ -0,0 +1,247 @@
+#!/bin/bash -ex
+# usage:
+# tar2fs chroot.tar image.raw [size_in_bytes [fstype]]
+
+. shell-error
+
+if [ $# -lt 2 ]; then
+	fatal "error: tar2fs needs at least two arguments"
+fi
+
+# this needs env_keep sudo setup to actually work
+if [ -n "$GLOBAL_BUILDDIR" ]; then
+	WORKDIR="$GLOBAL_BUILDDIR/vmroot"
+else
+	WORKDIR="$(mktemp --tmpdir -d vmroot-XXXXX)"
+fi
+
+[ -n "$WORKDIR" ] || fatal "couldn't come up with suitable WORKDIR"
+
+[ -n "$GLOBAL_DEBUG" ] || message "WORKDIR: $WORKDIR"
+
+MB=1048576		# a parted's "megabyte" in bytes is *broken*
+
+SIZE_FACTOR=2		# multiply the sizes found by this value
+BOOT_SIZE_FACTOR=2	# multiply /boot size by this value additionally
+
+CUR_BOUNDARY=0		# align first partition at 1MB for performance (+1)
+
+INITRD_MODULES=
+BOOTFSTYPE=
+BOOTPART=
+
+case "`arch`" in	# NB: sudo => no GLOBAL_ will do either; mind qemu-*
+*86*)
+	# NB: different storage modules might be needed for non-kvm
+	INITRD_MODULES="sd_mod ata_piix"
+	BLOCKDEV="/dev/sda"	# might be /dev/vda for virtio
+	ROOTPART="1"
+	;;
+arm*)
+	BOOTFSTYPE="ext2"	# support expected in every sane target uboot
+	BLOCKDEV="/dev/mmcblk0p"	# ...hopefully...
+	BOOTPART="1"
+	ROOTPART="2"
+	;;
+esac
+
+# figure out the part taken by /boot in the given tarball
+boot_size() {
+	if [ -n "$BOOTPART" ]; then
+		tar tvf "$1" \
+		| awk ' \
+			BEGIN { sum=0 }
+			/^-.* \.\/boot\// { sum=sum+$3 }
+			END { print sum }'
+	else
+		echo "0"
+	fi
+}
+
+# parted wrapper for convenience
+parting() { parted "$LOOPDEV" --align optimal --script -- "$@"; }
+
+# unfortunately parted is insane enough to lump alignment controls
+# into unit controls so creating adjacent partitions sized in MiB
+# is not as straightforward as it might be... thus "+1" padding;
+# see also http://www.gnu.org/software/parted/manual/parted.html#unit
+mkpart() {
+	# a bit different start/end semantics to handle end of device too
+	local start="$(($CUR_BOUNDARY + 1))"	# yes, we lose a megabyte
+	if [ -n "$1" ]; then
+		CUR_BOUNDARY="$(($start + $1))"
+		local end="$CUR_BOUNDARY"MiB
+	else
+		local end="-1s"	# last sector of the image
+	fi
+	parting mkpart primary ext2 "$start"MiB "$end"
+}
+
+# a tarball containing chroot with a kernel
+TAR="$1"
+[ -s "$TAR" ] || fatal "source tarball doesn't really exist"
+
+# a path to the image to be generated
+IMG="$2"
+[ -d "$(dirname "$IMG")" ] || fatal "target directory doesn't exist"
+
+# 0 means auto; if a value is specified it holds (no /boot subtracted)
+ROOTSIZE="$3"
+[ -n "$ROOTSIZE" -a "$ROOTSIZE" != 0 ] || unset ROOTSIZE
+
+# image size in bytes
+TARSIZE="$(stat -Lc %s "$TAR")"
+# /boot size in that tarball
+BOOTSIZE="$(boot_size "$TAR")"
+DEFSIZE="$(($SIZE_FACTOR * ($TARSIZE - $BOOTSIZE)))"	# (exact sizes)
+ROOTSIZE="$((${ROOTSIZE:-$DEFSIZE} + $MB - 1))"	# for ceil rounding to MB
+# image and /boot sizes in megabytes
+ROOTSIZEM="$(($ROOTSIZE / $MB))"
+BOOTSIZEM="$((($SIZE_FACTOR * $BOOT_SIZE_FACTOR * $BOOTSIZE + $MB - 1) / $MB))"
+
+# tested to work: ext[234], jfs
+# NB: xfs doesn't have a spare sector for the bootloader
+ROOTFSTYPE="${4:-ext4}"
+
+# single root partition hardwired so far,
+# add another image for home/data/swap if needed
+ROOTDEV="$BLOCKDEV$ROOTPART"
+
+# last preparations...
+MKFS="mkfs.$ROOTFSTYPE ${BOOTFSTYPE:+mkfs.$BOOTFSTYPE}"
+for i in losetup sfdisk parted kpartx $MKFS; do
+	if ! type -t "$i" >&/dev/null; then
+		fatal "$i required but not found in host system"
+	fi
+done
+
+LOOPDEV="$(losetup --find)"	# would be sad about non-binary megabytes too
+ROOTFS="$WORKDIR/chroot"
+
+BOOTFS=
+if [ -n "$BOOTPART" ]; then
+	BOOTFS="$ROOTFS/boot"
+fi
+
+exit_handler() {
+	rc=$?
+	if [ -n "$ROOTFS" ]; then
+		umount ${BOOTFS:+"$BOOTFS"} "$ROOTFS"{/dev,/proc,/sys,}
+
+		if [ -n "$LOOPDEV" ]; then
+			kpartx -d "$LOOPDEV"
+			losetup --detach "$LOOPDEV"
+		fi
+		rm -r -- "$ROOTFS"
+		rmdir -- "$WORKDIR"
+	fi
+	exit $rc
+}
+
+# handle -e in shebang as well
+trap exit_handler EXIT ERR
+
+# prepare disk image and a filesystem inside it
+rm -f -- "$IMG"
+OFFSET="$(($CUR_BOUNDARY + $BOOTSIZEM + $ROOTSIZEM - 1))"
+dd if=/dev/zero of="$IMG" conv=notrunc bs=$MB count=1 seek="$OFFSET"
+losetup "$LOOPDEV" "$IMG"
+
+parting mklabel msdos
+
+if [ -n "$BOOTPART" ]; then
+	BOOTDEV="$BLOCKDEV$BOOTPART"
+	mkpart "$BOOTSIZEM"
+fi
+
+# not ROOTSIZEM but "the rest"; somewhat non-trivial arithmetics lurk in parted
+mkpart
+
+kpartx -a -s "$LOOPDEV"
+LOOPROOT="/dev/mapper/$(basename "$LOOPDEV")p$ROOTPART"
+
+mkfs."$ROOTFSTYPE" "$LOOPROOT"
+
+if [ -n "$BOOTPART" ]; then
+	LOOPBOOT="/dev/mapper/$(basename "$LOOPDEV")p$BOOTPART"
+	mkfs."$BOOTFSTYPE" "$LOOPBOOT"
+fi
+
+ROOTUUID="$(blkid -s UUID -o value -c /dev/null "$LOOPROOT")"
+if [ -n "$ROOTUUID" ]; then
+       ROOTDEV="UUID=$ROOTUUID"
+else
+       ROOTDEV="$LOOPROOT"
+fi
+
+if [ -n "$BOOTPART" ]; then
+	BOOTUUID="$(blkid -s UUID -o value -c /dev/null "$LOOPBOOT")"
+	if [ -n "$ROOTUUID" ]; then
+		BOOTDEV="UUID=$BOOTUUID"
+	fi
+fi
+
+# mount and populate it
+mkdir -pm755 "$ROOTFS"
+mount "$LOOPROOT" "$ROOTFS"
+
+if [ -n "$BOOTPART" ]; then
+	mkdir -pm700 "$BOOTFS"
+	mount "$LOOPBOOT" "$BOOTFS"
+fi
+
+tar -C "$ROOTFS" --numeric-owner -xf "$TAR"
+for i in /dev /proc /sys; do mount --bind "$i" "$ROOTFS$i"; done
+
+# loop device so lilo could work...
+echo "$ROOTDEV / $ROOTFSTYPE relatime 1 1" >> "$ROOTFS/etc/fstab"
+
+# target device at once
+if [ -n "$BOOTPART" ]; then
+	echo "$BOOTDEV /boot $BOOTFSTYPE defaults 1 2" >> "$ROOTFS/etc/fstab"
+fi
+
+echo "MODULES_PRELOAD += $INITRD_MODULES $ROOTFSTYPE" >> "$ROOTFS/etc/initrd.mk"
+
+KERNEL="$(readlink $ROOTFS/boot/vmlinuz | sed 's,vmlinuz-,,')"
+chroot "$ROOTFS" make-initrd -k "$KERNEL"
+
+# ...target device too
+sed -i "s,$LOOPROOT,$ROOTDEV," "$ROOTFS/etc/fstab"
+
+if [ -x /sbin/lilo ]; then
+	# configure and install bootloader
+	REGEXP='^Disk .*: ([0-9]+) cylinders, ([0-9]+) heads, ([0-9]+) sectors/track*$'
+	set -- $(sfdisk -l "$LOOPDEV" | grep -E "$REGEXP" | sed -r "s@$REGEXP@\1 \2 \3@")
+
+	LILO_COMMON="lba32
+delay=1
+vga=0
+image=/boot/vmlinuz
+  initrd=/boot/initrd.img
+  append=\"root=$ROOTDEV rootdelay=3 quiet\"
+  label=linux"
+
+	cat > "$ROOTFS"/etc/lilo-loop.conf <<-EOF
+	boot=$LOOPDEV
+	disk=$LOOPDEV
+	  bios=0x80
+	  cylinders=$1
+	  heads=$2
+	  sectors=$3
+	  partition=$LOOPROOT
+	  start=63
+	$LILO_COMMON
+	EOF
+
+	chroot "$ROOTFS" lilo -C /etc/lilo-loop.conf
+
+	cat > "$ROOTFS"/etc/lilo.conf <<-EOF
+	boot=$BLOCKDEV
+	$LILO_COMMON
+	EOF
+fi
+
+if [ -n "$SUDO_USER" ]; then
+	chown "$SUDO_USER" "$IMG" "$ROOTFS" "$WORKDIR"
+fi

clean.mk

@@ -1,32 +0,0 @@
-# this makefile can be used standalone
-
-# drop stock predefined rules
-.DEFAULT:
-
-# tmpfs-sparing extra rule: cleanup workdir after completing each stage
-# (as packed results are saved this only lowers RAM pressure)
-ifdef CLEAN
-export GLOBAL_CLEAN_WORKDIR = clean-current
-ifdef DEBUG
-WARNING = (both CLEAN and DEBUG defined, debug options will be limited)
-endif
-endif
-
-# ordinary clean: destroys workdirs but not the corresponding results
-clean:
-	@echo '** cleaning up $(WARNING)'
-	@find -name '*~' -delete >&/dev/null
-	@if [ -L build -a -d build/ ]; then \
-		$(MAKE) -C build $@ GLOBAL_BUILDDIR=$(shell readlink build) $(LOG); \
-	fi
-
-# there can be some sense in writing log here even if normally
-# $(BUILDDIR)/ gets purged: make might have failed,
-# and BUILDLOG can be specified by hand either
-distclean: clean
-	@if [ -L build -a -d build/ ]; then \
-		rm -rf build/.git; \
-		$(MAKE) -C build $@ GLOBAL_BUILDDIR=$(shell readlink build) $(LOG) && \
-		rm -r $(shell readlink build); \
-	fi
-	@rm -f build

conf.d/README

@@ -0,0 +1,68 @@
+== conf.d ==
+
+Этот каталог содержит включаемые фрагменты конфигурации образов с тем,
+чтобы было удобнее параллельно разрабатывать специфические образы
+без излишних merge conflict'ов.
+
+Следует понимать, что основная цель появления mkimage-profiles на свет
+-- это уменьшение "форков" внутри семейства дистрибутивных профилей.
+Поэтому при возможности следует всё-таки работать над общей базовой
+частью, включая скриптовые хуки и списки пакетов, а также оптимизировать
+граф зависимостей между конфигурациями образов.
+
+Попросту говоря, copy-paste -- тревожный признак.
+
+Вместо него нередко может помочь выделение кусочков конфигурации
+в пределах включаемого файла в цели mixin/*, которые не являются
+самостоятельными или даже промежуточными, но включают полезные
+группы настроек, нужных в различных образах, не наследующих
+друг другу -- посмотрите существующие примеры использования.
+
+По переменным (см. тж. doc/pkglists.txt):
+
+* для пользовательского окружения (live, main) предназначены
+  THE_PACKAGES, THE_LISTS, THE_GROUPS, THE_PACKAGES_REGEXP
+
+* для "обычного общего" (live, main, rescue) есть COMMON_PACKAGES
+  (NB: тоже попадают в базовую установку)
+
+* SYSTEM_PACKAGES стоит применять крайне осторожно -- эти пакеты попадут
+  во все стадии, в том числе в образ чувствительной к объёму install2
+  (в stage1 -- только в инструментальный чрут); применяйте для того,
+  что обязано быть и в инсталяторе, и в готовой системе
+
+* для направленного действия служат:
+** 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)
+** BASE_KMODULES попадут в установку по умолчанию
+** MAIN_KMODULES будут доступны для установки с носителя
+** LIVE_KMODULES предназначены для LiveCD/LiveFlash
+
+Не стоит бояться такого разнообразия, для большинства задач достаточно THE_*.
+
+По подстановкам:
+
+* $(VAR) подставляются перед их записью в $(CONFIG), который distcfg.mk
+* $$(VAR) раскрываются позже, при включении $(CONFIG) и востребовании
+  значений; в этом случае их значения могут изменяться до окончания
+  конфигурации, а также зависеть от значений других переменных
+
+По спискам пакетов:
+
+* на этапе экспериментирования можно забивать прямо в описание образа
+* при фиксации состояния стоит воспользоваться существующими списками,
+  а дополнительные оформить как можно более чётко обособленными по тем
+  задачам, для решения которых они и подобраны
+* повторяющиеся логически связанные группы списков может иметь смысл
+  выделить в фичу (см., например, power или x11)
+* если явной фичи не наблюдается, но у группы дистрибутивов намечается
+  заметная общая часть -- её можно выделить в промежуточную цель вида
+  distro/.name, не являющуюся самостоятельно собираемой

conf.d/armh.mk

@@ -0,0 +1,93 @@
+ifeq (armh,$(ARCH))
+
+ifeq (ve,$(IMAGE_CLASS))
+
+# aliases for autobuild
+ve/regular-nexus7-e17: ve/nexus7-e17; @:
+ve/regular-nexus7-kde4: ve/nexus7-kde4; @:
+ve/altlinux-p7-nexus7-e17: ve/nexus7-e17; @:
+ve/altlinux-p7-nexus7-kde4: ve/nexus7-kde4; @:
+
+ve/.tegra3-base: ve/.base use/armh use/kernel
+	@$(call add,BASE_PACKAGES,nvidia-tegra)
+
+ve/.tegra3-tablet: ve/.tegra3-base use/armh-tegra3 +pulse
+	@$(call add,BASE_LISTS,$(call tags,base tablet))
+
+ve/.nexus7-tablet: ve/.tegra3-tablet use/armh-nexus7 \
+	use/x11-autologin use/deflogin/altlinuxroot
+	@$(call set,KFLAVOURS,grouper)	# fits tilapia just fine
+	@$(call set,BRANDING,altlinux-kdesktop)	### the only suitable so far
+	@$(call add,BASE_PACKAGES,mkinitrd)     ### rootsubdir support
+	@$(call add,BASE_PACKAGES,firmware-nexus7)
+	@$(call add,BASE_PACKAGES,livecd-ru)	### until l10n is there
+
+ve/nexus7-e17: ve/.nexus7-tablet use/x11/e17 use/x11/lightdm/gtk; @:
+
+ve/nexus7-kde4: ve/.nexus7-tablet use/x11/lightdm/kde +systemd +pulse +nm
+	@$(call add,BASE_LISTS,$(call tags,base kde4mobile))
+
+ve/nexus7-xfce: ve/.nexus7-tablet use/x11/xfce use/x11/lightdm/gtk +systemd
+	@$(call add,BASE_PACKAGES,florence at-spi2-atk)
+
+endif
+
+ifeq (vm,$(IMAGE_CLASS))
+
+# NB: early dependency on use/kernel is on intent
+vm/.arm-base: profile/bare use/kernel use/net-eth/dhcp use/net-ssh; @:
+	@$(call add,BASE_PACKAGES,interactivesystem e2fsprogs)
+	@$(call add,BASE_PACKAGES,apt)
+	@$(call add,BASE_PACKAGES,mkinitrd uboot-tools)
+	@$(call set,BRANDING,altlinux-kdesktop)
+
+vm/.cubox-bare: vm/.arm-base use/armh-cubox use/net-ssh use/repo use/tty/S0
+	@$(call add,BASE_PACKAGES,glibc-locales vim-console rsync)
+
+vm/.cubox-desktop: vm/.cubox-bare use/armh-dovefb +systemd +pulse \
+	use/armh-cubox use/branding use/xdg-user-dirs/deep \
+	use/fonts/otf/adobe use/fonts/ttf/redhat use/fonts/ttf/ubuntu
+	@$(call set,BRANDING,altlinux-kdesktop)
+	@$(call add,THE_BRANDING,alterator graphics indexhtml menu notes)
+	@$(call add,BASE_PACKAGES,parole gst-ffmpeg gst-plugins-vmeta)
+	@$(call add,BASE_PACKAGES,gst-plugins-good gst-plugins-nice)
+	@$(call add,BASE_PACKAGES,gst-plugins-bad gst-plugins-ugly)
+	@$(call add,BASE_PACKAGES,LibreOffice4-full LibreOffice4-langpack-ru)
+	@$(call add,BASE_LISTS,$(call tags,(base || desktop) && regular))
+
+vm/cubox-xfce-ru: vm/.cubox-desktop use/deflogin/altlinuxroot \
+	use/slinux/arm use/x11/lightdm/gtk use/x11-autologin +nm
+	@$(call add,BASE_PACKAGES,livecd-ru)
+
+# these images use a kind of OEM setup
+vm/.cubox-oem: vm/.cubox-desktop use/oem; @:
+
+vm/.cubox-gtk: vm/.cubox-oem use/x11/lightdm/gtk +nm; @:
+
+vm/cubox-xfce: vm/.cubox-gtk \
+	use/slinux/arm use/net-usershares use/domain-client; @:
+
+vm/cubox-mate: vm/.cubox-gtk use/x11/mate; @:
+	@$(call set,BRANDING,altlinux-centaurus)
+	@$(call add,THE_BRANDING,mate-settings)
+
+vm/cubox-tde: vm/.cubox-oem use/net-eth/dhcp use/x11-autostart +tde
+	@$(call add,BASE_LISTS,openscada)
+
+vm/cubox-kde4: vm/.cubox-oem use/x11/kde4 use/x11/kdm4 use/fonts/zerg +pulse
+	@$(call add,BASE_LISTS,$(call tags,desktop && kde4 && !extra))
+
+vm/cubox-server: vm/.cubox-bare use/deflogin/altlinuxroot use/control/sudo-su \
+	+sysvinit
+	@$(call set,BRANDING,altlinux-centaurus)
+	@$(call add,BASE_PACKAGES,agetty fdisk)
+	@$(call add,BASE_LISTS,$(call tags,base security))
+
+vm/arm-server: vm/.arm-base use/net-eth/dhcp use/cleanup/installer +sysvinit
+	@$(call set,KFLAVOURS,armadaxp)
+	@$(call add,BASE_PACKAGES,agetty)
+	@$(call add,BASE_LISTS,$(call tags,extra (server || network)))
+
+endif
+
+endif

conf.d/desktop.mk

@@ -0,0 +1,30 @@
+# desktop distributions
+ifeq (distro,$(IMAGE_CLASS))
+
+distro/.desktop-base: distro/.installer use/syslinux/ui/vesamenu use/x11/xorg
+	@$(call set,INSTALLER,desktop)
+
+distro/.desktop-mini: distro/.desktop-base use/x11/xdm +power; @:
+
+mixin/desktop-installer: use/x11-autostart use/sound +net-eth +vmguest
+	@$(call add,SYSTEM_PACKAGES,fonts-ttf-google-croscore-arimo)
+	@$(call add,BASE_LISTS, \
+		$(call tags,(base || desktop) && (l10n || network)))
+	@$(call add,INSTALL2_PACKAGES,ntfs-3g)
+	@$(call add,BASE_PACKAGES,os-prober)
+
+distro/.desktop-network: distro/.desktop-mini mixin/desktop-installer; @:
+
+distro/.desktop-extra:
+	@$(call add,BASE_LISTS,$(call tags,(archive || base) && (extra)))
+
+distro/kde4-lite: distro/.desktop-mini \
+	distro/.desktop-network distro/.desktop-extra +kde4-lite
+	@$(call set,KFLAVOURS,std-def)
+
+distro/tde: distro/.desktop-network +tde; @:
+distro/icewm: distro/.desktop-network use/lowmem use/install2/fs +icewm; @:
+distro/ltsp-tde: distro/tde +ltsp; @:
+distro/ltsp-icewm: distro/icewm +ltsp; @:
+
+endif

conf.d/homeros.mk

@@ -0,0 +1,6 @@
+ifeq (distro,$(IMAGE_CLASS))
+
+distro/homeros-mini: distro/.live-base use/live/textinstall \
+	use/homeros use/speech/en use/isohybrid; @:
+
+endif

conf.d/live.mk

@@ -0,0 +1,108 @@
+# live images
+ifeq (distro,$(IMAGE_CLASS))
+
+distro/dos: distro/.init use/dos use/syslinux/ui/menu; @:
+
+distro/rescue: distro/.base use/rescue use/syslinux/ui/menu \
+	use/efi/signed use/efi/refind use/efi/shell; @:
+
+distro/syslinux: distro/.init \
+	use/syslinux/localboot.cfg use/syslinux/ui/vesamenu use/hdt; @:
+
+distro/.live-base: distro/.base use/live/base use/power/acpi/button; @:
+distro/.live-x11: distro/.live-base use/live/x11; @:
+
+distro/.live-desktop: distro/.base +live use/live/install use/stage2/net-eth \
+	use/plymouth/live; @:
+distro/.live-desktop-ru: distro/.live-desktop use/live/ru; @:
+
+distro/.live-kiosk: distro/.base use/live/base use/live/autologin \
+	use/syslinux/timeout/1 use/cleanup use/stage2/net-eth \
+	use/fonts/otf/adobe +power
+	@$(call add,CLEANUP_PACKAGES,'alterator*' 'guile*' 'vim-common')
+
+distro/live-builder-mini: distro/.live-base use/dev/mkimage use/dev \
+	use/stage2/net-eth use/net-eth/dhcp use/syslinux/timeout/30 \
+	use/isohybrid
+	@$(call set,KFLAVOURS,$(BIGRAM))
+	@$(call add,LIVE_LISTS,\
+		$(call tags,(base || live) && (server || builder)))
+	@$(call add,LIVE_PACKAGES,livecd-qemu-arch strace)
+	@$(call add,LIVE_PACKAGES,qemu-user-binfmt_misc)
+	@$(call add,LIVE_PACKAGES,zsh sudo)
+
+distro/live-builder: distro/live-builder-mini \
+	use/efi/signed use/live/rw use/live/repo use/dev/repo
+	@$(call add,MAIN_LISTS,$(call tags,live builder))
+	@$(call add,MAIN_PACKAGES,syslinux pciids memtest86+ mkisofs)
+
+distro/live-install: distro/.live-base use/live/textinstall; @:
+distro/.livecd-install: distro/.live-base use/live/install; @:
+
+distro/live-icewm: distro/.live-desktop use/x11/lightdm/gtk +icewm; @:
+distro/live-razorqt: distro/.live-desktop +razorqt; @:
+distro/live-tde: distro/.live-desktop-ru use/live/install +tde; @:
+distro/live-fvwm: distro/.live-desktop-ru use/x11/lightdm/gtk use/x11/fvwm; @:
+
+distro/live-rescue: distro/live-icewm +efi
+	@$(call add,LIVE_LISTS,$(call tags,rescue && (fs || live || x11)))
+	@$(call add,LIVE_LISTS,openssh \
+		$(call tags,(base || extra) && (archive || rescue || network)))
+
+# NB: this one doesn't include the browser, needs to be chosen downstream
+distro/.live-webkiosk: distro/.live-kiosk use/live/hooks use/live/ru use/sound
+	@$(call add,LIVE_LISTS,$(call tags,live desktop))
+
+distro/.live-webkiosk-gtk: distro/.live-webkiosk
+	@$(call add,CLEANUP_PACKAGES,'libqt4*' 'qt4*')
+
+distro/live-webkiosk-mini: distro/.live-webkiosk-gtk \
+	use/fonts/otf/mozilla use/isohybrid
+	@$(call add,LIVE_PACKAGES,livecd-webkiosk-firefox)
+
+# NB: flash/java plugins are predictable security holes
+distro/live-webkiosk-flash: distro/live-webkiosk-mini use/plymouth/live \
+	use/browser/plugin/flash use/browser/plugin/java use/efi/signed \
+	+vmguest; @:
+
+distro/live-webkiosk: distro/live-webkiosk-mini use/live/desktop; @:
+
+distro/live-webkiosk-chromium: distro/.live-webkiosk use/fonts/ttf/google
+	@$(call add,LIVE_PACKAGES,livecd-webkiosk-chromium)
+
+distro/live-webkiosk-seamonkey: distro/.live-webkiosk use/fonts/ttf/google
+	@$(call add,LIVE_PACKAGES,livecd-webkiosk-seamonkey)
+
+distro/live-webkiosk-qupzilla: distro/.live-webkiosk use/fonts/otf/mozilla
+	@$(call add,LIVE_PACKAGES,livecd-webkiosk-qupzilla)
+
+distro/.live-3d: distro/.live-x11 use/x11/3d \
+	use/x11/lightdm/gtk +icewm +sysvinit
+	@$(call add,LIVE_PACKAGES,glxgears glxinfo)
+
+distro/live-glxgears: distro/.live-3d; @:
+
+distro/live-flightgear: distro/.live-kiosk use/x11/3d use/sound \
+	use/stage2/net-eth use/net-eth/dhcp use/services +efi +sysvinit
+	@$(call set,KFLAVOURS,un-def)
+	@$(call add,LIVE_LISTS,$(call tags,xorg misc))
+	@$(call add,LIVE_PACKAGES,FlightGear FlightGear-tu154b)
+	@$(call add,LIVE_PACKAGES,fgo input-utils livecd-fgfs)
+	@$(call add,LIVE_PACKAGES,glxgears glxinfo)
+	@$(call add,DEFAULT_SERVICES_DISABLE,rpcbind alteratord messagebus)
+	@$(call add,SERVICES_DISABLE,livecd-net-eth)
+	@$(call try,HOMEPAGE,http://www.4p8.com/eric.brasseur/flight_simulator_tutorial.html)
+
+distro/live-e17: distro/.live-desktop-ru use/x11/e17 use/x11/lightdm/gtk; @:
+
+distro/live-gimp: distro/live-icewm use/live/ru
+	@$(call add,LIVE_PACKAGES,gimp tintii immix fim)
+	@$(call add,LIVE_PACKAGES,sane sane-frontends xsane)
+	@$(call add,LIVE_PACKAGES,darktable geeqie rawstudio ufraw)
+	@$(call add,LIVE_PACKAGES,macrofusion python-module-pygtk-libglade)
+	@$(call add,LIVE_PACKAGES,qtfm openssh-clients rsync usbutils)
+	@$(call add,LIVE_PACKAGES,design-graphics-sisyphus2)
+
+distro/live-robo: distro/live-icewm +robotics use/live/ru; @:
+
+endif

conf.d/p7.mk

@@ -0,0 +1,41 @@
+# p7 base kits
+
+mixin/p7:
+	@$(call set,BRANDING,altlinux-starterkit)
+
+ifeq (distro,$(IMAGE_CLASS))
+
+### kludge compatibility: introspection stub for main.mk :-/
+distro/altlinux-p7-cinnamon: distro/regular-cinnamon mixin/p7; @:
+distro/altlinux-p7-e17: distro/regular-e17 mixin/p7; @:
+distro/altlinux-p7-icewm: distro/regular-icewm mixin/p7; @:
+distro/altlinux-p7-gnome3: distro/regular-gnome3 mixin/p7; @:
+distro/altlinux-p7-gnustep: distro/regular-gnustep mixin/p7; @:
+distro/altlinux-p7-kde4: distro/regular-kde4 mixin/p7; @:
+distro/altlinux-p7-lxde: distro/regular-lxde mixin/p7; @:
+distro/altlinux-p7-lxqt: distro/regular-lxqt mixin/p7; @:
+distro/altlinux-p7-lxqt-sysv: distro/regular-lxqt-sysv mixin/p7; @:
+distro/altlinux-p7-mate: distro/regular-mate mixin/p7; @:
+distro/altlinux-p7-razorqt: distro/regular-razorqt mixin/p7; @:
+distro/altlinux-p7-rescue: distro/regular-rescue mixin/p7; @:
+distro/altlinux-p7-tde: distro/regular-tde mixin/p7; @:
+distro/altlinux-p7-tde-sysv: distro/regular-tde-sysv mixin/p7; @:
+distro/altlinux-p7-wmaker: distro/regular-wmaker mixin/p7; @:
+distro/altlinux-p7-xfce: distro/regular-xfce mixin/p7; @:
+
+distro/altlinux-p7-sysv-tde: distro/regular-sysv-tde mixin/p7; @:
+
+distro/altlinux-p7-jeos: distro/regular-jeos mixin/p7; @:
+distro/altlinux-p7-server: distro/regular-server mixin/p7; @:
+distro/altlinux-p7-server-ovz: distro/regular-server-ovz mixin/p7; @:
+distro/altlinux-p7-server-hyperv: distro/regular-server-hyperv mixin/p7; @:
+
+endif
+
+ifeq (ve,$(IMAGE_CLASS))
+ve/altlinux-p7-ovz-generic: ve/generic mixin/p7; @:
+endif
+
+ifeq (vm,$(IMAGE_CLASS))
+vm/altlinux-p7-vm-net: vm/net mixin/p7; @:
+endif

conf.d/regular.mk

@@ -0,0 +1,207 @@
+# regular build/usage images
+ifeq (distro,$(IMAGE_CLASS))
+
+# common ground
+distro/.regular-bare: distro/.base +wireless +net-eth \
+	use/efi/signed use/memtest use/kernel/net
+	@$(call try,SAVE_PROFILE,yes)
+
+# graphical target (not enforcing xorg drivers or blobs)
+distro/.regular-x11: distro/.regular-bare use/x11/wacom +vmguest \
+	use/live/x11 use/live/install use/live/repo use/live/rw \
+	use/luks use/branding use/browser/firefox/live use/browser/firefox/i18n
+	@$(call add,LIVE_LISTS,$(call tags,(base || desktop) && regular))
+	@$(call add,LIVE_LISTS,$(call tags,base rescue))
+	@$(call add,LIVE_PACKAGES,gpm livecd-install-apt-cache)
+	@$(call add,DEFAULT_SERVICES_ENABLE,gpm)
+
+# common WM live/installer bits
+mixin/regular-desktop: use/x11/xorg use/sound use/xdg-user-dirs
+	@$(call add,THE_PACKAGES,installer-feature-desktop-other-fs-stage2)
+	@$(call add,THE_PACKAGES,alterator-notes)
+	@$(call add,THE_BRANDING,alterator graphics indexhtml notes)
+
+# WM base target
+distro/.regular-base: distro/.regular-x11 mixin/regular-desktop
+
+# DE base target
+# TODO: use/plymouth/live when luks+plymouth is done, see also #28255
+distro/.regular-desktop: distro/.regular-base \
+	use/syslinux/ui/gfxboot use/firmware/laptop use/efi/refind +systemd
+	@$(call add,LIVE_LISTS,domain-client)
+	@$(call add,THE_BRANDING,bootloader)
+	@$(call add,DEFAULT_SERVICES_DISABLE,gssd idmapd krb5kdc rpcbind)
+	@$(call set,KFLAVOURS,std-def)
+
+distro/.regular-gtk: distro/.regular-desktop use/x11/lightdm/gtk +plymouth; @:
+distro/.regular-sysv: distro/.regular-base +sysvinit; @:
+distro/.regular-sysv-gtk: distro/.regular-sysv use/syslinux/ui/gfxboot \
+	use/x11/gdm2.20; @:
+
+distro/.regular-install: distro/.regular-bare +installer +sysvinit +power \
+	use/branding use/bootloader/grub use/luks \
+	use/install2/fs use/install2/vnc use/install2/repo
+	@$(call add,THE_LISTS,$(call tags,base regular))
+	@$(call add,INSTALL2_BRANDING,alterator notes)
+	@$(call add,THE_BRANDING,alterator)
+
+# NB:
+# - no +power or even use/power/acpi/button on intent
+# - stock cleanup is not enough (or installer-common-stage3 deps soaring)
+distro/regular-jeos: distro/.base use/isohybrid +sysvinit +net-eth \
+	use/install2/packages use/install2/vmguest use/vmguest/base \
+	use/branding use/bootloader/lilo use/syslinux/lateboot.cfg \
+	use/install2/cleanup/everything use/install2/cleanup/kernel/everything \
+	use/cleanup/x11-alterator use/net use/kernel/net use/power/acpi/button
+	@$(call set,KFLAVOURS,led-ws)	# led-vs might be nice here
+	@$(call add,BASE_KMODULES,guest scsi vboxguest)
+	@$(call set,INSTALLER,altlinux-generic)
+	@$(call add,INSTALL2_BRANDING,alterator notes)
+	@$(call add,THE_BRANDING,alterator) # just to be cleaned up later on
+	@$(call add,THE_PACKAGES,apt basesystem dhcpcd openssh vim-console)
+	@# a *lot* of stray things get pulled in by alterator modules
+	@$(call add,CLEANUP_PACKAGES,libICE 'libX*' libxcb libfreetype)
+	@$(call add,CLEANUP_PACKAGES,fontconfig 'glib2*' libffi 'libltdl*')
+	@$(call add,CLEANUP_PACKAGES,liblcms libjpeg 'libpng*' 'libtiff*')
+	@$(call add,CLEANUP_PACKAGES,avahi-autoipd bridge-utils) # i-c-stage3
+	@$(call add,CLEANUP_PACKAGES,iw wpa_supplicant)
+	@$(call add,CLEANUP_PACKAGES,openssl libpcsclite)
+	@# fully fledged interactivesystem isn't needed here either
+	@$(call add,CLEANUP_PACKAGES,interactivesystem 'groff*' man stmpclean)
+	@$(call add,CLEANUP_PACKAGES,glibc-gconv-modules gettext)
+	@$(call add,CLEANUP_PACKAGES,console-scripts console-vt-tools 'kbd*')
+	@$(call add,CLEANUP_PACKAGES,libsystemd-journal libsystemd-login)
+	@$(call add,CLEANUP_PACKAGES,dbus libdbus libcap-ng)
+
+distro/.regular-install-x11: distro/.regular-install \
+	mixin/regular-desktop +vmguest
+	@$(call set,INSTALLER,altlinux-desktop)
+	@$(call add,THE_LISTS,$(call tags,regular desktop))
+
+distro/regular-icewm: distro/.regular-sysv-gtk +icewm \
+	use/browser/seamonkey/i18n use/fonts/ttf/redhat
+	@$(call add,LIVE_LISTS,$(call tags,regular icewm))
+	@$(call add,LIVE_PACKAGES,gparted mnt)
+	@$(call set,KFLAVOURS,un-def)
+
+mixin/regular-wmaker: use/efi/refind use/syslinux/ui/gfxboot use/x11/wmaker
+	@$(call add,LIVE_PACKAGES,livecd-install-wmaker)
+	@$(call add,LIVE_PACKAGES,installer-feature-no-xconsole-stage3)
+	@$(call add,MAIN_PACKAGES,wmgtemp wmhdaps wmpomme wmxkbru xxkb)
+
+# wdm can't do autologin so add standalone one for livecd
+distro/regular-wmaker: distro/.regular-sysv \
+	mixin/regular-wmaker use/live/autologin use/browser/seamonkey/i18n
+	@$(call add,LIVE_PACKAGES,wdm)
+	@$(call set,KFLAVOURS,led-ws)
+
+# gdm2.20 can reboot/halt with both sysvinit and systemd, and is slim
+mixin/regular-gnustep: use/x11/gnustep use/x11/gdm2.20 use/mediacheck \
+	use/browser/firefox/classic +plymouth
+	@$(call add,THE_BRANDING,graphics)
+
+distro/regular-gnustep: distro/.regular-sysv \
+	mixin/regular-wmaker mixin/regular-gnustep; @:
+distro/regular-gnustep-systemd: distro/.regular-base +systemd \
+	mixin/regular-wmaker mixin/regular-gnustep; @:
+
+distro/regular-xfce: distro/.regular-gtk \
+	use/x11/xfce use/domain-client/full use/browser/firefox/classic \
+	use/x11/gtk/nm +nm; @:
+
+distro/regular-lxde: distro/.regular-gtk use/x11/lxde use/fonts/infinality \
+	use/x11/gtk/nm +nm
+	@$(call add,LIVE_LISTS,$(call tags,desktop gvfs))
+
+distro/regular-xmonad: distro/.regular-gtk use/x11/xmonad
+	@$(call add,LIVE_PACKAGES,livecd-regular-xmonad)
+
+distro/regular-mate: distro/.regular-gtk +nm \
+	use/x11/mate use/fonts/ttf/google use/domain-client/full
+	@$(call add,LIVE_LISTS,$(call tags,mobile mate))
+
+distro/regular-e17: distro/.regular-gtk use/x11/e17 use/fonts/infinality; @:
+distro/regular-e19: distro/.regular-gtk use/x11/e19 use/fonts/infinality; @:
+distro/regular-e19-sysv: distro/.regular-sysv-gtk use/x11/e19; @:
+
+distro/regular-cinnamon: distro/.regular-gtk \
+	use/x11/cinnamon use/fonts/infinality use/net/nm/mmgui
+	@$(call set,META_VOL_ID,ALT Linux $(IMAGE_NAME)) # see also #28271
+	@$(call set,KFLAVOURS,un-def)
+
+# not .regular-gtk due to gdm vs lightdm
+distro/regular-gnome3: distro/.regular-desktop \
+	use/x11/gnome3 use/browser/epiphany +plymouth +nm
+	@$(call add,LIVE_PACKAGES,livecd-gnome3-nosetup)
+
+# reusable bits
+mixin/regular-tde: use/syslinux/ui/gfxboot use/browser/firefox/classic \
+	+tde +plymouth
+	@$(call add,THE_PACKAGES,kdeedu)
+	@$(call add,THE_LISTS,openscada)
+
+distro/regular-tde: distro/.regular-desktop mixin/regular-tde \
+	use/x11/gtk/nm use/net/nm/mmgui; @:
+
+distro/regular-tde-sysv: distro/.regular-sysv mixin/regular-tde \
+	use/net-eth/dhcp use/efi/refind; @:
+
+distro/regular-kde4: distro/.regular-desktop use/x11/kde4/nm use/x11/kdm4 \
+	use/browser/konqueror4 use/fonts/zerg use/domain-client/full \
+	use/net/nm/mmgui +pulse +plymouth
+	@$(call add,LIVE_LISTS,$(call tags,regular kde4))
+	@$(call add,LIVE_PACKAGES,rosa-imagewriter)
+	@$(call add,DEFAULT_SERVICES_ENABLE,prefdm)
+
+distro/regular-razorqt: distro/.regular-desktop +razorqt +plymouth; @:
+
+mixin/regular-lxqt: use/x11/lxqt use/x11/lightdm/lxqt \
+	use/browser/qupzilla +plymouth; @:
+
+distro/regular-lxqt: distro/.regular-desktop mixin/regular-lxqt +nm; @:
+
+distro/regular-lxqt-sysv: distro/.regular-sysv mixin/regular-lxqt \
+	use/net-eth/dhcp use/efi/refind; @:
+
+distro/regular-sugar: distro/.regular-gtk use/x11/sugar; @:
+
+# NB: never ever use/syslinux/ui/gfxboot here as gfxboot mangles
+#     kernel cmdline resulting in method:disk instead of method:cdrom
+#     which will change propagator's behaviour to probe additional
+#     filesystems (ro but no loop) thus potentially writing to
+#     an unrecovered filesystem's journal
+distro/regular-rescue: distro/.regular-bare use/rescue/rw use/luks \
+	use/branding use/efi/refind use/efi/shell use/efi/memtest86 \
+	use/hdt use/syslinux/ui/menu use/syslinux/rescue_fm.cfg \
+	use/syslinux/timeout/200 use/mediacheck test/rescue/no-x11
+	@$(call set,KFLAVOURS,un-def)
+	@$(call add,RESCUE_PACKAGES,gpm)
+
+distro/regular-sysv-tde: distro/.regular-install-x11 \
+	mixin/desktop-installer mixin/regular-tde \
+	use/branding/complete use/branding/slideshow/once \
+	use/net-eth/dhcp use/efi/refind use/efi/shell use/rescue/base \
+	use/fonts/otf/adobe use/fonts/otf/mozilla
+	@$(call set,KFLAVOURS,led-ws)
+	@$(call add,RESCUE_LISTS,$(call tags,rescue misc))
+	@$(call add,THE_LISTS,$(call tags,base desktop))
+	@$(call add,THE_LISTS,$(call tags,regular tde))
+	@$(call add,MAIN_PACKAGES,man-whatis usb-modeswitch)
+
+distro/regular-server: distro/.regular-install use/server/mini use/rescue/base
+	@$(call add,THE_LISTS,$(call tags,regular server))
+	@$(call add,MAIN_PACKAGES,aptitude)
+	@$(call set,INSTALLER,altlinux-server)
+
+distro/regular-server-ovz: distro/regular-server \
+	use/server/ovz use/server/groups/base; @:
+
+distro/regular-server-hyperv: distro/regular-server
+	@$(call set,KFLAVOURS,un-def)
+	@$(call add,THE_PACKAGES,hyperv-daemons)
+	@$(call add,THE_PACKAGES,alterator-fbi)
+	@$(call add,THE_LISTS,$(call tags,server alterator))
+	@$(call add,DEFAULT_SERVICES_DISABLE,ahttpd alteratord)
+	@$(call add,DEFAULT_SERVICES_DISABLE,bridge cpufreq-simple)
+
+endif

conf.d/server.mk

@@ -0,0 +1,24 @@
+# server distributions
+ifeq (distro,$(IMAGE_CLASS))
+
+distro/.server-base: distro/.installer use/syslinux/ui/menu use/memtest \
+	use/cleanup/x11-alterator
+	@$(call add,BASE_LISTS,server-base openssh)
+
+distro/server-nano: distro/.server-base use/bootloader/lilo +power \
+	use/install2/cleanup/crypto use/install2/cleanup/vnc
+	@$(call add,BASE_LISTS,$(call tags,server network))
+	@$(call add,BASE_PACKAGES,dhcpcd cpio)
+
+distro/server-mini: distro/.server-base +net-eth \
+	use/server/mini use/kernel/net use/efi use/power/acpi/button
+	@$(call set,INSTALLER,altlinux-server)
+	@$(call add,BASE_PACKAGES,make-initrd-mdadm make-initrd-lvm)
+
+distro/server-ovz: distro/server-mini use/server/ovz use/server/groups/base \
+	use/install2/net use/hdt use/rescue \
+	use/firmware/server use/firmware/cpu +wireless; @:
+
+distro/server-zabbix: distro/server-mini use/server/zabbix; @:
+
+endif

conf.d/simply.mk

@@ -0,0 +1,12 @@
+# simply images
+
+ifeq (distro,$(IMAGE_CLASS))
+
+distro/live-simply: distro/.livecd-install use/slinux/full
+	@$(call add,THE_LISTS,slinux/live-install)
+
+distro/simply: distro/.installer use/slinux/full
+	@$(call set,INSTALLER,simply-linux)
+	@$(call add,INSTALL2_PACKAGES,sysvinit)
+
+endif

conf.d/t7.mk

@@ -0,0 +1,13 @@
+# t7 base kits
+
+mixin/t7:
+	@$(call set,BRANDING,altlinux-starterkit) ### needs changing
+
+ifeq (distro,$(IMAGE_CLASS))
+
+distro/altlinux-t7-gnustep: distro/regular-gnustep mixin/t7; @:
+distro/altlinux-t7-gnustep-systemd: distro/regular-gnustep-systemd mixin/t7; @:
+distro/altlinux-t7-tde: distro/regular-tde mixin/t7; @:
+distro/altlinux-t7-sysv-tde: distro/regular-sysv-tde mixin/t7; @:
+
+endif

conf.d/test.mk

@@ -0,0 +1,102 @@
+# debug/test/experimental images
+ifneq (,$(DEBUG))
+
+ifeq (distro,$(IMAGE_CLASS))
+
+distro/syslinux-auto: distro/.init use/hdt use/syslinux/timeout/1; @:
+distro/syslinux-noescape: distro/syslinux-auto use/syslinux/noescape.cfg; @:
+
+distro/live-systemd: distro/.base use/live/base +systemd; @:
+distro/live-plymouth: distro/.live-base use/plymouth/live; @:
+distro/live-mediacheck: distro/.base use/mediacheck; @:
+
+distro/live-testserver: distro/live-install use/server/mini
+	@$(call set,KFLAVOURS,std-def el-smp)
+
+distro/live-gns3: distro/live-icewm
+	@$(call add,LIVE_LISTS,gns3)
+	@$(call add,LIVE_KMODULES,kvm virtualbox)
+
+# NB: requires runtime Server/ServerActive setup in zabbix_agentd.conf
+distro/live-zabbix: distro/live-icewm use/net-eth
+	@$(call add,THE_PACKAGES,zabbix-agent)
+	@$(call add,DEFAULT_SERVICES_ENABLE,zabbix_agentd)
+
+distro/icewm-efi: distro/icewm use/efi/debug use/firmware
+	@$(call add,INSTALL2_PACKAGES,strace)
+
+distro/razorqt-kz: distro/regular-razorqt
+	@$(call set,GLOBAL_BOOT_LANG,kk_KZ)
+	@$(call add,LIVE_PACKAGES,hunspell-kk)
+
+distro/server-systemd: distro/server-mini +systemd
+	@$(call set,KFLAVOURS,std-def)
+
+distro/server-test: distro/server-mini use/relname
+	@$(call set,RELNAME,Test-Server)
+
+# something marginally useful (as a network-only installer)
+# NB: doesn't carry stage3 thus cannot use/bootloader
+distro/netinst: distro/.base use/install2/net; @:
+
+# tiny network-only server-ovz installer (stage2 comes over net too)
+distro/server-ovz-netinst: distro/.base sub/stage1 use/stage2 \
+	use/syslinux/ui/menu use/syslinux/localboot.cfg use/memtest
+	@$(call add,SYSLINUX_CFG,netinstall2)
+
+distro/desktop-luks: distro/icewm use/luks; @:
+distro/desktop-systemd: distro/icewm +systemd; @:
+distro/desktop-plymouth: distro/icewm +plymouth; @:
+distro/server-efi: distro/server-mini use/efi/debug; @:
+
+distro/server-zabbix: distro/server-mini use/server/zabbix use/net-eth
+
+# a crop of images running stuff as PID 1
+distro/bash: distro/.base use/pid1
+	@$(call add,STAGE1_PACKAGES,bash)
+	@$(call set,PID1_BIN,/bin/bash)
+
+distro/vi: distro/.base use/pid1
+	@$(call add,STAGE1_PACKAGES,vim-minimal)
+	@$(call set,PID1_BIN,/bin/vi)
+
+distro/emacs: distro/.base use/pid1
+	@$(call add,STAGE1_PACKAGES,mg)
+	@$(call set,PID1_BIN,/usr/bin/mg)
+
+distro/elinks: distro/.base use/pid1/net
+	@$(call add,STAGE1_PACKAGES,elinks)
+	@$(call set,PID1_BIN,/usr/bin/elinks)
+
+endif # IMAGE_CLASS: distro
+
+ifeq (ve,$(IMAGE_CLASS))
+
+ifeq (centos,$(REPO))
+
+ve/.centos-base: ve/.bare
+	@$(call set,IMAGE_INIT_LIST,hasher-pkg-init)
+
+ve/centos: ve/.centos-base
+	@$(call add,BASE_PACKAGES,openssh-server)
+
+endif # REPO: centos
+
+ifeq (opensuse,$(REPO))
+
+ve/.opensuse-base: ve/.bare
+	@$(call set,IMAGE_INIT_LIST,hasher-pkg-init)
+	@$(call add,BASE_PACKAGES,aaa_base)
+
+endif # REPO: opensuse
+
+endif # IMAGE_CLASS: ve
+
+ifeq (vm,$(IMAGE_CLASS))
+
+vm/net-static: vm/bare use/net-eth use/net-ssh
+	@$(call add,NET_ETH,eth0:static:10.0.2.16/24:10.0.2.2)
+
+endif # IMAGE_CLASS: vm
+
+endif

conf.d/ve.mk

@@ -0,0 +1,29 @@
+ifeq (ve,$(IMAGE_CLASS))
+
+# no "vzctl enter"
+ve/bare: ve/.base use/init/sysv; @:
+
+# /dev/pty and friends start here
+ve/base: ve/bare
+	@$(call add,BASE_PACKAGES,interactivesystem)
+
+# a particular package list
+ve/ldv: ve/bare
+	@$(call add,BASE_PACKAGES,xz bzip2 glibc hostinfo less)
+	@$(call add,BASE_PACKAGES,vim-console netlist rsync time)
+	@$(call add,BASE_PACKAGES,openssh-blacklist openssh-server)
+	@$(call add,BASE_PACKAGES,shadow-edit shadow-groups)
+
+ve/docker: ve/.base use/repo; @:
+
+# this should be more or less convenient
+ve/generic: ve/base use/repo
+	@$(call add,BASE_PACKAGES,vim-console etckeeper)
+	@$(call add,BASE_LISTS,openssh \
+		$(call tags,base && (server || network || security || pkg)))
+
+# example of service-specific template
+ve/openvpn: ve/bare
+	@$(call add,BASE_LISTS,$(call tags,server openvpn))
+
+endif

conf.d/vm.mk

@@ -0,0 +1,26 @@
+# virtual machines
+ifeq (vm,$(IMAGE_CLASS))
+
+# NB: interactivesystem pulls in network-config-subsystem anyways
+vm/bare: vm/.bare +sysvinit
+	@$(call add,BASE_PACKAGES,apt)
+
+vm/net: vm/bare use/net-eth/dhcp use/net-ssh use/repo use/control/sudo-su
+	@$(call add,BASE_PACKAGES,su)
+
+# NB: use/x11 employs some installer-feature packages
+vm/.desktop-bare: vm/net use/x11/xorg use/cleanup/installer use/repo; @:
+
+vm/.desktop-base: vm/.desktop-bare \
+	use/deflogin/altlinuxroot use/x11-autologin; @:
+
+mixin/icewm: use/x11/lightdm/gtk +icewm; @:
+
+vm/icewm: vm/.desktop-base mixin/icewm; @:
+
+vm/icewm-setup: vm/.desktop-bare mixin/icewm use/oem use/x11-autostart
+	@$(call set,BRANDING,simply-linux)
+	@$(call add,THE_BRANDING,graphics)
+	@$(call add,THE_LISTS,$(call tags,base l10n))
+
+endif

distro.mk

@@ -1,77 +0,0 @@
-# this makefile is designed to be included in toplevel one
-ifndef BUILDDIR
-$(error BUILDDIR not defined)
-endif
-
-# step 2: build up distribution's configuration
-
-# NB: distro/ targets should be defined in this file,
-# see toplevel Makefile's $(DISTROS) assignment
-CONFIG = $(BUILDDIR)/distcfg.mk
-
-# collect use/% (source initial feature snippets)
--include features.in/*/config.mk
-
-# put(), add(), set(), try(), tags():
-# package list names are considered relative to pkg/lists/;
-# tags can do boolean expressions: (tag1 && !(tag2 || tag3))
-include functions.mk
-
-# distro/.%, sub/.%, boot/%
-include libdistro.mk
-
-# bootloader test target; requires recent mkimage to build
-distro/syslinux: distro/.init distro/.branding sub/stage1 \
-	use/syslinux use/syslinux/localboot.cfg \
-	use/syslinux/ui-vesamenu use/hdt use/memtest use/dos
-
-#  $(VAR) will be substituted before writing them to $(CONFIG);
-# $$(VAR) will remain unsubstituted util $(CONFIG) is included
-#         and their value requested (so the variable referenced
-#         can change its value during configuration _before_
-#         it's actually used); just peek inside $(CONFIG) ;-)
-# BASE_PACKAGES, BASE_LISTS, MAIN_PACKAGES, MAIN_LISTS: see sub.in/main/
-
-# live images
-
-distro/live: distro/.base use/live use/syslinux/ui-menu
-distro/rescue: distro/.base use/rescue use/syslinux/ui-menu
-
-# something actually useful (as a network-only installer)
-# NB: doesn't carry stage3 thus cannot use/bootloader
-distro/installer: distro/.base use/install2
-	@$(call set,INSTALLER,altlinux-generic)
-	@$(call set,STAGE1_KMODULES_REGEXP,drm.*)	# for KMS
-
-# server distributions
-
-distro/server-base: distro/installer sub/main \
-	use/syslinux/ui-menu use/memtest use/bootloader/grub
-	@$(call add,BASE_LISTS,server-base)
-
-distro/server-ovz: distro/server-base use/hdt use/rescue use/firmware/server
-	@$(call set,STAGE1_KFLAVOUR,std-def)
-	@$(call set,KFLAVOURS,std-def ovz-el)
-	@$(call add,KMODULES,bcmwl e1000e igb ndiswrapper rtl8168 rtl8192)
-	@$(call add,KMODULES,ipset ipt-netflow opendpi pf_ring xtables-addons)
-	@$(call add,KMODULES,drbd83 kvm)
-	@$(call add,MAIN_LISTS,kernel-wifi)
-	@$(call add,BASE_LISTS,ovz-server)
-	@$(call add,BASE_LISTS,$(call tags,base server))
-	@$(call add,GROUPS,dns-server http-server ftp-server kvm-server)
-	@$(call add,GROUPS,ipmi mysql-server dhcp-server mail-server)
-	@$(call add,GROUPS,monitoring diag-tools)
-
-distro/minicd: distro/server-base
-	@$(call set,KFLAVOURS,pure-emerald)	# usually recent drivers
-	@$(call add,MAIN_PACKAGES,etcnet-full)
-
-# desktop distributions
-
-distro/desktop-base: distro/installer sub/main \
-	use/syslinux/ui-vesamenu use/x11/xorg use/bootloader/grub
-
-distro/icewm: distro/desktop-base use/lowmem use/x11/xdm use/x11/runlevel5 use/bootloader/lilo
-	@$(call add,BASE_LISTS,$(call tags,icewm desktop))
-
-# NB: if there are too many screens above, it might make sense to distro.d/

doc/.fop.xconf

@@ -0,0 +1,54 @@
+<?xml version="1.0"?>
+<!-- $Id: fop.xconf 901793 2010-01-21 17:37:07Z jeremias $ -->
+
+<!-- NOTE: This is the version of the configuration -->
+<fop version="1.0">
+
+  <base>.</base>
+  <source-resolution>72</source-resolution>
+  <target-resolution>72</target-resolution>
+  <default-page-settings height="11in" width="8.26in"/>
+  <renderers>
+    <renderer mime="application/pdf">
+      <filterList>
+        <value>flate</value>
+      </filterList>
+
+      <fonts>
+          <auto-detect/>
+      </fonts>
+    </renderer>
+
+    <renderer mime="application/x-afp">
+      <images mode="b+w" bits-per-pixel="8"/>
+      <renderer-resolution>240</renderer-resolution>
+      <resource-group-file>resources.afp</resource-group-file>
+    </renderer>
+
+    <renderer mime="application/postscript">
+    </renderer>
+
+    <renderer mime="application/vnd.hp-PCL">
+    </renderer>
+
+    <renderer mime="image/svg+xml">
+      <format type="paginated"/>
+      <link value="true"/>
+      <strokeText value="false"/>
+    </renderer>
+
+    <renderer mime="application/awt">
+    </renderer>
+
+    <renderer mime="image/png">
+    </renderer>
+
+    <renderer mime="image/tiff">
+    </renderer>
+
+    <renderer mime="text/xml">
+    </renderer>
+
+  </renderers>
+
+</fop>

doc/.gitignore

@@ -0,0 +1,4 @@
+mkimage-profiles.chunked
+docbook-xsl.css
+mkimage-profiles.pdf
+mkimage-profiles.html

doc/Makefile

@@ -0,0 +1,64 @@
+# build asciidoc books
+
+ifdef BUILDDIR
+DEST = -D "$(BUILDDIR)"
+endif
+
+ifdef DEBUG
+VERBOSE = --verbose
+endif
+
+# avoid common DEBUG for the time being
+-include $(HOME)/.mkimage/profiles.mk
+
+PROJECT = mkimage-profiles
+TOPLEVEL_DOC = $(PROJECT).asciidoc
+RESOURCE_FILES = /etc/asciidoc
+
+A2X = a2x
+FXC = .fop.xconf
+
+L = ru
+DEPTH = 3
+
+# common args (and the source file to process) come last
+XSLT_ARGS = --stringparam toc.max.depth $(DEPTH)
+COMMON_ARGS = -d book -a lang="$L" $(DEST) $(VERBOSE) $(TOPLEVEL_DOC)
+HTML_ARGS = -a data-uri --icons -r $(RESOURCE_FILES) -r . \
+	    --xsltproc-opts='$(XSLT_ARGS)' $(COMMON_ARGS)
+
+# most convenient deliverables
+DOCS_OUT = $(PROJECT).pdf $(PROJECT).html docbook-xsl.css
+
+# intermediate files
+DOCS_TMP = $(PROJECT).fo $(PROJECT).xml
+
+.PHONY: all prep chunked xhtml pdf clean
+
+all: chunked xhtml pdf
+
+# NB: destination defined externally
+publish: all
+	@if [ -n "$(DOCS_PUBLISH)" ]; then \
+		rsync -qa $(DOCS_OUT) "$(DOCS_PUBLISH)"; \
+	fi
+
+prep:
+	@if [ -n "$(BUILDDIR)" ]; then mkdir -p "$(BUILDDIR)"; fi
+
+chunked xhtml: prep
+	@echo "** building $@ book"
+	@$(A2X) -f $@ $(HTML_ARGS)
+
+pdf: prep
+	@echo "** building $@ book"
+	@$(A2X) --xsltproc-opts='$(XSLT_ARGS) \
+		--stringparam title.font.family "DejaVu Sans" \
+		--stringparam body.font.family "DejaVu Serif" \
+		--stringparam monospace.font.family "DejaVu Sans Mono"' \
+		--fop --fop-opts='-c $(FXC)' -f pdf $(COMMON_ARGS)
+
+clean:
+	@echo "** cleaning up"
+	@if [ -d "$(BUILDDIR)" ]; then cd "$(BUILDDIR)"; fi; \
+	rm -rf $(DOCS_OUT) $(DOCS_TMP) $(PROJECT).chunked/ .fop.xconf

doc/apt.conf.sample

@@ -0,0 +1,8 @@
+// these must be unset to avoid picking up
+// /etc/apt/{apt.conf.d,sources.list.d,}/
+Dir::Etc::main "/dev/null";
+Dir::Etc::parts "/var/empty";
+Dir::Etc::SourceParts "/var/empty";
+
+// this is what caused the whole trouble
+Dir::Etc::sourcelist "/home/mike/apt/sources.list";

doc/assumptions.txt

@@ -1,17 +1,53 @@
-- pkg.in/lists/Makefile
-  + ожидает, что названия пакаджлистов указываются в переменных
+== Предположения ==
+
+Некоторые фрагменты кода закладываются на определённое поведение
+других частей mkimage-profiles либо содержание переменных.
+
+NB: пути приводятся от верхнего уровня; проект в целом предполагает
+ALT Linux 6.0+ и GNU make 3.81+ (на которых и разрабатывается),
+но может быть портирован вместе с mkimage.  Если что-либо не работает
+или не собирается, стоит проверить на Sisyphus (mkimage, make, hasher,
+собственно пакетная база), поскольку именно на нём происходит основная
+разработка mkimage-profiles.  Сломанная сборка на текущем стабильном
+бранче считается ошибкой и подлежит исправлению, если оно технически
+возможно на базе этого бранча.
+
+* lib/report.mk
+** ожидает, что каждая подлежащая трассированию цель каждого
+    makefile при сборке конфигурации образа содержит непустой
+    recipe -- хотя бы "; @:" -- т.к. зависит от запуска $(SHELL)
+** характерный признак пропуска -- разрыв графа (report-targets.png)
+
+* pkg.in/lists/Makefile
+** ожидает, что названия пакаджлистов указываются в переменных
     вида *_LISTS, и копирует в генерируемый профиль только их
-  + если задать имя файла пакаджлиста непосредственно в Makefile
+** если задать имя файла пакаджлиста непосредственно в Makefile
     субпрофиля, он не будет скопирован
-  + характерное сообщение об ошибке:
+** характерное сообщение об ошибке:
+
     E: Couldn't find package
 
-- features.in/stage2/stage1/scripts.d/02-kdefault
-- features.in/stage2/stage1/scripts.d/03-test-kernel
-- sub.in/stage1/Makefile
-  + ожидают, что в stage1 попадёт строго одно ядро сообразно
+* features.in/kernel/stage1/scripts.d/80-make-initrd
+* features.in/stage2/stage1/scripts.d/03-test-kernel
+* sub.in/stage1/Makefile
+** ожидают, что в stage1 попадёт строго одно ядро сообразно
     явному указанию в STAGE1_KFLAVOUR (либо последнее указанное
     в KFLAVOURS)
-  + если добавить какой-либо kernel-image в STAGE1_PACKAGES*,
+** если добавить какой-либо kernel-image в STAGE1_PACKAGES*,
     результат может быть неожиданным
-  + вероятная ошибка: незагрузка полученного squashfs
+** вероятная ошибка: незагрузка полученного squashfs
+
+* features.in/install2/install2/stage2cfg.mk
+* features.in/live/live/stage2cfg.mk
+* features.in/rescue/rescue/stage2cfg.mk
+* features.in/syslinux/cfg.in/15live.cfg
+* features.in/syslinux/cfg.in/20install2.cfg
+* features.in/syslinux/cfg.in/80rescue.cfg
+* features.in/syslinux/scripts.d/20-propagator-ramdisk
+** ожидают, что названия squashfs-образов второй стадии инсталятора,
+    livecd и спасательной системы соответственно altinst, live и rescue
+
+* image.in/Makefile
+** ожидает, что конфигурация будет в distcfg.mk (см. тж. lib/profile.mk),
+    а лог сборки -- в build.log (см. тж. lib/log.mk); альтернативой было
+    бы пробрасывание переменных с полным путём ради единственного места

doc/debug.txt

@@ -0,0 +1,25 @@
+== Ловля плюх ==
+
+При отладке сборки конфигурации или самого дистрибутива
+могут оказаться полезными следующие средства:
+
+* build/distcfg.mk
+** формируется автоматически в процессе построения конфигурации;
+** содержит трассировочную информацию (откуда что взялось);
+** этот файл применяется как авторитетный конфигурационный
+
+* build/build.log
+** подробность зависит от значения переменной DEBUG,
+   которую можно передать при запуске make (см. params.txt);
+** содержит коммит, из которого происходит сборка, и признак
+   "грязности" рабочего каталога при наличии модификаций после
+   этого коммита;
+** содержит список конфигурационных переменных и их конечных значений,
+   созданный на основании distcfg.mk (см. тж. build/vars.mk)
+* REPORT=1 включает генерацию дополнительного вывода:
+** build/reports/targets.png -- граф зависимостей между целями
+** build/reports/scripts.log -- порядок запуска скриптовых хуков
+** build/reports/cleanlog.log -- более пригодный для diff(1) журнал сборки
+
+Общая информация по отладке сборки профилей mkimage доступна на вики:
+http://www.altlinux.org/Mkimage/debug

doc/features.txt

@@ -1,6 +1,9 @@
+== Фичи ==
+
 Особенности дистрибутива, не учитываемые в пакетной базе
-или зависящие от переменных времени сборки/установки образа,
-могут быть оформлены несколькими образами:
+или зависящие от переменных времени сборки/установки образа;
+по необходимости влияют на конфигурацию, приносят с собой
+или запрашивают скрипты, которые могут быть оформлены как:
 
 * scripts.d/ или image-scripts.d/ различных стадий;
 * пакеты installer-feature-*
@@ -8,14 +11,29 @@
 
 В большинстве случаев можно рекомендовать создание feature
 средствами метапрофиля, поскольку при этом дерево кода более
-удобно для анализа и обновления (и в отличие от m-p-d, нет
+удобно для анализа и обновления (и в отличие от _m-p-d_ -- нет
 вынужденной необходимости либо контролировать включение нужных
 фич "вручную" в скриптах по косвенным признакам, либо выносить
 их в пакеты installer-feature-*).
 
 Создание и упаковку installer-feature-* можно рекомендовать, если:
 
-* необходимы пакетные зависимости;
+* необходимы пакетные зависимости (в т.ч. версии/конфликты);
 * требуется компилируемый платформозависимый код (для чего бы...);
 * код фичи достаточно специфичен, нетривиален и объёмен,
-  чтобы загромождать метапрофиль было не очень осмысленно.
+  чтобы загромождать метапрофиль было не очень осмысленно;
+* фича представляет из себя отдельный мини-продукт, над которым
+  ведётся активная работа (возможно, несколькими людьми).
+
+Стоит избегать изменения пакетных умолчаний в случае, когда их
+представляется осмысленным и возможным скорректировать в пакете:
+таким образом они станут более дистрибутивными.
+
+Обратите внимание, что фичи включаются в комплект инкрементально:
+что добавили, то уже не убрать; поэтому при необходимости следует
+выделять промежуточные цели сборки, собирающие необходимые фичи
+и оставляющие те, по которым есть расхождения, на включение ближе
+к конечной дистрибутивной цели.
+
+Соглашение по именованию таково, что цели use/ФИЧА и use/ФИЧА/...
+определяются в файле features.in/ФИЧА/config.mk и только в нём.

doc/gen-asciidoc.txt

@@ -0,0 +1,16 @@
+== Генерация документации ==
+
+При желании сгенерировать PDF устанавливаем необходимые пакеты:
+  # apt-get install asciidoc-a2x xmlgraphics-fop fonts-ttf-dejavu
+
+// Внимание!  FOP со всем нужным весьма увесист (несколько сот мегабайт).
+
+Для генерации текущей документации посредством ASCIIDOC выполнить по вкусу:
+  $ make pdf
+  $ make xhtml
+
+Сгенерируются соответственно mkimage-profiles.pdf или mkimage-profiles.html
+(в текущем каталоге либо BUILDDIR, если задан).
+
+Для очистки:
+  $ make clean

doc/mkimage-profiles.asciidoc

@@ -0,0 +1,82 @@
+= mkimage-profiles =
+Michael Shigorin <mike@altlinux.org>
+:DocVersion: v1.0
+:DocDate: Jun 2013
+
+= Введение =
+
+mkimage-profiles, или _m-p_ — результат осмысления и обобщения опыта создания
+семейств дистрибутивов свободного программного обеспечения на базе ALT Linux.
+
+*Цели*
+
+* поощрение совместной работы
+* относительно низкая трудоёмкость использования
+* пригодность к применению как очень крутыми хакерами, так и новичками
+
+*Средства*
+
+Двухуровневость:
+
+* метапрофиль более объёмен и сложен, но выгоден для долгосрочной разработки
+* сгенерированный дистрибутивный профиль более легко обозрим и модифицируем как одноразовый форк
+* наследственность на уровне индивидуальных особенностей и образов в целом
+* прозрачность и диагностируемость формирования конфигурации
+* документированность
+
+*Примеры использования*
+
+Выполняем начальные инструкции по документации:
+
+  git clone git://git.altlinux.org/people/mike/packages/mkimage-profiles.git
+  cd mkimage-profiles
+  make rescue.iso
+
+= Основы =
+
+include::../README[]
+
+include::params.txt[]
+
+include::features.txt[]
+
+include::pkglists.txt[]
+
+= Каталоги =
+
+include::../conf.d/README[]
+
+include::../image.in/README[]
+
+include::../features.in/README[]
+
+include::../sub.in/README[]
+
+include::../sub.in/main/README[]
+
+include::../sub.in/stage1/README[]
+
+include::../sub.in/stage2/README[]
+
+include::../pkg.in/README[]
+
+include::../pkg.in/lists/README[]
+
+include::../pkg.in/lists/tagged/README[]
+
+include::../pkg.in/groups/README[]
+
+include::../lib/README[]
+
+= Приложения =
+
+include::assumptions.txt[]
+
+include::debug.txt[]
+
+include::style.txt[]
+
+include::vm.txt[]
+
+include::qemu.txt[]
+

doc/params.txt

@@ -0,0 +1,117 @@
+== Переменные make ==
+
+При запуске на сборку принимается ряд переменных
+(см. тж. profiles.mk.sample):
+
+* APTCONF
+** задаёт путь к требуемому apt.conf
+** значение: пусто (по умолчанию системный) либо строка
+** см. image.in/Makefile, doc/apt.conf.sample
+
+* ARCH
+** задаёт целевую архитектуру образов
+** значение: пусто (по умолчанию авто), i586, x86_64, arm, ppc
+** см. lib/build.mk
+
+* ARCHES
+** задаёт набор целевых архитектур при параметрическом задании APTCONF
+** значение: пусто (по умолчанию авто) либо список через пробел
+** см. Makefile, doc/profiles.mk.sample
+
+* BELL
+** подаёт сигнал после завершения сборки
+** значение: пусто (по умолчанию нет) либо любая строка
+** см. lib/build.mk
+
+* BUILDDIR
+** задаёт каталог генерируемого профиля и сборки
+** значение: пусто (по умолчанию авто) либо строка
+** см. lib/profile.mk
+
+* BUILDDIR_PREFIX
+** задаёт префикс каталога генерируемого профиля и сборки
+** значение: строка; по умолчанию выбирается алгоритмически
+** см. main.mk
+
+* BUILDLOG
+** задаёт путь к файлу журнала сборки/очистки
+** значение: $(BUILDDIR)/build.log (по умолчанию) либо строка
+** см. lib/log.mk
+
+* CHECK
+** включает режим проверки сборки конфигурации (без сборки образа)
+** значение: пусто (по умолчанию) либо любая строка
+** см. lib/build.mk, lib/clean.mk
+
+* CLEAN
+** экономия RAM+swap при сборке в tmpfs, иначе места на диске
+** очистка рабочего каталога после успешной сборки очередной стадии
+** может помешать использовать некоторые варианты отладки
+** значение: пусто, 0, 1, 2; по умолчанию пусто при DEBUG, иначе 1
+** см. lib/clean.mk
+
+* DEBUG
+** включает средства отладки, может отключить зачистку после сборки
+** значение: пусто (по умолчанию), 1 или 2
+** см. lib/log.mk, lib/clean.mk
+
+* HOMEPAGE, HOMENAME, HOMEWAIT
+** указывают адрес, название и таймаут перехода для домашней страницы
+** значение: корректный URL, строка, целое неотрицательное число
+** см. features.in/live/generate.mk (тж. по умолчаниям)
+
+* ISOHYBRID
+** включает создание гибриднго ISO-образа
+** значение: пусто (по умолчанию) либо любая строка
+** см. features.in/pack/config.mk, features.in/isohybrid/config.mk
+
+* NICE
+** понижает нагрузку системы сборочной задачей
+** значение: пусто (по умолчанию) либо любая строка
+** см. lib/build.mk
+
+* REPORT
+** запрашивает создание отчётов о собранном образе
+** значение: пусто (по умолчанию) либо любая строка
+** NB: в силу специфики обработки передаётся только явно
+** см. Makefile, report.mk, lib/report.mk
+
+* ROOTPW
+** устанавливает пароль root по умолчанию для образов виртуальных машин
+** значение: пусто (по умолчанию root) либо строка
+** см. features.in/deflogin/rootfs/image-scripts.d/50-root
+
+* SAVE_PROFILE
+** сохраняет архив сгенерированного профиля в .disk/
+** значение: пусто (по умолчанию) либо любая строка
+** см. image.in/Makefile
+
+* SORTDIR
+** дополнительно структурирует каталог собранных образов
+** значение: пусто (по умолчанию) либо строка
+*** например, '$(IMAGE_NAME)/$(DATE)'
+** см. image.in/Makefile
+
+* SQUASHFS
+** определяет характер сжатия squashfs для stage2
+** значение:
+*** пусто (по умолчанию) либо normal: xz
+*** tight: xz с -Xbcj по платформе (лучше, но дольше -- подбор в два прохода)
+*** fast: gzip/lzo (быстрее запаковывается и распаковывается, меньше степень)
+** см. features.in/stage2/stage1/scripts.d/03-test-kernel
+
+* STATUS
+** добавляет в имя образа указанный префикс
+** значение:
+*** пусто (по умолчанию) либо строка (например, "alpha", "beta")
+** см. image.in/Makefile
+
+* VM_SIZE
+** задаёт размер несжатого образа виртуальной машины в байтах
+** значение: пусто (по умолчанию двойной размер чрута) или целое
+** см. features.in/build-vm/lib/90-build-vm.mk, bin/tar2vm
+
+[float]
+=== пример ===
+
+  make DEBUG=1 CLEAN=1 syslinux.iso

doc/pkglists.txt

@@ -0,0 +1,51 @@
+== Списки пакетов ==
+
+Состав пакетной базы субпрофилей определяется значениями
+следующих переменных профиля (см. тж. conf.d/README;
+некоторые "*" ниже заэкранированы ради парсера asciidoc):
+
+* 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: общая часть install2, 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
+
+* install2: компактная "живая" система, содержащая только инсталятор
+** см. 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

doc/profiles.mk.sample

@@ -1,10 +1,17 @@
-### sample ~/.mkimage/profiles.mk
+# sample ~/.mkimage/profiles.mk
+# NB: REPORT doesn't work here, it's somewhat special
 
-### where to look for apt.conf; system one used by default
+# where to look for apt.conf; system one used by default
 #APTCONF = ~/apt/apt.conf.$(ARCH)
 
-### turns on GLOBAL_VERBOSE and prettier output
+# turns on GLOBAL_VERBOSE and prettier output
 #DEBUG = 1
 
 # spares tmpfs, quite recommended unless you need raw workdir chroots
 #CLEAN = 1
+
+# run with lower CPU and I/O priorities
+#NICE = 1
+
+# try and draw attention when done (depends on readline/terminal settings)
+#BELL = 1

doc/qemu.txt

@@ -0,0 +1,11 @@
+== QEMU ==
+
+Для сборки на "неродной" архитектуре с применением трансляции
+посредством QEMU установите пакет livecd-qemu-arch и выполните
+команду register-qemu-arm от имени root (также предоставляется
+register-qemu-ppc, но как минимум при сборке под ppc32 на x86_64
+известны проблемы эмуляции).
+
+Пример запуска:
+
+  make ARCH=arm APTCONF=/etc/apt/apt.conf.sisyphus.arm ve/bare.tar

doc/style.txt

@@ -1,8 +1,8 @@
-требования по оформлению кода
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+== Оформление кода ==
+
 * постарайтесь не вносить без обсуждения разнобой стилей,
   если есть предметные пожелания по коррекции текущего --
-  пишите в devel-distro@, обсудим;
+  пишите в devel-distro@ или мне (mike@), обсудим;
 
 * перед тем, как делать существенные переработки уже имеющегося
   кода -- опять же опишите проблему, идею и предполагаемый результат,
@@ -11,8 +11,9 @@
 * документируйте на русском (README) или английском (README.en) языке
   то, что написали или изменили.
 
-рекомендации
-~~~~~~~~~~~~
+[float]
+=== рекомендации ===
+
 * трезво относитесь ко входным данным и не пренебрегайте кавычками:
   название дистрибутива с пробелом или получение текста ошибки вместо
   ожидаемого вывода команды могут привести к сложнодиагностируемым
@@ -30,7 +31,9 @@
 
 * постарайтесь не вылазить за 80 колонок.
 
-ссылки
-~~~~~~
+[float]
+
+=== ссылки ===
+
 * https://lists.altlinux.org/mailman/listinfo/devel-distro
   (подписка по приглашению)

doc/variables.txt

@@ -1,29 +0,0 @@
-При запуске на сборку принимается ряд переменных
-(см. тж. profiles.mk.sample):
-
-- APTCONF
-  + задаёт путь к требуемому apt.conf
-  + значение: пусто (по умолчанию системный) либо строка
-  + см. image.in/Makefile
-
-- ARCH
-  + определяет целевую архитектуру образа
-  + значение: пусто (по умолчанию авто), i586 или x86_64
-  + см. iso.mk
-
-- BUILDDIR
-  + определяет каталог генерируемого профиля и сборки
-  + значение: пусто (по умолчанию авто) либо строка
-  + см. profile.mk
-
-- CLEAN
-  + экономия RAM при сборке в tmpfs, иначе места на диске
-  + очистка рабочего каталога после успешной сборки очередной стадии
-  + может помешать использовать некоторые варианты отладки
-  + значение: любая строка, по умолчанию пусто
-  + см. clean.mk
-
-- DEBUG
-  + включение средств отладки
-  + значение: пусто (по умолчанию), 1 или 2
-  + см. log.mk

doc/vm.txt

@@ -0,0 +1,34 @@
+== Сборка образов VM ==
+
+*ВНИМАНИЕ:* заключительная операция создания образа жёсткого диска
+из архива с содержимым корневой файловой системы требует доступа
+к sudo и разрешения на выполнение скрипта bin/tar2fs в корневом
+каталоге метапрофиля при установке mkimage-profiles из пакета
+(это в планах исправить, но подход к libguestfs пока успехом
+не увенчался).
+
+Соответствующий фрагмент конфигурации sudo(8) может выглядеть как:
+
+  mike ALL=NOPASSWD: /usr/share/mkimage-profiles/bin/tar2fs
+
+При работе с локальной копией mkimage-profiles.git следует иметь
+в виду, что предоставлять недоверенному пользователю право выполнять
+от имени root доступный ему по записи скрипт равнозначно предоставлению
+полных привилегий root.
+
+Для работы с более специфичными форматами, чем raw ("буквальный"
+образ диска), потребуется утилита qemu-img из одноименного пакета;
+см. тж. вывод команды make help/vm
+
+Также потребуется пакет multipath-tools (/sbin/kpartx).
+
+Пример сборки и запуска VM:
+
+  $ make ROOTPW=reallysecret1 vm/bare.img && kvm -hda ~/out/bare.img
+
+Если при сборке образа файловой системы произойдёт сбой, может оказаться
+нужным вручную освободить используемые loop-устройства, например, так:
+
+  # losetup -a
+  # kpartx -d /dev/loop0
+  # losetup -d /dev/loop0

features.in/00example/README

@@ -2,40 +2,42 @@
 и должен дать представление о том, какой код _может_ быть
 включён в настоящую фичу: статические файлы, два makefile
 для создания конфигурации и генерирования части профиля,
-а также шелл-скрипт для генерирования.
+а также шелл-скрипт для такого генерирования.
 
-Вовсе не требуется втягивать всё в свою фичу, лучше постараться
+Вовсе не требуется втягивать всё в свою фичу: лучше постараться
 сделать её минимальной, самодостаточной и полезной в качестве
 "кирпичика".
 
-Единственной необходимой частью фичи является файл config.mk,
+Единственной обязательной частью фичи является файл config.mk,
 который включается в distro.mk верхнего уровня и предоставляет
-цель вида use/*, специфичную для данной фичи (а также добавляет
-её в переменную FEATURES -- к сожалению, реализовать добавление
-автоматом не представляется возможным).  Если название фичи не
-упоминается в списке, содержащемся в этой переменной, то она
-и не задействуется при построении профиля.
+цель вида use/*, специфичную для данной фичи, а также добавляет
+её в переменную FEATURES.  Если название фичи не упоминается
+в списке, содержащемся в этой переменной, то она не задействуется
+при построении профиля, а только при сборке конфигурации.
+
+Для наиболее ходовых целей use/*, особенно если их много, можно
+создавать цели-алиасы +* (например, +power).  Просьба относиться
+вдумчиво, т.к. в дальнейшем предполагается визуализировать такие
+цели в UI конфигурирования образа.
 
 Остальное содержимое является дополнительным и используется
 в таком порядке (см. features.in/Makefile):
 
-- сперва в $(BUILDDIR)/image/ копируются все подкаталоги,
-  соответствующие именам субпрофилей, запрошенных для
-  дистрибутивного профиля; при этом они сливаются с деревом,
-  которое уже сформировано субпрофилями (../sub.in/*) и уже
+* сперва в $(BUILDDIR)/image/ копируются все подкаталоги,
+  соответствующие итоговым именам субпрофилей, запрошенных
+  для профиля образа; при этом они сливаются с деревом,
+  которое уже сформировано субпрофилями (sub.in/*) и уже
   скопированными фичами; если какие-либо файлы перекрылись
   по именам, rsync должен оставить резервные копии (*~),
   которые должны просигнализировать о беспорядке;
+* запускается generate.sh, если существует и исполнимый;
+* применяется generate.mk, если существует и непустой.
 
-- затем запускается generate.sh, если существует и исполнимый;
-
-- затем используется generate.mk, если существует и непустой.
-
-Например, если дистрибутив требует субпрофили stage1, install2
-и main, вы можете решить собрать специфические для фичи скрипты
+Например, если используются субпрофили stage1, stage2/install2
+и main, можно решить собрать специфические для фичи скрипты
 инсталятора в install2/image-scripts.d/ (или необходимые для
-операций с пакетной базой -- в main/scripts.d/, смотря чего надо
-добиться; загляните также в документацию mkimage).
+операций с пакетной базой -- в main/scripts.d/, смотря чего
+надо добиться; загляните также в документацию mkimage).
 
 А если требуются нетривиальные действия по конфигурированию
 (как при сборке syslinux.cfg из кусочков, в зависимости от того,
@@ -43,4 +45,4 @@
 произвести из generate.sh и generate.mk.
 
 Пожалуйста, присылайте отзывы о (бес)полезности кода в этом каталоге
-mike@altlinux.
+mike@altlinux.org.

features.in/00example/README.en

@@ -1,43 +0,0 @@
-This directory contains phony example feature and should provide
-you with a minimal idea what code _can_ be included into a real
-feature: static files, configuration and generation makefiles,
-and a generation shell script.
-
-It's not neccessary to toss all of those into your feature,
-better try to keep it minimalistic, self-contained and useful
-as a building block.
-
-The only requisite part of the feature is config.mk which
-is included in toplevel distro.mk and which provides the
-use/* target specific for the feature (and also registers
-it in FEATURES variable -- sorry, it's not feasible to do
-automatically).  If the feature's name isn't mentioned in
-the list contained in that variable, then it's not examined
-while building up the profile either.
-
-The rest of content is optional and used in this order
-(see features.in/Makefile):
-
-- first all subdirectories corresponding to subprofile names
-  requested for the distribution profile being made are copied
-  over to $(BUILDDIR)/image/; thus they get merged with the tree
-  which is already formed by subprofiles (../sub.in/*) and preceding
-  features; in case of overlapping files rsync should leave backup
-  copies which are to be treated as a signal of disorder;
-
-- then generate.sh is run, if found and executable;
-
-- then generate.mk is used, if found and non-empty.
-
-e.g., if the distro needs stage1, install2 and main subprofiles,
-you might want to collect feature-specific scripts for installer
-into install2/image-scripts.d/ (or main/scripts.d/, depending on
-what is to be achieved -- see also mkimage docs).
-
-And if some non-trivial configuration actions are to be done
-(like syslinux config file being compiled from pieces depending
-on what bits are present of the functionality asked for...) then
-you can perform them in generate.* code.
-
-Please feel free to comment on what's useful here and what's crap
-to mike@altlinux.

features.in/00example/config.mk

@@ -8,6 +8,6 @@
 #
 # for somewhat more involved example, see syslinux feature
 
-use/00example: sub/main use/anotherfeature
-	@$(call add,FEATURES,00example)
+use/00example: use/repo/main use/anotherfeature
+	@$(call add_feature)
 	@$(call add,MAIN_PACKAGES,hello)

features.in/00example/main/scripts.d/89-example

@@ -5,7 +5,7 @@
 # NB: to be executed, it must be marked executable first :)
 
 # let's do something very useful
-echo "$0: WORKDIR=$WORKDIR; directory listig:"
+echo "$0: WORKDIR=$WORKDIR; directory listing:"
 ls -l "$WORKDIR"
 
 # and let's _not_ terminate with non-zero for no real reason;

features.in/Makefile

@@ -2,42 +2,128 @@
 #         (only regarding the needed subprofiles)
 
 ifndef BUILDDIR
-$(error BUILDDIR not defined)
-endif
 
--include $(BUILDDIR)/distcfg.mk
+help/plus all: banner
+	@$(call grepper,'^+')
 
-# first rsync what's static, and make backups --
-# these might signal of file clashes (or plain dirt);
-# then handle two more ways of implementing a feature
-# NB: subprofile can be specified as src/dest
-all:
-	@echo "** starting feature configuration"
-	@if test -n "$(GLOBAL_DEBUG)"; then echo "** requested: $(FEATURES)"; fi
-	@for dir in $(FEATURES); do \
-		for sub in $(SUBPROFILES); do \
-			dst="${sub#*/}" && \
-			if test -d "$$dir/$$dst/"; then \
-				if rsync -ab "$$dir/$$dst/" "$(BUILDDIR)/$$dst/"; \
-				then \
-					type -t git >&/dev/null && \
-					pushd "$(BUILDDIR)/$$dst/" && \
-					git add . && \
-					git commit -qam "$@/$$dir/$$dst" ||:; \
-					popd; \
-				fi; \
-			fi; \
-		done; \
-		if test -x "$$dir/generate.sh"; then \
-			pushd "$$dir" && \
-			sh generate.sh; \
-			popd; \
-		fi; \
-		if test -s "$$dir/generate.mk"; then \
-			$(MAKE) -C "$$dir" -f generate.mk; \
-		fi; \
+help/features: banner
+	@$(call grepper,'^use/')
+
+banner:
+	@echo "** BUILDDIR not defined; available features:"
+
+grepper = $(and $(1),$(grepper_body))
+define grepper_body
+	@for dir in */; do \
+		out="`grep -h $(1) $$dir/config.mk \
+		| cut -f1 -d: \
+		| tr ' 	' '\n\n' \
+		| grep $(1) \
+		| tr '\n' ' ' \
+		| sort -u`"; \
+		[ -z "$$out" ] || echo "$$dir: $$out"; \
 	done
+endef
 
-help:
-	@echo "** available features:"
-	@grep -h '^use/' */config.mk
+%:
+	$(error BUILDDIR not defined)
+
+else
+
+export BUILDDIR
+
+include $(BUILDDIR)/distcfg.mk
+
+# first rsync what's static, and make backups (*~) --
+# these might signal of file clashes (or plain dirt);
+# second, care for toplevel dirs;
+# then handle feature generator scripts
+#
+# NB: some subprofiles will be specified as "src/dst"
+#     -- then both src/ and dst/ can hold the addons;
+#     still both pieces go into a single destination
+
+### sorry for somewhat complicated and overly long lines
+
+TARGETS := prep $(FEATURES) finalize
+
+.PHONY: $(TARGETS)
+all:  | $(TARGETS)
+
+prep:
+	@echo "** starting feature configuration"
+	@if [ -n "$(GLOBAL_DEBUG)" ]; then \
+		echo "** target subprofiles: $(SUBPROFILES)"; \
+		echo "** requested features: $(FEATURES)"; \
+	fi
+
+# feat
+# NB: this is somewhat complicated since it has to handle "$sub" like:
+#     - "/": copy feature's toplevel parts to the BUILDDIR toplevel
+#     - "stage1": copy feature's stage1 parts into stage1 subprofile
+#     - "stage2@live": copy feature's stage2 parts into live subprofile
+#     - "rootfs@/": copy feature's rootfs parts into BUILDDIR toplevel
+$(FEATURES):
+	@feat=$@; \
+	if [ -n "$(GLOBAL_DEBUG)" ]; then \
+		echo "** adding $$feat feature"; \
+	fi; \
+	pushd "$$feat" >/dev/null && \
+	for sub in / $(SUBPROFILES); do \
+		if [ "$$sub" = / ]; then \
+			srcdirs="."; \
+			dst="."; \
+		else \
+			src="$${sub%@*}"; \
+			dst="$${sub#*@}"; \
+			if [ "$$src" = / ]; then \
+				echo "** src=/: you don't want this" >&2; \
+				exit 1; \
+			fi; \
+			if [ "$$dst" = / -o "$$dst" = "" ]; then \
+				dst="."; \
+			fi; \
+			srcdirs=; \
+			if [ -d "$$src" ]; then \
+				srcdirs="$$src"; \
+			fi; \
+			if [ -d "$$dst" -a "$$dst" != "$$src" ]; then \
+				srcdirs="$${srcdirs:+$$srcdirs }$$dst"; \
+			fi; \
+			: "why this overduplication was done? (still needed)"; \
+			for srcdir in $$srcdirs; do \
+				rsync -qab "$$srcdir/" "$(BUILDDIR)/$$dst/"; \
+			done; \
+		fi; \
+		if [ -n "$(GLOBAL_DEBUG)" ]; then \
+			echo "** src=[$$src] dst=[$$dst] srcdirs=[$$srcdirs]"; \
+		fi; \
+		for srcdir in $$srcdirs; do \
+			[ -d "$$srcdir" ] || continue; \
+			pushd "$$srcdir" >&/dev/null; \
+			for part in lib {image-,}scripts.d; do \
+				destdir="$(BUILDDIR)/$$dst/$$part"; \
+				[ -d "$$destdir" ] || continue; \
+				if [ "$$sub" = / -a -d "$$part" ]; then \
+					rsync -qab "$$part/" "$$destdir/"; \
+				fi; \
+			done; \
+			popd >&/dev/null; \
+		done; \
+		if [ -n "$$dst" -a "$$dst" != "." ]; then \
+			the="$$sub subprofile"; \
+		else \
+			the="toplevel"; \
+		fi; \
+		mp-commit "$(BUILDDIR)/$$dst/" "$$feat feature: $$the part added"; \
+	done; \
+	if [ -x "generate.sh" ]; then sh generate.sh; fi; \
+	if [ -s "generate.mk" ]; then $(MAKE) -f generate.mk; fi; \
+	mp-commit "$(BUILDDIR)" "$$feat feature generation complete"; \
+	popd >/dev/null
+
+finalize:
+	@find "$(BUILDDIR)/" -name '*~' \
+	| sed "s,$(BUILDDIR)/,** warning: file clash: ," >&2
+
+endif

features.in/README

@@ -1,20 +1,42 @@
-Этот каталог содержит т.н. фичи (features, особенности) --
-каталоги, содержимое каждого из которых реализует одну из
-подключаемых автономных возможностей дистрибутива.
+== features.in ==
 
-Каждая фича должна содержать задействуемый при построении
-конфигурации будущего образа файл config.mk, включаемый
-в ../distro.mk; он может описывать одну или более целей
-вида use/*, дополняющих конфигурацию дистрибутива, и при
-наличии дополнительных хуков для копирования или generate.*
-должен добавить имя фичи в $(FEATURES).
+Этот каталог содержит т.н. фичи (features, особенности).
 
-На этапе генерации дистрибутивного профиля фичи рассматриваются
-после инициализации профиля (см. ../image.in/) и копирования
-субпрофилей (см. ../sub.in/).  Для каждой фичи, указанной
-в $(FEATURES), копируются подкаталоги сообразно субпрофилям,
-а также выполняется скрипт generate.sh и задействуется generate.mk
-(при их наличии).
+Фича -- отдельно подключаемая сущность, которая содержит
+повторно используемые конфигурацию/код и определяет одну
+из особенностей создаваемого образа.  Может зависеть от
+других фич либо субпрофилей.
+
+Каждая фича должна содержать файл config.mk, включаемый
+в main.mk при построении конфигурации будущего профиля;
+он может описывать одну или более целей вида use/*,
+дополняющих конфигурацию, и обязан добавить имя фичи
+в $(FEATURES), для чего создана функция add_feature.
+
+На этапе генерации сборочного профиля фичи рассматриваются
+после инициализации профиля (см. image.in/) и копирования
+субпрофилей (см. sub.in/).  Для каждой фичи, указанной
+в $(FEATURES), копируются подкаталоги сообразно включенным
+субпрофилям, а также lib/ и {image-,}scripts.d/; затем
+выполняются generate.sh и generate.mk при их наличии.
+
+Если фича дополняет хуками семейство целевых субпрофилей,
+построенных на одном базовом, можно воспользоваться подкаталогом
+с именем исходного базового субпрофиля (см. $src, $dst в Makefile).
+
+Рекомендуется давать несколько различающиеся имена скриптам,
+которые одна и та же фича может добавлять в различные стадии,
+чтобы они не выглядели одинаково в логе сборки.
+
+Наиболее востребованные цели можно снабжать "ярлычками" вроде
+"+icewm" с тем, чтобы сделать более краткими и выразительными
+использующие их правила.  Просьба не злоупотреблять количеством,
+такие имена предполагается показывать в интерфейсе к профилю.
+
+Каталог lib/ является специфическим для фич, определяющих
+построение конкретного вида образа -- см. build-*/.
 
 Несложный пример содержится в 00example/, более близкий к жизни
 и нынешним пределам возможностей метапрофиля -- в syslinux/.
+
+См. тж. файлы README в каталогах фич (отсутствие -- баг!).

features.in/armh-cubox/README

@@ -0,0 +1 @@
+Поддержка SolidRun Cubox в расчёте на подключенный по HDMI дисплей FullHD.

features.in/armh-cubox/config.mk

@@ -0,0 +1,3 @@
+use/armh-cubox: use/armh
+	@$(call add_feature)
+	@$(call set,KFLAVOURS,cubox)

features.in/armh-cubox/rootfs/image-scripts.d/40-boot

@@ -0,0 +1,19 @@
+#!/bin/sh
+
+mkdir -p /boot
+
+# 1920x1080 version of the boot script
+cat > /boot/boot << EOF
+setenv bootargs 'console=ttyS0,115200 root=/dev/mmcblk0p2 ro video=dovefb:lcd0:1920x1080-32@60-edid clcd.lcd0_enable=1 clcd.lcd1_enable=0 vmalloc=128M panic=3'
+ext2load mmc 0:1 2000000 uimage
+ext2load mmc 0:1 2800000 uinitrd
+bootm 2000000 2800000
+EOF
+
+# 1280x720 version of the boot script (not used at the moment)
+cat > /boot/boot.720 << EOF
+setenv bootargs 'console=ttyS0,115200 root=/dev/mmcblk0p2 ro video=dovefb:lcd0:1280x720-24@60-edid clcd.lcd0_enable=1 clcd.lcd1_enable=0 vmalloc=128M panic=3'
+ext2load mmc 0:1 2000000 uimage
+ext2load mmc 0:1 2800000 uinitrd
+bootm 2000000 2800000
+EOF

features.in/armh-dovefb/README

@@ -0,0 +1 @@
+Эта фича обеспечивает начальное конфигурирование Marvell Dove GPU.

features.in/armh-dovefb/config.mk

@@ -0,0 +1,3 @@
+use/armh-dovefb: use/armh
+	@$(call add_feature)
+	@$(call add,THE_PACKAGES,xorg-drv-dovefb)

features.in/armh-dovefb/rootfs/image-scripts.d/90-armh-dovefb.sh

@@ -0,0 +1,106 @@
+#!/bin/sh
+
+mkdir -p /etc/udev/rules.d
+cd /etc/udev/rules.d
+
+cat > 99-bmm.rules << EOF
+KERNEL=="bmm|bmm[0-9]", GROUP="xgrp", MODE="0660"
+EOF
+
+cat > 99-fb.rules << EOF
+KERNEL=="fb|fb[0-9]", GROUP="xgrp", MODE="0660"
+EOF
+
+cat > 99-galcore.rules << EOF
+KERNEL=="galcore|galcore[0-9]", GROUP="xgrp", MODE="0660"
+EOF
+
+cat > 99-uio.rules << EOF
+KERNEL=="uio|uio[0-9]", GROUP="xgrp", MODE="0660"
+EOF
+
+mkdir -p /etc/X11
+cd /etc/X11
+
+cat > xorg.conf.720 << EOF
+Section "Device"
+	Identifier	"Videocard0"
+	Driver		"dovefb"
+#	Option		"ExaAccel"	"on"
+	Option		"Solid"		"on"
+	Option		"Copy"		"on"
+	Option		"Composite"	"on"
+	Option		"Commit"	"on"
+	Option		"XvAccel"	"on"
+	Option		"UseGPU"	"on"
+EndSection
+
+Section "Monitor"
+	Identifier	"LCD0"
+	Option		"PreferredMode"	"1280x720"
+EndSection
+
+Section "Screen"
+	Identifier	"Screen 0"
+	Device		"Videocard0"
+	Monitor		"LCD0"
+	DefaultDepth	24
+	DefaultFbBpp	24
+	SubSection	"Display"
+		Depth	24
+		Modes	"1280x720"
+	EndSubSection
+EndSection
+
+Section "ServerLayout"
+	Identifier "Main Layout"
+	Screen	0  "Screen 0"
+EndSection
+EOF
+
+cat > xorg.conf.1080 << EOF
+Section "Device"
+	Identifier	"Videocard0"
+	Driver		"dovefb"
+#	Option		"ExaAccel"	"on"
+	Option		"Solid"		"on"
+	Option		"Copy"		"on"
+	Option		"Composite"	"on"
+	Option		"Commit"	"on"
+	Option		"XvAccel"	"on"
+	Option		"UseGPU"	"on"
+	#Option		"Debug"		"on"
+EndSection
+
+Section "Monitor"
+	Identifier "LCD0"
+	Option "PreferredMode" "1920x1080"
+EndSection
+
+Section "Screen"
+	Identifier "Screen 0"
+	Device "Videocard0"
+	Monitor "LCD0"
+	DefaultDepth 16
+	DefaultFbBpp 16
+	SubSection "Display"
+		Depth 16
+		Modes "1920x1080@60"
+	EndSubSection
+	SubSection "Display"
+		Depth 24
+		Modes "1920x1080@60"
+	EndSubSection
+	SubSection "Display"
+		Depth 32
+		Modes "800x600@60"
+	EndSubSection
+EndSection
+
+Section "ServerLayout"
+	Identifier "Main Layout"
+	Screen 0 "Screen 0"
+EndSection
+EOF
+
+ln -s xorg.conf.1080 xorg.conf

features.in/armh-nexus7/README

@@ -0,0 +1 @@
+Эта фича конфигурирует специфические для Google/ASUS Nexus7 аспекты.

features.in/armh-nexus7/config.mk

@@ -0,0 +1,2 @@
+use/armh-nexus7:
+	@$(call add_feature)

features.in/armh-nexus7/rootfs/image-scripts.d/90-armh-nexus7.sh

@@ -0,0 +1,172 @@
+#!/bin/sh
+
+# FIXME: the exact partition may vary
+cat >> /etc/fstab << EOF
+# YMMV, this might be /dev/mmcblk0p10 either
+/dev/mmcblk0p9 / ext4 defaults 1 1
+EOF
+
+cd /etc/udev/rules.d || exit 1
+
+cat > 90-tegra-rt5640.rules << EOF
+SUBSYSTEM!="sound", GOTO="tegra_rt5640_end"
+ACTION!="change", GOTO="tegra_rt5640_end"
+KERNEL!="card*", GOTO="tegra_rt5640_end"
+
+ATTRS{id}=="tegrart5640", ENV{PULSE_PROFILE_SET}="tegra-nexus7.conf"
+
+LABEL="tegra_rt5640_end"
+EOF
+
+cd /usr/share/pulseaudio/alsa-mixer/profile-sets || exit 1
+cat > tegra-nexus7.conf << EOF
+[General]
+auto-profiles = yes
+
+[Mapping analog-stereo]
+device-strings = front:%f hw:%f plughw:%f
+channel-map = left,right
+paths-output = tegra-nexus7-speaker tegra-nexus7-headphone
+paths-input = tegra-nexus7-intmic
+priority = 10
+EOF
+
+cd /etc/X11 || exit 1
+cat > xorg.conf << EOF
+Section "Device"
+	Identifier	"nexus"
+	Driver		"tegra"
+EndSection
+EOF
+
+cd /etc/X11/xorg.conf.d || exit 1
+cat > 99-nexus-calibration.conf << EOF
+Section "InputClass"
+    Identifier    "Nexus 7 Touchscreen"
+    MatchIsTouchscreen "on"
+    MatchProduct  "elan-touchscreen"
+    MatchDevicePath "/dev/input/event*"
+    MatchDriver   "evdev"
+#    Option  "Calibration"   "29 2125 106 1356"
+#    Option  "SwapAxes"      "0"
+#    Option  "Calibration"   "566 1201 1025 2075"
+#    Option  "SwapAxes"      "1"
+     Option  "Calibration"   "6 2132 29 1294"
+     Option  "SwapAxes"      "0"
+EndSection
+EOF
+
+cat > 99-nexus-rotation.conf << EOF
+Section "Monitor"
+    Identifier	"Monitor"
+    Option	"Rotate" "right"
+EndSection
+
+Section "Screen"
+    Identifier    "Screen"
+    Monitor       "Monitor"
+EndSection
+EOF
+
+cd /usr/share/pulseaudio/alsa-mixer/paths || exit 1
+cat > tegra-nexus7-headphone.conf << EOF
+[General]
+priority = 90
+name = analog-output-headphones
+
+[Jack HP-detect]
+state.plugged = yes
+
+[Element Master]
+switch = mute
+volume = merge
+override-map.1 = all
+override-map.2 = all-left,all-right
+
+[Element HP]
+switch = mute
+volume = merge
+override-map.1 = all
+override-map.2 = all-left,all-right
+
+[Element Headphone Jack]
+switch = mute
+volume = merge
+override-map.1 = all
+override-map.2 = all-left,all-right
+
+[Element Int Spk]
+switch = off
+
+; Due to a kernel bug (?) the "Int Mic" is a playback control.
+; Therefore we enable it here instead of in the proper place
+[Element Int Mic]
+switch = on
+
+EOF
+
+cat > tegra-nexus7-intmic.conf << EOF
+[General]
+priority = 90
+name = analog-input-microphone-internal
+
+[Element ADC]
+; For some reason the ADC volume seems not to be affecting input gain
+switch = mute
+volume = zero
+override-map.1 = all
+override-map.2 = all-left,all-right
+
+[Element ADC Boost Gain]
+switch = mute
+volume = merge
+override-map.1 = all
+override-map.2 = all-left,all-right
+
+[Element Int Mic]
+switch = mute
+
+[Element DMIC]
+enumeration = select
+
+[Option DMIC:DMIC1]
+priority = 89
+name = analog-input-internal-microphone
+
+EOF
+
+cat > tegra-nexus7-speaker.conf << EOF
+[General]
+priority = 100
+name = analog-output-speaker
+
+[Jack HP-detect]
+state.plugged = no
+state.unplugged = unknown
+
+[Element Master]
+switch = mute
+volume = merge
+override-map.1 = all
+override-map.2 = all-left,all-right
+
+[Element Speaker]
+switch = mute
+volume = merge
+override-map.1 = all
+override-map.2 = all-left,all-right
+
+[Element Int Spk]
+switch = mute
+volume = merge
+override-map.1 = all
+override-map.2 = all-left,all-right
+
+[Element Headphone Jack]
+switch = off
+
+; Due to a kernel bug (?) the "Int Mic" is a playback control.
+; Therefore we enable it here instead of in the proper place
+[Element Int Mic]
+switch = on
+EOF

features.in/armh-tegra3/README

@@ -0,0 +1 @@
+Эта фича предназначена для базовой поддержки систем на чипсете NVIDIA Tegra3.

features.in/armh-tegra3/config.mk

@@ -0,0 +1,2 @@
+use/armh-tegra3:
+	@$(call add_feature)

features.in/armh-tegra3/rootfs/image-scripts.d/90-armh-tegra3.sh

@@ -0,0 +1,28 @@
+#!/bin/sh
+
+cd /etc/udev/rules.d || exit 1
+
+cat > 69-tegra-gpu.rules << EOF
+# Set the right permissions to the devices provided by the
+# tegra driver
+ENV{ACL_MANAGE}=="0", GOTO="tegra_gpu_end"
+ACTION!="add|change", GOTO="tegra_gpu_end"
+
+# root only devices
+KERNEL=="knvrm" OWNER="root" GROUP="root" MODE="0660"
+KERNEL=="knvmap" OWNER="root" GROUP="root" MODE="0660"
+
+# graphics devices
+ACTION=="add|change", KERNEL=="nvhost*", GROUP="xgrp", MODE="0660"
+ACTION=="add|change", KERNEL=="nvmap*", GROUP="xgrp", MODE="0660"
+ACTION=="add|change", KERNEL=="tegra*", GROUP="xgrp", MODE="0660"
+ACTION=="add|change", KERNEL=="nvram", GROUP="xgrp", MODE="0660"
+ACTION=="add|change", KERNEL=="nvhdcp*", GROUP="xgrp", MODE="0660"
+
+LABEL="tegra_gpu_end"
+EOF
+
+# FIXME: xgrp is a kludge
+cat > 69-tegra-touchscreen.rules << EOF
+SUBSYSTEM=="input",ACTION=="add|change",KERNEL=="event*",ATTRS{name}=="elan-touchscreen", SYMLINK+="twofingtouch", MODE="0660", GROUP="xgrp"
+EOF

features.in/armh/README

@@ -0,0 +1,2 @@
+Эта фича занимается тем подмножеством необходимой для ARM-образов
+функциональности, которую получается как-то обобщить.

features.in/armh/config.mk

@@ -0,0 +1,2 @@
+use/armh: use/control/sudo-su
+	@$(call add_feature)

features.in/armh/rootfs/image-scripts.d/40-noclock.sh

@@ -0,0 +1,2 @@
+#!/bin/sh
+echo 'HWCLOCK_SET_TIME_AT_START=false' >> /etc/sysconfig/clock

features.in/armh/rootfs/image-scripts.d/50-initrd

@@ -0,0 +1,48 @@
+#!/bin/sh
+
+kver="$(rpm -qa 'kernel-image*' \
+	    --qf '%{installtime} %{version}-%{name}-%{release}\n' \
+	| sort -n \
+	| tail -n 1 \
+	| cut -f 2 -d ' ' \
+	| sed 's/kernel-image-//')"
+
+[ -h /boot/vmlinuz ] || ln -s vmlinuz-$kver /boot/vmlinuz
+[ -h /boot/initrd.img ] || ln -s initrd-$kver.img /boot/initrd.img
+
+# NB: mkinitrd-3.0.16+ has rootsubdir support which is critical
+#     for TWRP based ARM "VE" chroots (e.g. for nexus7);
+#     should be implemented in make-initrd either
+
+### rootfs type should become configurable
+if rpm -q mkinitrd; then
+	mkinitrd --with ext4 -f /boot/initrd-$kver.img "$kver"
+fi
+
+# NB: if the adresses ever become different this "API" _will_ change
+# NB: initrd compression (-C) might change, armadaxp handles gzip
+umk() {
+	[ $# = 4 ] || exit 1
+	cd /boot
+	umkimage \
+		-A arm \
+		-O linux \
+		-T "$1" \
+		-C none \
+		-a "$2" \
+		-e "$2" \
+		-n "`readlink "$3"`" \
+		-d "$3" \
+		"$4"
+}
+
+### the addresses will become variables some day probably
+if rpm -q uboot-tools; then
+	umk kernel 0x00008000 vmlinuz uimage
+	umk ramdisk 0x00800000 initrd.img uinitrd
+	if [ -s boot ]; then
+		umk script 0 boot boot.scr
+	fi
+fi
+
+:

features.in/armh/rootfs/image-scripts.d/50-network

@@ -0,0 +1,40 @@
+#!/bin/sh
+
+#     DESCRIPTION
+#
+# Setup network settings
+# 1. Truncate /etc/resolv.conf
+# 2. Init /etc/hosts with "127.0.0.1 localhost"
+# 3. Set hostname, domainname
+# 4. Set defaults for NetworkManager.
+
+
+#     REQUIRES
+#
+# Nothing
+
+
+#     INFO
+# At startup time hostname may be changed by live-hostname package.
+
+. shell-config
+
+NAME="init3-network"
+
+verbose()
+{
+    if [ -n "$GLOBAL_VERBOSE" ]; then
+        echo "HOOK: $NAME: $@"
+    fi
+}
+
+verbose "has started"
+
+DOMAINNAME="localdomain"
+HOSTNAME="localhost.localdomain"
+
+verbose "Init /etc/hosts with 127.0.0.1 localhost"
+echo "127.0.0.1 localhost localhost.localdomain" > /etc/hosts
+
+verbose "Truncate /etc/resolv.conf"
+echo nameserver 8.8.8.8 >/etc/resolv.conf

features.in/armh/rootfs/image-scripts.d/91-unsigned-repo

@@ -0,0 +1,7 @@
+#!/bin/sh
+# Sisyphus/armh is not being signed as of June, 2013
+
+repo_source='/etc/apt/sources.list.d/alt.list'
+[ -s "$repo_source" ] || exit 0
+
+sed -i 's, \[alt\],,' "$repo_source" ||:

features.in/bootloader/README

@@ -5,5 +5,14 @@
 систему (он НЕ должен требоваться пакету installer-distro-*)
 и требует пакет выбранного загрузчика.
 
-Реализация экспериментальная (нужно модуляризовать installer-steps),
-завязана на installer-distro-altlinux-generic = 6.0-alt2.
+Обратите внимание: в процессе конфигурирования дистрибутива
+"переключение" загрузчика может происходить только в одну сторону
+-- если выставлен grub, произведено переключение на lilo и затем
+произведена ещё одна попытка переключения на grub, то в конфигурации
+останется lilo как последняя "новая" цель с точки зрения make.
+
+При необходимости всё-таки "пересилить" последнее изменение можно
+
+	@$(call set,BASE_BOOTLOADER,grub_или_lilo)
+
+Реализация экспериментальная (нужно модуляризовать installer-steps).

features.in/bootloader/config.mk

@@ -1,9 +1,12 @@
 # TODO: invent something prettier (think "lilo+grub" -- or error out?)
 # - add,BASE_PACKAGES,alterator-$* is overly additive
+#   NB: due to make target becoming having been made,
+#       the last different one wins
 # - remember .base if adding yet another *_PACKAGES
 
-use/bootloader: use/install2 sub/main
-	@$(call add,BASE_PACKAGES,alterator-$$(GLOBAL_BASE_BOOTLOADER))
+use/bootloader:
+	@$(call add_feature)
+	@$(call add,BASE_PACKAGES,alterator-$$(BASE_BOOTLOADER))
 
 use/bootloader/grub use/bootloader/lilo: use/bootloader/%: use/bootloader
-	@$(call set,GLOBAL_BASE_BOOTLOADER,$*)
+	@$(call set,BASE_BOOTLOADER,$*)

features.in/bootloader/install2/image-scripts.d/00-check-bootloader

@@ -0,0 +1,6 @@
+#!/bin/sh
+
+if [ -z "$GLOBAL_BASE_BOOTLOADER" ]; then
+	echo "** error: BASE_BOOTLOADER empty while bootloader feature requested" >&2
+	exit 1
+fi

features.in/branding/README

@@ -0,0 +1,26 @@
+Эта фича врезается в makefile субпрофилей и обеспечивает
+добавление задающих внешний вид и сообщения дистрибутива
+пакетов; см. тж. http://www.altlinux.org/Branding
+
+Реализация "двумерная" -- отдельно задаётся BRANDING
+(см. пакеты branding-*-%version-%release.src.rpm),
+затем отдельно указывается, какие и куда помещать
+компоненты заданного брендинга.
+
+Назначение и возможные значения (если требуются):
+
+* STAGE1_BRANDING
+** относится к загрузке со сгенерированного образа (например, ISO)
+** bootloader bootsplash (при старте)
+
+* STAGE2_BRANDING
+** общая часть для всех вариантов stage2
+** bootsplash (при выключении)
+
+* INSTALL2_BRANDING
+** специфические пакеты брендирования инсталятора
+** notes slideshow
+
+* THE_BRANDING
+** общий список для использования в установленной системе и LiveCD
+** alterator bootsplash graphics indexhtml notes slideshow

features.in/branding/config.mk

@@ -0,0 +1,16 @@
+# NB: release part of branding goes to install2 feature
+use/branding:
+	@$(call add_feature)
+
+# NB: not every distro might have all the branding of its own
+use/branding/full: use/branding use/syslinux/ui/gfxboot
+	@$(call add,THE_BRANDING,alterator bootloader bootsplash graphics)
+	@$(call add,THE_BRANDING,indexhtml notes slideshow)
+
+use/branding/complete: use/branding/full use/plymouth/full
+	@$(call add,INSTALL2_BRANDING,notes slideshow)
+
+# http://altlinux.org/branding/slideshow
+use/branding/slideshow/once: use/branding
+	@$(call add,INSTALL2_BRANDING_SLIDESHOW,once:true)
+	@$(call xport,INSTALL2_BRANDING_SLIDESHOW)

features.in/branding/install2/image-scripts.d/50-branding.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+
+[ -n "$GLOBAL_INSTALL2_BRANDING_SLIDESHOW" ] || exit 0
+
+for arg in $GLOBAL_INSTALL2_BRANDING_SLIDESHOW; do
+	echo "${arg/:/=}" >> /etc/alterator/slideshow.conf
+done

features.in/branding/install2/lib/50branding.mk

@@ -0,0 +1,2 @@
+IMAGE_PACKAGES_REGEXP += $(call branding, \
+				$(STAGE2_BRANDING) $(INSTALL2_BRANDING))

features.in/branding/lib/20-branding.mk

@@ -0,0 +1,7 @@
+# step 4: build the distribution image
+# NB: this comes just before build-distro.mk
+
+DOT_BASE += $(call branding,$(THE_BRANDING))
+
+CHROOT_PACKAGES_REGEXP += $(call branding,bootloader)
+CHROOT_PACKAGES += ImageMagick-tools

features.in/branding/live/lib/50branding.mk

@@ -0,0 +1,2 @@
+IMAGE_PACKAGES_REGEXP += $(call branding, \
+				$(THE_BRANDING) $(STAGE2_BRANDING))

features.in/branding/main/lib/50branding.mk

@@ -0,0 +1 @@
+IMAGE_PACKAGES_REGEXP += $(call branding,$(THE_BRANDING))

features.in/branding/stage1/lib/50branding.mk

@@ -0,0 +1 @@
+CHROOT_PACKAGES_REGEXP += $(call branding,$(STAGE1_BRANDING))

features.in/browser/README

@@ -0,0 +1,6 @@
+Эта фича обеспечивает наличие и конкретизацию выбора браузера.
+Разумеется, дополнительные варианты могут быть установлены
+явным или косвенным затребованием.
+
+Следует понимать, что каждая из целей может быть использована
+лишь один раз, повторное упоминание будет проигнорировано make.

features.in/browser/config.mk

@@ -0,0 +1,38 @@
+use/browser:
+	@$(call add_feature)
+	@$(call add,THE_PACKAGES_REGEXP,$$(THE_BROWSER))
+	@$(call try,THE_BROWSER,webclient)	# fallback
+
+use/browser/firefox use/browser/seamonkey \
+	use/browser/chromium use/browser/epiphany \
+	use/browser/qupzilla use/browser/rekonq \
+	use/browser/elinks use/browser/links2: \
+	use/browser/%: use/browser
+	@$(call set,THE_BROWSER,$*)
+
+use/browser/konqueror: use/browser
+	@$(call set,THE_BROWSER,kdebase-konqueror)
+
+use/browser/konqueror4: use/browser
+	@$(call set,THE_BROWSER,kde4base-konqueror)
+
+use/browser/firefox/live: use/browser/firefox
+	@$(call add,THE_BROWSER,livecd-firefox)
+
+# scarey, and will have to be done otherwise when l10n feature is there
+use/browser/firefox/i18n: use/browser/firefox
+	@$(call add,THE_BROWSER,firefox-be firefox-kk firefox-ru firefox-uk)
+
+# fx29+
+use/browser/firefox/classic: use/browser/firefox
+	@$(call add,THE_BROWSER,firefox-classic_theme_restorer.*)
+
+use/browser/seamonkey/i18n: use/browser/seamonkey
+	@$(call add,THE_BROWSER,seamonkey-ru)
+
+# inherently insecure, NPAPI only
+use/browser/plugin/flash: use/browser
+	@$(call add,THE_PACKAGES,mozilla-plugin-adobe-flash)
+
+use/browser/plugin/java: use/browser
+	@$(call add,THE_PACKAGES,mozilla-plugin-java-1.6.0-sun)

features.in/build-distro/README

@@ -0,0 +1,11 @@
+Эта фича конфигурирует создание образа дистрибутива, включая работу
+с субпрофилями -- которая сейчас нужна только дистрибутивным целям.
+
+Дополняет финальную стадию сборки (lib/, scripts.d/)
+и тесно с ней связана.
+
+При желании более полно воспользоваться доступными средствами
+фиксации метаданных обратите внимание на следующие переменные:
+META_SYSTEM_ID, META_PUBLISHER, META_PREPARER, META_APP_ID,
+META_VOL_ID, META_VOL_SET, META_BIBLIO, META_ABSTRACT;
+см. тж. genisoimagerc(5) из пакета genisoimage.

features.in/build-distro/config.mk

@@ -0,0 +1,3 @@
+# hooked from lib/sugar.mk
+use/build-distro:
+	@$(call add_feature)

features.in/build-distro/lib/90-build-distro.mk

@@ -0,0 +1,35 @@
+# step 4: build the distribution image
+
+# take the latter part for complex-specified subprofiles like stage2@live;
+# care to exclude non-directories holding no makefiles like rootfs
+SUBDIRS = $(sort $(dir $(wildcard $(addsuffix /Makefile,$(SUBPROFILE_DIRS)))))
+
+# proxy over the ISO metadata collected; see also genisoimagerc(5)
+BOOT_SYSI := $(META_SYSTEM_ID)
+BOOT_PUBL := $(META_PUBLISHER)
+BOOT_PREP := $(META_PREPARER)
+BOOT_APPI := $(META_APP_ID)
+BOOT_VOLI := $(shell echo $(META_VOL_ID) | cut -c1-32)
+BOOT_VOLS := $(META_VOL_SET)
+BOOT_BIBL := $(META_BIBLIO)
+BOOT_ABST := $(META_ABSTRACT)
+DATE_F    := $(shell date +%F)
+
+BOOT_TYPE := isolinux
+
+all: $(GLOBAL_DEBUG) prep copy-subdirs copy-tree run-scripts pack-image \
+	postprocess $(GLOBAL_CLEAN_WORKDIR)
+
+prep: $(GLOBAL_DEBUG) dot-disk $(WHATEVER)
+
+# can't use mp-showref which belongs to the metaprofile
+dot-disk:
+	@mkdir -p files/.disk
+	@echo "$(META_VOL_ID) $(DATE_F)" >files/.disk/info
+	@echo "$(ARCH)" >files/.disk/arch
+	@echo "$(DATE)" >files/.disk/date
+	@if type -t git >&/dev/null; then \
+		( cd $(TOPDIR) && test -d .git && \
+		git show-ref --head -ds -- HEAD ||:) \
+		>files/.disk/commit 2>/dev/null; \
+	fi

features.in/build-distro/scripts.d/00-cleanup

@@ -1,4 +1,4 @@
 #!/bin/sh
 # TODO: invent some way to remove this inter-subprofile thing
 
-rm -vf $WORKDIR/{squashcfg.mk,initfs}
+rm -vf $WORKDIR/{squashcfg.mk,initfs,.gitignore}

features.in/build-ve/README

@@ -0,0 +1,5 @@
+Эта фича конфигурирует создание образа виртуального окружения (VE),
+что используется для сборки шаблонов OpenVZ и ARM-чрутов для TWRP.
+
+Дополняет финальную стадию сборки (lib/, image-scripts.d/)
+и тесно с ней связана.

features.in/build-ve/config.mk

@@ -0,0 +1,3 @@
+# hooked from lib/sugar.mk
+use/build-ve: sub/rootfs@/
+	@$(call add_feature)

features.in/build-ve/image-scripts.d/03-services

@@ -0,0 +1,13 @@
+#!/bin/sh
+# VEs typically have no means to communicate with the outer
+# world except for networking; still this might need some
+# more tweaking for networkless LXC case
+
+# candidates:
+# off: keytable
+
+[ -x /sbin/chkconfig ] || exit 0
+
+for i in network random syslogd; do chkconfig $i on; done
+for i in fbsetfont netfs rawdevices; do chkconfig $i off; done
+:

features.in/build-ve/image-scripts.d/04-inittab

@@ -0,0 +1,4 @@
+#!/bin/sh -e
+# we don't need no gettys in OpenVZ VEs (might need one in LXC though)
+[ -s /etc/inittab ] || exit 0
+sed -i 's,^[0-9]\+:[0-9]\+:respawn:/sbin/mingetty.*,#&,' /etc/inittab

features.in/build-ve/image-scripts.d/05-mtab

@@ -0,0 +1,3 @@
+#!/bin/sh -e
+# should be pretty much obsolete but just in case
+[ -L /etc/mtab ] || ln -sf /proc/mounts /etc/mtab

features.in/build-ve/image-scripts.d/06-syslog

@@ -0,0 +1,16 @@
+#!/bin/sh -e
+# tweak syslog configuration to:
+# - avoid logging to a nonexistent tty;
+# - avoid hard sync logging (one is better off doing
+#   remote syslog if you do care for reliable data anyways)
+# credits: vvk@, thresh@ (2010)
+
+CONFIG=/etc/syslog.conf
+
+[ ! -f "$CONFIG" ] || \
+	sed -i \
+		-e 's,/dev/tty12,/var/log/syslog/console,' \
+		-e 's,^.*/var/log/syslog/console$,#&,' \
+		-e 's,-/var/log/,/var/log/,g' \
+		-e 's,/var/log/,-/var/log/,g' \
+		"$CONFIG"

features.in/build-ve/image-scripts.d/07-fstab

@@ -0,0 +1,6 @@
+#!/bin/sh
+
+[ -s /etc/fstab ] || cat >> /etc/fstab <<-EOF
+proc /proc proc nosuid,noexec,gid=proc 0 0
+devpts /dev/pts devpts gid=5,mode=620 0 0
+EOF

features.in/build-ve/image-scripts.d/08-resolv

@@ -0,0 +1,9 @@
+#!/bin/sh
+# by default hasher copy resolv.conf and /etc/hosts from host system
+# we need to change it to useful defaults
+
+echo 'nameserver 8.8.8.8' > /etc/resolv.conf
+echo 'nameserver 8.8.4.4' > /etc/resolv.conf
+#echo 'nameserver 2001:4860:4860::8888' > /etc/resolv.conf
+#echo 'nameserver 2001:4860:4860::8844' > /etc/resolv.conf
+echo '127.0.0.1 localhost.localdomain localhost' > /etc/hosts

features.in/build-ve/lib/90-build-ve.mk

@@ -0,0 +1,21 @@
+# step 4: build the virtual environment image
+
+ifeq (tar,$(IMAGE_PACKTYPE))
+MKI_TAR_COMPRESS = $(IMAGE_COMPRESS)
+endif
+
+ifeq (cpio,$(IMAGE_PACKTYPE))
+MKI_CPIO_COMPRESS = $(IMAGE_COMPRESS)
+endif
+
+# some VEs _can_ contain kernels (think ARM multiboot
+# but this can also help VE/VM hybrid images)
+IMAGE_PACKAGES = $(DOT_BASE) \
+		 $(SYSTEM_PACKAGES) \
+		 $(COMMON_PACKAGES) \
+		 $(BASE_PACKAGES) \
+		 $(THE_PACKAGES) \
+		 $(call list,$(BASE_LISTS) $(THE_LISTS))
+
+all: $(GLOBAL_DEBUG) build-image copy-tree run-image-scripts pack-image \
+	postprocess $(GLOBAL_CLEAN_WORKDIR)

features.in/build-vm/README

@@ -0,0 +1,3 @@
+Эта фича конфигурирует создание образа виртуальной машины (VM).
+Дополняет финальную стадию сборки (lib/, image-scripts.d/).
+Требует для работы sudo(8) -- см. тж. doc/vm.txt

features.in/build-vm/config.mk

@@ -0,0 +1,3 @@
+# hooked from lib/sugar.mk
+use/build-vm: sub/rootfs@/ use/kernel
+	@$(call add_feature)