An edition is a numbered version of a work.

• §1. Editions

§1. Editions. An "edition" of a work is a particular version numbered form of it. For example, release 7 of Bronze by Emily Short would be an edition of the work Bronze by Emily Short.

It is at this level that we record what works are compatible with which target virtual machines, because we can imagine that, for example, version 7 might work with all VMs, while version 8 required a 32-bit architecture.

typedef struct inbuild_edition {
    struct inbuild_work *work;
    struct semantic_version_number version;
    struct compatibility_specification *compatibility;
    CLASS_DEFINITION
} inbuild_edition;

inbuild_edition *Editions::new?Usage of Editions::new:
Extension Manager - §4
Extension Bundle Manager - §3
Kit Manager - §3
Language Manager - §3
Pipeline Manager - §4
Project Bundle Manager - §2
Project File Manager - §2
Template Manager - §3
Extension Services - §2.3(inbuild_work *work, semantic_version_number version) {
    inbuild_edition *edition = CREATE(inbuild_edition);
    edition->work = work;
    edition->version = version;
    edition->compatibility = Compatibility::all();
    return edition;
}

void Editions::write?Usage of Editions::write:
§3
Copies - §6(OUTPUT_STREAM, inbuild_edition *E) {
    Works::write(OUT, E->work);
    semantic_version_number V = E->version;
    if (VersionNumbers::is_null(V) == FALSE) {
        WRITE(" v%v", &V);
    }
}

• The structure inbuild_edition is accessed in 2/cps, 2/ce, 2/rqr, 2/nst, 2/jm, 3/bg, 3/is, 3/is2, 4/em, 4/ebm, 4/km, 4/lm, 4/pm, 4/pbm, 4/pfm, 4/tm, 5/es, 5/ks, 5/ls, 5/ps, 5/ps2, 5/ts, 6/st, 6/hdn, 6/inc, 6/vmg, 7/tm, 7/eip, 7/ti, 7/tc, 7/dc, 7/dr and here.

§2. When a copy is to be duplicated into a nest N, we need to work out where to put it. For example, version 2.1 of the extension Marbles by Steve Hogarth would go into N/Extensions/Steve Hogarth/Marbles-v2_1.i7x. The following contributes only the un-filename-extended leafname Marbles-v2_1.

int canonical_leaves_have_versions = TRUE;

void Editions::set_canonical_leaves_have_versions(int which) {
    canonical_leaves_have_versions = which;
}

void Editions::write_canonical_leaf?Usage of Editions::write_canonical_leaf:
Extension Manager - §7
Extension Bundle Manager - §7
Kit Manager - §8
Language Manager - §6
Pipeline Manager - §6
Template Manager - §6
The Mini-Website - §6
The Converter - §1, §1.3(OUTPUT_STREAM, inbuild_edition *E) {
    WRITE("%S", E->work->title);
    if ((canonical_leaves_have_versions) &&
        (VersionNumbers::is_null(E->version) == FALSE)) {
        TEMPORARY_TEXT(vn)
        WRITE_TO(vn, "-v%v", &(E->version));
        LOOP_THROUGH_TEXT(pos, vn)
            if (Str::get(pos) == '.')
                PUT('_');
            else
                PUT(Str::get(pos));
        DISCARD_TEXT(vn)
    }
}

§3. The -inspect command of Inbuild uses the following.

void Editions::inspect?Usage of Editions::inspect:
Copies - §11
The Installer - §2.3(OUTPUT_STREAM, inbuild_edition *E) {
    Editions::write(OUT, E);
    if (Compatibility::test_universal(E->compatibility) == FALSE) {
        WRITE(" (");
        Compatibility::write(OUT, E->compatibility);
        WRITE(")");
    }
}

§4. For sorting search results:

int Editions::cmp?Usage of Editions::cmp:
Copies - §10
The Installer - §6(inbuild_edition *E1, inbuild_edition *E2) {
    int r = Works::cmp(E1->work, E2->work);
    if (r == 0) r = VersionNumbers::cmp(E1->version, E2->version);
    return r;
}