keremet/mkimage-profiles
2
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
41f60ce1b1
mkimage-profiles/doc/assumptions.txt

56 lines
3.7 KiB
Plaintext
Raw Normal View History

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
== Предположения ==
Некоторые фрагменты кода закладываются на определённое поведение
других частей mkimage-profiles либо содержание переменных.
added asciidoc support
2012-10-31 01:21:23 +04:00
doc/assumptions.txt: specify minimal gmake version From what I've read so far, most of the code should run on 3.80; there seem to have been some bits that are dependent on 3.81 features, but there is not a bit that depends on 3.82+ features so far.
2012-02-18 11:46:03 +04:00
NB: пути приводятся от верхнего уровня; проект в целом предполагает
QUICKSTART: it's p7/t7 or later now 0.6.3 has introduced some changes that were deemed incompatible with t6/p6 branches; it should be possible to restore compatibility at least for non-EFI images but the effort required hasn't been up for grabs so far. See also https://bugzilla.altlinux.org/30474
2014-11-16 21:29:12 +03:00
ALT Linux 7.0+ и GNU make 3.82+ (на которых и разрабатывается),
assumptions.txt: clarified sisyphus/branch status Folks have been wondering already whether e.g. t6 breakage qualifies as a bug; it does indeed unless the "broken" part depends on the features not available with that branch yet, e.g. EFI support.
2013-01-25 01:27:00 +04:00
но может быть портирован вместе с mkimage. Если что-либо не работает
или не собирается, стоит проверить на Sisyphus (mkimage, make, hasher,
собственно пакетная база), поскольку именно на нём происходит основная
разработка mkimage-profiles. Сломанная сборка на текущем стабильном
бранче считается ошибкой и подлежит исправлению, если оно технически
возможно на базе этого бранча.
docs: minor updates doc/variables.txt was missing the already-existing BUILDLOG variable description, and ARCHES got added during multi-target toplevel rewrite. Other minor fixes come as appropriate.
2012-01-02 19:52:48 +04:00
added asciidoc support
2012-10-31 01:21:23 +04:00
* lib/report.mk
** ожидает, что каждая подлежащая трассированию цель каждого
initial target tracing support and reporting The purpose is being able to examine particular target interdependency graph for a given image having been configured to avoid convoluted dependencies (loops in particular). The implementation is based on SHELL hook hint by John Graham-Cumming: http://cmcrossroads.com/ask-mr-make/6535-tracing-rule-execution-in-gnu-make
2012-03-19 15:42:10 +04:00
makefile при сборке конфигурации образа содержит непустой
recipe -- хотя бы "; @:" -- т.к. зависит от запуска $(SHELL)
assumptions.txt: mention REPORTS It wasn't clear enough what the whole tracing affair is for; thanks ykos@ for spelling it aloud.
2016-06-16 15:15:46 +03:00
** трассировка выполняется при REPORT=1 для формирования графа
зависимостей между промежуточными целями сборки конечного образа
added asciidoc support
2012-10-31 01:21:23 +04:00
** характерный признак пропуска -- разрыв графа (report-targets.png)
initial target tracing support and reporting The purpose is being able to examine particular target interdependency graph for a given image having been configured to avoid convoluted dependencies (loops in particular). The implementation is based on SHELL hook hint by John Graham-Cumming: http://cmcrossroads.com/ask-mr-make/6535-tracing-rule-execution-in-gnu-make
2012-03-19 15:42:10 +04:00
added asciidoc support
2012-10-31 01:21:23 +04:00
* pkg.in/lists/Makefile
** ожидает, что названия пакаджлистов указываются в переменных
stage2 based live subprofiles, updated docs - introduced generic stage2 subprofile (non-standalone) - ported installer and rescue over to stage2/{install2,rescue} - initial stage2/live (needs more work for sure) - use make-initrd-propagator - updated and somewhat extended doc/ NB: mind #26133, #26134
2011-08-20 13:55:05 +04:00
вида *_LISTS, и копирует в генерируемый профиль только их
added asciidoc support
2012-10-31 01:21:23 +04:00
** если задать имя файла пакаджлиста непосредственно в Makefile
stage2 based live subprofiles, updated docs - introduced generic stage2 subprofile (non-standalone) - ported installer and rescue over to stage2/{install2,rescue} - initial stage2/live (needs more work for sure) - use make-initrd-propagator - updated and somewhat extended doc/ NB: mind #26133, #26134
2011-08-20 13:55:05 +04:00
субпрофиля, он не будет скопирован
added asciidoc support
2012-10-31 01:21:23 +04:00
** характерное сообщение об ошибке:
stage2 based live subprofiles, updated docs - introduced generic stage2 subprofile (non-standalone) - ported installer and rescue over to stage2/{install2,rescue} - initial stage2/live (needs more work for sure) - use make-initrd-propagator - updated and somewhat extended doc/ NB: mind #26133, #26134
2011-08-20 13:55:05 +04:00
E: Couldn't find package
kernel, stage2: rearranged initrd hooks stage2 has been thinking it's synonymous with propagator and used to usurp kernel's belongings either; carefully tear scripts apart so that kernel feature makes sure initrd gets generated, and stage2 (which is still all about propagator) cares for its bits.
2014-09-18 18:38:30 +04:00
* features.in/kernel/stage1/scripts.d/80-make-initrd
added asciidoc support
2012-10-31 01:21:23 +04:00
* features.in/stage2/stage1/scripts.d/03-test-kernel
* sub.in/stage1/Makefile
** ожидают, что в stage1 попадёт строго одно ядро сообразно
stage2 based live subprofiles, updated docs - introduced generic stage2 subprofile (non-standalone) - ported installer and rescue over to stage2/{install2,rescue} - initial stage2/live (needs more work for sure) - use make-initrd-propagator - updated and somewhat extended doc/ NB: mind #26133, #26134
2011-08-20 13:55:05 +04:00
явному указанию в STAGE1_KFLAVOUR (либо последнее указанное
в KFLAVOURS)
added asciidoc support
2012-10-31 01:21:23 +04:00
** если добавить какой-либо kernel-image в STAGE1_PACKAGES*,
stage2 based live subprofiles, updated docs - introduced generic stage2 subprofile (non-standalone) - ported installer and rescue over to stage2/{install2,rescue} - initial stage2/live (needs more work for sure) - use make-initrd-propagator - updated and somewhat extended doc/ NB: mind #26133, #26134
2011-08-20 13:55:05 +04:00
результат может быть неожиданным
added asciidoc support
2012-10-31 01:21:23 +04:00
** вероятная ошибка: незагрузка полученного 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-образов второй стадии инсталятора,
test-based ramdisk size for live squashfs images Implementation based on m-p-d::profiles/scripts.d/03-syslinux (but heavily modified for m-p of course)
2011-08-22 22:37:21 +04:00
livecd и спасательной системы соответственно altinst, live и rescue
official {distro,ve}/* support This is quite a large-scale change since mkimage-profiles got used to baking distributions over the last year, and virtual environments are quite different, so e.g. image.in/Makefile had to be split in two with the main part of it moved into features.in/iso/lib/. Short overview: - features.in/Makefile: lib/ support (supporting VE images requires dynamic modifications to image.in/Makefile before starting the build; the most natural way to achieve that seems to use features mechanism along with makefile include dir) - packaging format related part moved into features.in/pack (should be better prepared for diversity either) - features.in/iso renamed to features.in/build-distro - features.in/ve renamed to features.in/build-ve + NB: these could not be merged as e.g. features.in/build due to completely different script hooks - lib/image.mk renamed to lib/build.mk - image, config, log postprocessing moved downstream - added a sort of a topping in the form of lib/sugar.mk - assorted style fixups (like ifeq usage) - clean.mk: reliability fix (the problem was observed by Oleg Ivanov and me too but finally it did get the attention quantum) - reviewed, updated and extended docs + QUICKSTART: should be[come] a step-by-step guide (thanks Leo-sp50 for prodiving feedback)
2011-10-06 12:46:31 +04:00
added asciidoc support
2012-10-31 01:21:23 +04:00
* image.in/Makefile
** ожидает, что конфигурация будет в distcfg.mk (см. тж. lib/profile.mk),
official {distro,ve}/* support This is quite a large-scale change since mkimage-profiles got used to baking distributions over the last year, and virtual environments are quite different, so e.g. image.in/Makefile had to be split in two with the main part of it moved into features.in/iso/lib/. Short overview: - features.in/Makefile: lib/ support (supporting VE images requires dynamic modifications to image.in/Makefile before starting the build; the most natural way to achieve that seems to use features mechanism along with makefile include dir) - packaging format related part moved into features.in/pack (should be better prepared for diversity either) - features.in/iso renamed to features.in/build-distro - features.in/ve renamed to features.in/build-ve + NB: these could not be merged as e.g. features.in/build due to completely different script hooks - lib/image.mk renamed to lib/build.mk - image, config, log postprocessing moved downstream - added a sort of a topping in the form of lib/sugar.mk - assorted style fixups (like ifeq usage) - clean.mk: reliability fix (the problem was observed by Oleg Ivanov and me too but finally it did get the attention quantum) - reviewed, updated and extended docs + QUICKSTART: should be[come] a step-by-step guide (thanks Leo-sp50 for prodiving feedback)
2011-10-06 12:46:31 +04:00
а лог сборки -- в build.log (см. тж. lib/log.mk); альтернативой было
бы пробрасывание переменных с полным путём ради единственного места
Reference in New Issue Copy Permalink