Commit eb3df648 authored by Michael Shigorin's avatar Michael Shigorin

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.
parent d646e719
English quickstart: make server-mini.iso; see also English quickstart: make syslinux.iso (after setting up
http://en.altlinux.org/Hasher (a large tmpfs is nice). http://en.altlinux.org/Hasher; large tmpfs helps a lot).
требуется требуется
~~~~~~~~~ ~~~~~~~~~
...@@ -27,11 +27,11 @@ $ git config --global user.name "My Name" ...@@ -27,11 +27,11 @@ $ git config --global user.name "My Name"
$ mkdir ~/out $ mkdir ~/out
- тестовая сборка (см. тж. lib/distro.mk, doc/params.txt): - тестовая сборка (см. тж. lib/distro.mk, doc/params.txt):
$ make icewm.iso $ make syslinux.iso
ссылки ссылки
~~~~~~ ~~~~~~
- http://www.altlinux.org/tmpfs - http://www.altlinux.org/tmpfs
- http://www.altlinux.org/hasher - http://www.altlinux.org/hasher
- http://www.altlinux.org/mkimage - http://www.altlinux.org/mkimage
- http://www.altlinux.org/Mkimage/Profiles/m-p - http://www.altlinux.org/m-p
...@@ -7,11 +7,6 @@ License: GPLv2+, see COPYING ...@@ -7,11 +7,6 @@ License: GPLv2+, see COPYING
Most docs are in Russian, welcome to learn it or ask for English. 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 - конфигурирование и создание образов на базе ALT Linux
...@@ -60,3 +55,10 @@ Most docs are in Russian, welcome to learn it or ask for English. ...@@ -60,3 +55,10 @@ Most docs are in Russian, welcome to learn it or ask for English.
+ либо ~/out/ (если возможно), + либо ~/out/ (если возможно),
+ или $(BUILDDIR)/out/ иначе + или $(BUILDDIR)/out/ иначе
- формируются отчёты, если запрошены (REPORT) - формируются отчёты, если запрошены (REPORT)
См. тж.:
- http://altlinux.org/m-p
- doc/:
+ params.txt: переменные, указываемые при запуске сборки
+ pkglists.txt: формирование состава образа
+ features.txt: обзор подключаемых особенностей
...@@ -2,7 +2,7 @@ ...@@ -2,7 +2,7 @@
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* постарайтесь не вносить без обсуждения разнобой стилей, * постарайтесь не вносить без обсуждения разнобой стилей,
если есть предметные пожелания по коррекции текущего -- если есть предметные пожелания по коррекции текущего --
пишите в devel-distro@, обсудим; пишите в devel-distro@ или мне (mike@), обсудим;
* перед тем, как делать существенные переработки уже имеющегося * перед тем, как делать существенные переработки уже имеющегося
кода -- опять же опишите проблему, идею и предполагаемый результат, кода -- опять же опишите проблему, идею и предполагаемый результат,
......
...@@ -3,15 +3,18 @@ ...@@ -3,15 +3,18 @@
ВНИМАНИЕ: заключительная операция создания образа жёсткого диска ВНИМАНИЕ: заключительная операция создания образа жёсткого диска
из архива с содержимым корневой файловой системы требует доступа из архива с содержимым корневой файловой системы требует доступа
к sudo и разрешения на выполнение скрипта bin/tar2vm в корневом к sudo и разрешения на выполнение скрипта bin/tar2vm в корневом
каталоге метапрофиля при установке mkimage-profiles из пакета. каталоге метапрофиля при установке mkimage-profiles из пакета
(это в планах исправить, но подход к libguestfs пока успехом
не увенчался).
Соответствующий фрагмент конфигурации sudo(8) может выглядеть как: Соответствующий фрагмент конфигурации sudo(8) может выглядеть как:
mike ALL=NOPASSWD: /usr/share/mkimage-profiles/bin/tar2vm mike ALL=NOPASSWD: /usr/share/mkimage-profiles/bin/tar2vm
При работе с git следует иметь в виду, что предоставлять недоверенному При работе с локальной копией mkimage-profiles.git следует иметь
пользователю право выполнять с повышенными привилегиями доступный ему в виду, что предоставлять недоверенному пользователю право выполнять
по записи скрипт равнозначно предоставлению полных привилегий root. от имени root доступный ему по записи скрипт равнозначно предоставлению
полных привилегий root.
Для работы с более специфичными форматами, чем raw ("буквальный" Для работы с более специфичными форматами, чем raw ("буквальный"
образ диска), потребуется утилита qemu-img из одноименного пакета; образ диска), потребуется утилита qemu-img из одноименного пакета;
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment