keremet/mkimage-profiles
2
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
48239f73e8
mkimage-profiles/conf.d/README

69 lines
5.0 KiB
Plaintext
Raw Normal View History

added asciidoc support
2012-10-31 01:21:23 +04:00
== conf.d ==
README update These have been proofread somewhat to correspond to the current state of affairs; a missing one was added for fonts feature.
2013-06-10 17:37:16 +04:00
introduced conf.d/ for distro, ve config snippets This was asked for by Leo-sp50 and torabora, and seems quite reasonable: let's provide means to keep at least some distribution configurations a bit apart, so that these can be considered more standalone in terms of hard warranted functionality but at the same time enjoying the common infrastructure. Considering lib/distro.mk: it's now experimentally pulled apart so that parallel development of different distro families can go on without major merge hassles. *Please* don't abuse with massive copy-paste. And before you ask: this might get extended to allow for "private" out-of-tree configurations being included since apparently there are goals with no meaning outside of some very particular context... but otherwise I'd like to encourage getting reusable bits in-tree.
2011-10-31 14:40:02 +04:00
Этот каталог содержит включаемые фрагменты конфигурации образов с тем,
README update These have been proofread somewhat to correspond to the current state of affairs; a missing one was added for fonts feature.
2013-06-10 17:37:16 +04:00
чтобы было удобнее параллельно разрабатывать специфические образы
без излишних merge conflict'ов.
introduced conf.d/ for distro, ve config snippets This was asked for by Leo-sp50 and torabora, and seems quite reasonable: let's provide means to keep at least some distribution configurations a bit apart, so that these can be considered more standalone in terms of hard warranted functionality but at the same time enjoying the common infrastructure. Considering lib/distro.mk: it's now experimentally pulled apart so that parallel development of different distro families can go on without major merge hassles. *Please* don't abuse with massive copy-paste. And before you ask: this might get extended to allow for "private" out-of-tree configurations being included since apparently there are goals with no meaning outside of some very particular context... but otherwise I'd like to encourage getting reusable bits in-tree.
2011-10-31 14:40:02 +04:00
Следует понимать, что основная цель появления mkimage-profiles на свет
-- это уменьшение "форков" внутри семейства дистрибутивных профилей.
Поэтому при возможности следует всё-таки работать над общей базовой
частью, включая скриптовые хуки и списки пакетов, а также оптимизировать
full-view docs update - toplevel README received some long-needed refactoring + lowlevel detail moved, well, to lowlevel READMEs - reflected more thoroughly that m-p is not about distros anymore - dropped features.in/00example/README.en: it's already out-of-date a bit, and there's no perceived need in thorough English docs so far - wiki article got split into parts and somewhat rewritten, links updated - mv doc/{CodingStyle,style.txt}
2011-11-06 23:57:28 +04:00
граф зависимостей между конфигурациями образов.
introduced conf.d/ for distro, ve config snippets This was asked for by Leo-sp50 and torabora, and seems quite reasonable: let's provide means to keep at least some distribution configurations a bit apart, so that these can be considered more standalone in terms of hard warranted functionality but at the same time enjoying the common infrastructure. Considering lib/distro.mk: it's now experimentally pulled apart so that parallel development of different distro families can go on without major merge hassles. *Please* don't abuse with massive copy-paste. And before you ask: this might get extended to allow for "private" out-of-tree configurations being included since apparently there are goals with no meaning outside of some very particular context... but otherwise I'd like to encourage getting reusable bits in-tree.
2011-10-31 14:40:02 +04:00
Попросту говоря, copy-paste -- тревожный признак.
conf.d: updated README to mention mixin/* The mixin concept and name has been borrowed from Ruby language -- it's a kind of thing that can be added to more or less whatever suitable; the problem it tries to solve is that incrementally building up the image configuration breaks when one would like to change something that's been configured in early enough so that grafting early will warrant a lot of duplication later on but inheriting too much things that need to be changed gets too much hackery in. It started while trying to build an installer image using configuration bits and pieces collected while bringing an installable LiveCD together: there are just too many livecdish things in a LiveCD to try and rebase the actual desktop configuration things onto an installer, so putting these into a mixin to be reused within both livecd and installer seems the way to go.
2014-03-21 20:52:01 +04:00
Вместо него нередко может помочь выделение кусочков конфигурации
в пределах включаемого файла в цели mixin/*, которые не являются
самостоятельными или даже промежуточными, но включают полезные
группы настроек, нужных в различных образах, не наследующих
друг другу -- посмотрите существующие примеры использования.
documentation: use paths relative to toplevel dir This change is done to reduce ambiguity in some cases; the previous intention has been to ease navigation when staying in a particular directory, now it's been changed in favour of convenient toplevel `git grep' in fact. Both variants have their pros and cons, I just find myself leaning to this one by now hence the commit. Feel free to provide constructive criticism :) Some path-related bitrot has also been fixed while at that.
2014-03-05 18:09:56 +04:00
По переменным (см. тж. doc/pkglists.txt):
docs updated Minor tweaks to toplevel docs as well as some doc/*.txt, doc/variables.txt renamed to doc/params.txt, and a brand new doc/pkglists.txt is added (thanks manowar@ for his considerations).
2012-06-25 15:52:56 +04:00
README update These have been proofread somewhat to correspond to the current state of affairs; a missing one was added for fonts feature.
2013-06-10 17:37:16 +04:00
* для пользовательского окружения (live, main) предназначены
docs updated Minor tweaks to toplevel docs as well as some doc/*.txt, doc/variables.txt renamed to doc/params.txt, and a brand new doc/pkglists.txt is added (thanks manowar@ for his considerations).
2012-06-25 15:52:56 +04:00
THE_PACKAGES, THE_LISTS, THE_GROUPS, THE_PACKAGES_REGEXP
README update These have been proofread somewhat to correspond to the current state of affairs; a missing one was added for fonts feature.
2013-06-10 17:37:16 +04:00
* для "обычного общего" (live, main, rescue) есть COMMON_PACKAGES
docs updated Minor tweaks to toplevel docs as well as some doc/*.txt, doc/variables.txt renamed to doc/params.txt, and a brand new doc/pkglists.txt is added (thanks manowar@ for his considerations).
2012-06-25 15:52:56 +04:00
(NB: тоже попадают в базовую установку)
README update These have been proofread somewhat to correspond to the current state of affairs; a missing one was added for fonts feature.
2013-06-10 17:37:16 +04:00
* SYSTEM_PACKAGES стоит применять крайне осторожно -- эти пакеты попадут
full-view docs update - toplevel README received some long-needed refactoring + lowlevel detail moved, well, to lowlevel READMEs - reflected more thoroughly that m-p is not about distros anymore - dropped features.in/00example/README.en: it's already out-of-date a bit, and there's no perceived need in thorough English docs so far - wiki article got split into parts and somewhat rewritten, links updated - mv doc/{CodingStyle,style.txt}
2011-11-06 23:57:28 +04:00
во все стадии, в том числе в образ чувствительной к объёму install2
(в stage1 -- только в инструментальный чрут); применяйте для того,
introduced THE_{KMODULES,PACKAGES,LISTS,GROUPS} As too many things started duplicating between distros proper and (e.g. corresponding) LiveCDs, it became apparent that a class of entities which end up working for THE_USER (not a sysadmin, and not a developer, just a Linux user) is in need. So THE_KMODULES will power installed basesystem and live image, while THE_PACKAGES, THE_LISTS and THE_GROUPS will participate in building those.
2011-12-19 23:28:42 +04:00
что обязано быть и в инсталяторе, и в готовой системе
docs updated Minor tweaks to toplevel docs as well as some doc/*.txt, doc/variables.txt renamed to doc/params.txt, and a brand new doc/pkglists.txt is added (thanks manowar@ for his considerations).
2012-06-25 15:52:56 +04:00
README update These have been proofread somewhat to correspond to the current state of affairs; a missing one was added for fonts feature.
2013-06-10 17:37:16 +04:00
* для направленного действия служат:
** 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
full-view docs update - toplevel README received some long-needed refactoring + lowlevel detail moved, well, to lowlevel READMEs - reflected more thoroughly that m-p is not about distros anymore - dropped features.in/00example/README.en: it's already out-of-date a bit, and there's no perceived need in thorough English docs so far - wiki article got split into parts and somewhat rewritten, links updated - mv doc/{CodingStyle,style.txt}
2011-11-06 23:57:28 +04:00
docs updated Minor tweaks to toplevel docs as well as some doc/*.txt, doc/variables.txt renamed to doc/params.txt, and a brand new doc/pkglists.txt is added (thanks manowar@ for his considerations).
2012-06-25 15:52:56 +04:00
Не стоит бояться такого разнообразия, для большинства задач достаточно THE_*.
full-view docs update - toplevel README received some long-needed refactoring + lowlevel detail moved, well, to lowlevel READMEs - reflected more thoroughly that m-p is not about distros anymore - dropped features.in/00example/README.en: it's already out-of-date a bit, and there's no perceived need in thorough English docs so far - wiki article got split into parts and somewhat rewritten, links updated - mv doc/{CodingStyle,style.txt}
2011-11-06 23:57:28 +04:00
По подстановкам:
README update These have been proofread somewhat to correspond to the current state of affairs; a missing one was added for fonts feature.
2013-06-10 17:37:16 +04:00
* $(VAR) подставляются перед их записью в $(CONFIG), который distcfg.mk
* $$(VAR) раскрываются позже, при включении $(CONFIG) и востребовании
introduced THE_{KMODULES,PACKAGES,LISTS,GROUPS} As too many things started duplicating between distros proper and (e.g. corresponding) LiveCDs, it became apparent that a class of entities which end up working for THE_USER (not a sysadmin, and not a developer, just a Linux user) is in need. So THE_KMODULES will power installed basesystem and live image, while THE_PACKAGES, THE_LISTS and THE_GROUPS will participate in building those.
2011-12-19 23:28:42 +04:00
значений; в этом случае их значения могут изменяться до окончания
конфигурации, а также зависеть от значений других переменных
READMEs: pkglist related clarification glebfm@ asked what to do with new package lists: whether these belong to features, or to distributions themselves. This question is actually open and up for discussion but there are guidelines that can and should be written down already; and so they were. Added pkgdups utility reference as well.
2012-04-09 23:18:31 +04:00
По спискам пакетов:
README update These have been proofread somewhat to correspond to the current state of affairs; a missing one was added for fonts feature.
2013-06-10 17:37:16 +04:00
* на этапе экспериментирования можно забивать прямо в описание образа
* при фиксации состояния стоит воспользоваться существующими списками,
READMEs: pkglist related clarification glebfm@ asked what to do with new package lists: whether these belong to features, or to distributions themselves. This question is actually open and up for discussion but there are guidelines that can and should be written down already; and so they were. Added pkgdups utility reference as well.
2012-04-09 23:18:31 +04:00
а дополнительные оформить как можно более чётко обособленными по тем
задачам, для решения которых они и подобраны
README update These have been proofread somewhat to correspond to the current state of affairs; a missing one was added for fonts feature.
2013-06-10 17:37:16 +04:00
* повторяющиеся логически связанные группы списков может иметь смысл
READMEs: pkglist related clarification glebfm@ asked what to do with new package lists: whether these belong to features, or to distributions themselves. This question is actually open and up for discussion but there are guidelines that can and should be written down already; and so they were. Added pkgdups utility reference as well.
2012-04-09 23:18:31 +04:00
выделить в фичу (см., например, power или x11)
README update These have been proofread somewhat to correspond to the current state of affairs; a missing one was added for fonts feature.
2013-06-10 17:37:16 +04:00
* если явной фичи не наблюдается, но у группы дистрибутивов намечается
READMEs: pkglist related clarification glebfm@ asked what to do with new package lists: whether these belong to features, or to distributions themselves. This question is actually open and up for discussion but there are guidelines that can and should be written down already; and so they were. Added pkgdups utility reference as well.
2012-04-09 23:18:31 +04:00
заметная общая часть -- её можно выделить в промежуточную цель вида
distro/.name, не являющуюся самостоятельно собираемой
Reference in New Issue Copy Permalink