minor documentation facelift

A few more items were asking for some attention.

In particular, build examples should start with
the most basic, error-proof and quick targets.

QUICKSTART

@@ -1,5 +1,5 @@
-English quickstart: make server-mini.iso; see also
-http://en.altlinux.org/Hasher (a large tmpfs is nice).
+English quickstart: make syslinux.iso (after setting up
+http://en.altlinux.org/Hasher; large tmpfs helps a lot).
 
 требуется
 ~~~~~~~~~
@@ -27,11 +27,11 @@ $ git config --global user.name "My Name"
 $ mkdir ~/out
 
 - тестовая сборка (см. тж. lib/distro.mk, doc/params.txt):
-$ make icewm.iso
+$ make syslinux.iso
 
 ссылки
 ~~~~~~
 - http://www.altlinux.org/tmpfs
 - http://www.altlinux.org/hasher
 - http://www.altlinux.org/mkimage
-- http://www.altlinux.org/Mkimage/Profiles/m-p
+- http://www.altlinux.org/m-p

README

@@ -7,11 +7,6 @@ License: GPLv2+, see COPYING
 
 Most docs are in Russian, welcome to learn it or ask for English.
 
-См. тж. http://www.altlinux.org/Mkimage/Profiles/m-p и doc/*.txt:
-- params.txt: переменные, указываемые при запуске сборки
-- features.txt: обзор подключаемых особенностей
-- pkglists.txt: формирование состава образа
-
 Задача:
 - конфигурирование и создание образов на базе ALT Linux
 
@@ -60,3 +55,10 @@ Most docs are in Russian, welcome to learn it or ask for English.
   + либо ~/out/ (если возможно),
   + или $(BUILDDIR)/out/ иначе
 - формируются отчёты, если запрошены (REPORT)
+
+См. тж.:
+- http://altlinux.org/m-p
+- doc/:
+  + params.txt: переменные, указываемые при запуске сборки
+  + pkglists.txt: формирование состава образа
+  + features.txt: обзор подключаемых особенностей

doc/style.txt

@@ -2,7 +2,7 @@
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 * постарайтесь не вносить без обсуждения разнобой стилей,
   если есть предметные пожелания по коррекции текущего --
-  пишите в devel-distro@, обсудим;
+  пишите в devel-distro@ или мне (mike@), обсудим;
 
 * перед тем, как делать существенные переработки уже имеющегося
   кода -- опять же опишите проблему, идею и предполагаемый результат,

doc/vm.txt

@@ -3,15 +3,18 @@
 ВНИМАНИЕ: заключительная операция создания образа жёсткого диска
 из архива с содержимым корневой файловой системы требует доступа
 к sudo и разрешения на выполнение скрипта bin/tar2vm в корневом
-каталоге метапрофиля при установке mkimage-profiles из пакета.
+каталоге метапрофиля при установке mkimage-profiles из пакета
+(это в планах исправить, но подход к libguestfs пока успехом
+не увенчался).
 
 Соответствующий фрагмент конфигурации sudo(8) может выглядеть как:
 
 mike ALL=NOPASSWD: /usr/share/mkimage-profiles/bin/tar2vm
 
-При работе с git следует иметь в виду, что предоставлять недоверенному
-пользователю право выполнять с повышенными привилегиями доступный ему
-по записи скрипт равнозначно предоставлению полных привилегий root.
+При работе с локальной копией mkimage-profiles.git следует иметь
+в виду, что предоставлять недоверенному пользователю право выполнять
+от имени root доступный ему по записи скрипт равнозначно предоставлению
+полных привилегий root.
 
 Для работы с более специфичными форматами, чем raw ("буквальный"
 образ диска), потребуется утилита qemu-img из одноименного пакета;