keremet/mkimage-profiles
2
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
750aaac150
mkimage-profiles/README

80 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
== Welcome to m-p! ==
*Brief summary*
drop the dummy configure It wasn't serving any good by now... README++ and cleanups all over the place
2010-09-14 09:44:35 +04:00
added asciidoc support
2012-10-31 01:21:23 +04:00
Configurables: ~/.mkimage/profiles.mk;
see doc/params.txt and conf.d/README
drop the dummy configure It wasn't serving any good by now... README++ and cleanups all over the place
2010-09-14 09:44:35 +04:00
added asciidoc support
2012-10-31 01:21:23 +04:00
License: GPLv2+, see COPYING
actually released as free software I hereby release this work under the terms of GNU General Public License, either version 2 or a later version at your option. The code is either taken from mkimage-profiles-desktop.git (available under GPLv2+) or written by me with some exceptions in the form of: - snippets from GNU make documentation; - stackoverflow.com and cmcrossroads.com articles; - random advice on the 'net to be strict; given the nature of such snippets being explicitly proposed as an example or for immediate reuse, I consider it feasible to redistribute those worked into this code. If there's any concern regarding copyright, please contact me by e-mail to sort it out.
2011-07-20 23:10:52 +04:00
added asciidoc support
2012-10-31 01:21:23 +04:00
Most docs are in Russian, welcome to learn it or ask for English.
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
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
Задача:
added asciidoc support
2012-10-31 01:21:23 +04:00
* конфигурирование и создание образов на базе ALT Linux
wash, rinse, repeat install2 cleanups: - functionally indifferent ones: particularly, install2/*/98system's "mkdir -p /image" was superfluous as it was done by that time already by sub.in/stage2/image-scripts.d/00stage1 - taken apart, prepared for tags: so far it's a mostly moot change since the installer cleanup scripts themselves are mostly the same as preceding 90cleanup was (with some additions corresponding to recent kernel development); it's still unclear what the mechanism for configuring the cleanups in effect will be, either directory/package regex lists or tagged scripts excluded from execution by yet another tag fixes: - image.in/Makefile: fix metadata related test; the actual test was assuming that stage1 kernel means installer, which is not the case since generic stage2 introduction; oh well - 85cleanup-lowmem: a "_" too much was the culprit in destroying the needed translations along with those deemed superfluous; thanks go to Oleg Ivanov and Lenar Shakirov for finding the bug and proposing the fix altogether additions: - features.in/Makefile: reworked help target; it was rather inaccessible due to BUILDDIR normally undefined at the time of direct make invocation, and BUILDDIR is normally defined during normal builds anyways so let's try it this way. - README++ daydreams: - 01-genbasedir: we should drop bzip2 compressed pkglists some day but see genbasedir and apt-cdrom first, 90-pkg.sh (alterator-pkg) will fail miserably otherwise
2011-09-19 11:55:45 +04:00
drop the dummy configure It wasn't serving any good by now... README++ and cleanups all over the place
2010-09-14 09:44:35 +04:00
Концепция:
added asciidoc support
2012-10-31 01:21:23 +04:00
* конфигурация, как и образ -- объект постадийной сборки
* метапрофиль служит репозиторием для построения индивидуального
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
профиля, по которому создаётся итоговый образ
drop the dummy configure It wasn't serving any good by now... README++ and cleanups all over the place
2010-09-14 09:44:35 +04:00
Особенности:
added asciidoc support
2012-10-31 01:21:23 +04:00
README: minor tweaks A few readability fixes and lib/*.mk demotion since conf.d/*.mk is now an established place for RM-written image configuration.
2014-03-05 17:15:13 +04:00
* метапрофиль при сборке может быть доступен только на чтение
added asciidoc support
2012-10-31 01:21:23 +04:00
* для сборки подыскивается предпочтительно tmpfs
* в профиль копируются только нужные объекты;
server-ovz; KDEFAULT; syslinux features reworked Renamed server-light.iso into server-ovz.iso to avoid brand dilution and confusion (rider@'s server-light rather favours kvm, anyways). Introduced KDEFAULT: a reliable default kernel chooser knob since apt's regex ordering proved pretty unreliable. Spelling things explicitly is better anyways. SYSLINUX related features undergone pretty major rewrite (that includes syslinux, hdt and memtest). The problem to tackle was features.in/syslinux/generate.mk assuming syslinux and pciids available in build *host* system; this well might not be the case (or worse yet, those can be just different). So now we're a bit less elegant and a bit more enterprise, stuffing things into chroot and working there. Bunch of other fixes along the road, including ; to name a few: - fixed memtest entry (overlooked while renaming SYSLINUX_ITEMS) - new and shiny doc/CodingStyle - gfxboot, stage1 target chain, hdt tweaks - distro.mk rehashed - README++ - TODO: dropped (integer overflow anyways) + actually moved off-tree to reduce commit spam - s,\.config\.mk,distcfg.mk,g - doc/profiles.mk.sample: sample ~/.mkimage/profiles.mk - ...and assorted fixups/additions Sorry for convoluted commit, this would have been pretty hard to rework into some really readable shape (and you might be interested in the original repo's history horrors then, anyways).
2011-05-31 02:05:33 +04:00
он автономен относительно метапрофиля
syslinux and features - syslinux: menu.c32 works - features: initial draft + memtest - mv pkg/ pkg.in/ + server-base: include openssh-blacklist by default - mv isodata/ copy/ - README: changed to utf8, added an URL
2010-09-09 13:50:29 +04:00
docs day ToC: - introduced doc/ - features.in/00example/ - READMEs and TODO for more - code comments clarified Some unrelated minor fixes bundled either.
2010-09-22 01:58:24 +04:00
Стадии работы:
added asciidoc support
2012-10-31 01:21:23 +04:00
* инициализация сборочного профиля
* сборка конфигурации образа
* наполнение сборочного профиля
* сборка образа
docs day ToC: - introduced doc/ - features.in/00example/ - READMEs and TODO for more - code comments clarified Some unrelated minor fixes bundled either.
2010-09-22 01:58:24 +04:00
syslinux and features - syslinux: menu.c32 works - features: initial draft + memtest - mv pkg/ pkg.in/ + server-base: include openssh-blacklist by default - mv isodata/ copy/ - README: changed to utf8, added an URL
2010-09-09 13:50:29 +04:00
Объекты:
added asciidoc support
2012-10-31 01:21:23 +04:00
* дистрибутивы и виртуальные среды/машины:
README: minor tweaks A few readability fixes and lib/*.mk demotion since conf.d/*.mk is now an established place for RM-written image configuration.
2014-03-05 17:15:13 +04:00
** описываются в conf.d/*.mk
added asciidoc support
2012-10-31 01:21:23 +04:00
** могут основываться на предшественниках, расширяя их
README: minor tweaks A few readability fixes and lib/*.mk demotion since conf.d/*.mk is now an established place for RM-written image configuration.
2014-03-05 17:15:13 +04:00
** дистрибутивы также включают один или более субпрофилей по надобности
added asciidoc support
2012-10-31 01:21:23 +04:00
** желательно избегать множественного наследования, см. тж. фичи
* субпрофили:
** список собирается в $(SUBPROFILES)
** базовые комплекты помещены в подкаталогах под sub.in/;
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
их наборы скриптов могут расширяться фичами
added asciidoc support
2012-10-31 01:21:23 +04:00
* фичи:
** законченные блоки функциональности (или наборы таковых)
** описываются в индивидуальных features.in/*/config.mk
** могут требовать другие фичи, а также субпрофили
** накопительный список собирается в $(FEATURES)
** при сборке $(BUILDDIR) содержимое фич добавляется в профиль
* списки пакетов (*_LISTS):
** просьба по возможности избегать дублирования (см. bin/pkgdups)
* индивидуальные пакеты (*_PACKAGES): см. тж. conf.d/README
initial logging subsystem Now we don't dump all the gory details onto thee but rather log them handsomely and present only the most important details by default; use DEBUG=1 and/or BUILDLOG=/path/to/file to tweak. Also introduced IMAGEDIR and IMAGENAME. The rest: - ovz-smp is no more - base-l10n pkglist (suggested by Alexander Kuprin) - clean.mk: + fixed an oversight: the test result erroneously applied only to the first command of several ones that should be run iff build/ is a symlink + drop implicit rules (it's no C code) - Makefile: more reasonable iso names - image.in/Makefile: .disk/date too
2011-05-11 23:40:47 +04:00
Результат:
added asciidoc support
2012-10-31 01:21:23 +04:00
* при успешном завершении сборки образ называется по имени цели
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
и укладывается в $(IMAGEDIR):
added asciidoc support
2012-10-31 01:21:23 +04:00
** указанный явно,
** либо ~/out/ (если возможно),
** или $(BUILDDIR)/out/ иначе
* формируются отчёты, если запрошены (REPORT)
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.
2012-08-11 23:31:15 +04:00
См. тж.:
added asciidoc support
2012-10-31 01:21:23 +04:00
README: explained wiki link Some seem to be skipping it over for no good reason while even unfinished HOWTO is much beta than nothin'.
2014-06-24 15:28:11 +04:00
* http://altlinux.org/m-p: обзорная документация, в т.ч. howto
added asciidoc support
2012-10-31 01:21:23 +04:00
* doc/:
** params.txt: переменные, указываемые при запуске сборки
** pkglists.txt: формирование состава образа
** features.txt: обзор подключаемых особенностей
README: minor readability fixes Should be a tiny bit better this way.
2012-09-22 17:37:14 +04:00
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
Примечание: пути в документации задаются от каталога верхнего уровня,
если не указаны как относительные в явном виде (./) или по смыслу.
README: minor readability fixes Should be a tiny bit better this way.
2012-09-22 17:37:14 +04:00
Удачи; что не так -- пишите.
Michael Shigorin <mike@altlinux.org>
Reference in New Issue Copy Permalink