The first release after add VERSION file showed that I forgot to
update VERSION. Therefore, should discard this file. VERSION only
used in man file.

grub available on more platforms than syslinux.

Required mkimage 0.3.0-alt1

As of asciidoc-10.2.0-alt1, resources moved from /etc/asciidoc to
%python3_sitelibdir/%name/resources.
It is better not to depend on third-party resources that may be moved.
Missing Images added from asciidoc-10.2.0-alt1.

I always forget to update the date.

.gear/mkimage-profiles.spec is not available.

We cannot get IMAGE_OUTPATH from the build.log, and there is currently
no other mechanism. Creating a CHECK directory was a bad idea. It should
have been created only for CHECK, but it was always created when DEBUG
was not enabled. So it's better to just issue a warning.

This feature allows you to set alternatives [1].
For example, like this:

   @$(call add,ALTERNATIVES,/usr/bin/xvt:/usr/bin/xterm)

Also, in the config itself, targets for setting alternatives may already
be predefined. For example, use/alternatives/xvt/% allows you to specify
arbitrary alternatives for xvt:
use/alternatives/xvt/xterm, use/alternatives/xvt/mate-terminal, etc.
However, an alternative must be available.

1. https://www.altlinux.org/Alternatives

So much clearer and easier.
Thanks glebfm@ for the idea.

check conditions of  make  for equality of variables with an empty value
instead of check definition.
A defined but empty variable under all these conditions results errors.

This has been clearly lacking while making the previous commit
but the implementation isn't that clear so let it be a separate
step.

The problem requiring the change in subsequent processors
is that these relied upon "@arch" as a flag to be inspected,
and "pkg@!arch1,arch2" on arch2 needs to take out *all* of that
fragment *including* arch1 mention as well.

Part of the cause is difference in handling: "positive" multi-match
would explode its "client" line into multiple lines to filter down
the pipeline, while "negative" multi-match *has* to keep that line
on a similarly single line (otherwise we'd end up with N-1 of those
slipping past the filter for particular architecture thus defeating
the whole purpose of "negative" matching semantics):

$ echo 'pkg@!E2K,mipsel,riscv64' |
  sed -r  ':loop; s/^((([^@]+@!)[^,]+)+),([a-zA-Z0-9_]+)/\1@!\4/; t loop'
pkg@!E2K@!mipsel@!riscv64

I've tried my best to test this specific change but it still might
introduce a regression in some corner case; feel free to report;
looks like there's a space for improvement in m-p's automated
tests department as well.

So now we can do:

  pkg@!ARCHES1,ARCHES2,arch3,arch4

and have pkg excluded on arches mentioned; the previous approach
could only offer explicit whitelists (not that it was entirely
wrong but then again, we have both ExclusiveArch and ExcludeArch
rpmtags in our spec files).

This has been inspired by a few commits that cared
for package availability reasons on a particular
architecture; the problem at hand is that pkglists
might need to include groups of packages that are
(un)available on groups of arches, and tackling that
with plain pkg@arch just results in combinatorial
explosion of that matrix.

Arches are handled one-by-one with a few hardcoded
macro substitutions.

Exploding a "pkg@arch1,arch2" string into a set of:

pkg@arch1
pkg@arch2

with subsequent archdep pruning would do the trick;
so here's another sed oneliner that does just that:

$ echo 'pkg@X86,ARM,ppc64le' |
  sed -r ':loop; s/^((([^@]+@)[^,]+)+),([^,]+)/\1\n\3\4/; t loop'
pkg@X86
pkg@ARM
pkg@ppc64le

See-also: 9601a9e7
See-also: 5581dc91
See-also: http://stackoverflow.com/a/55781741/561921

The parameter determines use of QEMU or not, if the target architecture
does not correspond to the host architecture.
By default, the parameter is on (Value 1).
For architectures that do not support QEMU (e2k), the option is turned off.

See also commit: 61f66b08

This allows you to reset the BRANCH variable by specifying the
'BRANCH=' argument on the command line.

The commit 99695713 used this variable
even though it didn't exist yet. A good reason to add this variable.

Aptbox is not initialized, so build time is reduced.

The @META suffix is used to expand the metapackage into a list.
apt asks for the dependencies of such a package and adds them to the
package list after this metapackage.

Now it cannot be set from the config ~/mkimage/profiles.mk

It was fixed in the commit:
187d0a5d

NO_SYMLINK disables the creation of symlinks for the builded image.

.fop.xconf needed for building pdf.

The BRANCH parameter indicates that the target is a starterkit and
not a regular build for Sisyphus.

Previously, you had to specify two parameters MKIMAGE_PREFIX and
GLOBAL_PREFIX with the same value - the path to mkimage. And this
behavior has not been documented. The GLOBAL_PREFIX variable is
defined in mkimage in config.mk and rules.mk.

The parameter is used to save the intermediate tarball used to
build the virtual machine image.