mkimage-profiles/doc/assumptions.txt

предположения фрагментов кода об окружении
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
NB: пути приводятся от верхнего уровня; проект в целом предполагает
GNU make 3.81 (с использованием которого и разрабатывается).

- pkg.in/lists/Makefile
  + ожидает, что названия пакаджлистов указываются в переменных
    вида *_LISTS, и копирует в генерируемый профиль только их
  + если задать имя файла пакаджлиста непосредственно в Makefile
    субпрофиля, он не будет скопирован
  + характерное сообщение об ошибке:
    E: Couldn't find package

- features.in/stage2/stage1/scripts.d/02-kdefault
- features.in/stage2/stage1/scripts.d/03-test-kernel
- sub.in/stage1/Makefile
  + ожидают, что в stage1 попадёт строго одно ядро сообразно
    явному указанию в STAGE1_KFLAVOUR (либо последнее указанное
    в KFLAVOURS)
  + если добавить какой-либо kernel-image в STAGE1_PACKAGES*,
    результат может быть неожиданным
  + вероятная ошибка: незагрузка полученного 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-образов второй стадии инсталятора,
    livecd и спасательной системы соответственно altinst, live и rescue

- image.in/Makefile
  + ожидает, что конфигурация будет в distcfg.mk (см. тж. lib/profile.mk),
    а лог сборки -- в build.log (см. тж. lib/log.mk); альтернативой было
    бы пробрасывание переменных с полным путём ради единственного места
-												doc/: minor update

Somewhat more uniform style and a few additional bits.

											
										
										
											2011-09-11 19:02:17 +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: пути приводятся от верхнего уровня; проект в целом предполагает
 								GNU make 3.81 (с использованием которого и разрабатывается).
-												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
-												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
+								- pkg.in/lists/Makefile
 								  + ожидает, что названия пакаджлистов указываются в переменных
 								    вида *_LISTS, и копирует в генерируемый профиль только их
 								  + если задать имя файла пакаджлиста непосредственно в Makefile
 								    субпрофиля, он не будет скопирован
 								  + характерное сообщение об ошибке:
 								    E: Couldn't find package
 								- features.in/stage2/stage1/scripts.d/02-kdefault
 								- features.in/stage2/stage1/scripts.d/03-test-kernel
 								- sub.in/stage1/Makefile
 								  + ожидают, что в stage1 попадёт строго одно ядро сообразно
 								    явному указанию в STAGE1_KFLAVOUR (либо последнее указанное
 								    в KFLAVOURS)
 								  + если добавить какой-либо kernel-image в STAGE1_PACKAGES*,
 								    результат может быть неожиданным
 								  + вероятная ошибка: незагрузка полученного 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
 								- 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-образов второй стадии инсталятора,
 								    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
 								- image.in/Makefile
 								  + ожидает, что конфигурация будет в distcfg.mk (см. тж. lib/profile.mk),
 								    а лог сборки -- в build.log (см. тж. lib/log.mk); альтернативой было
 								    бы пробрасывание переменных с полным путём ради единственного места