From ef0d5e15813a65ad42c374e2eac7f2a20eb4159f Mon Sep 17 00:00:00 2001 From: Michael Shigorin Date: Sun, 11 Sep 2011 18:02:17 +0300 Subject: [PATCH] doc/: minor update Somewhat more uniform style and a few additional bits. --- doc/assumptions.txt | 2 ++ doc/debug.txt | 2 ++ doc/features.txt | 6 +++++- doc/variables.txt | 6 ++++++ 4 files changed, 15 insertions(+), 1 deletion(-) diff --git a/doc/assumptions.txt b/doc/assumptions.txt index 396d3ffd..30a0375f 100644 --- a/doc/assumptions.txt +++ b/doc/assumptions.txt @@ -1,3 +1,5 @@ +предположения фрагментов кода об окружении +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - pkg.in/lists/Makefile + ожидает, что названия пакаджлистов указываются в переменных вида *_LISTS, и копирует в генерируемый профиль только их diff --git a/doc/debug.txt b/doc/debug.txt index e4c9eef1..78f12fe6 100644 --- a/doc/debug.txt +++ b/doc/debug.txt @@ -1,3 +1,5 @@ +ловля плюх +~~~~~~~~~~ При отладке сборки конфигурации или самого дистрибутива могут оказаться полезными следующие средства: diff --git a/doc/features.txt b/doc/features.txt index 42d2a536..6d349337 100644 --- a/doc/features.txt +++ b/doc/features.txt @@ -1,3 +1,5 @@ +фичи +~~~~ Особенности дистрибутива, не учитываемые в пакетной базе или зависящие от переменных времени сборки/установки образа, могут быть оформлены несколькими образами: @@ -18,7 +20,9 @@ * необходимы пакетные зависимости; * требуется компилируемый платформозависимый код (для чего бы...); * код фичи достаточно специфичен, нетривиален и объёмен, - чтобы загромождать метапрофиль было не очень осмысленно. + чтобы загромождать метапрофиль было не очень осмысленно; +* фича представляет из себя отдельный мини-продукт, над которым + ведётся активная работа (возможно, несколькими людьми). Стоит избегать изменения пакетных умолчаний в случае, когда их представляется осмысленным и возможным скорректировать в пакете: diff --git a/doc/variables.txt b/doc/variables.txt index e1bd800c..62c264ae 100644 --- a/doc/variables.txt +++ b/doc/variables.txt @@ -1,3 +1,5 @@ +переменные make +~~~~~~~~~~~~~~~ При запуске на сборку принимается ряд переменных (см. тж. profiles.mk.sample): @@ -27,3 +29,7 @@ + включение средств отладки + значение: пусто (по умолчанию), 1 или 2 + см. log.mk + +пример +~~~~~~ +make DEBUG=1 CLEAN=1 syslinux.iso