In GML, every non-root element can have a name and an identifier.
Name attributes correspond to the object names used in GAMGI, which
exist only to help users identify the objects.
Identifier attributes must be unique for each import or export
operation, as they are used by GAMGI to relate elements that may
not even be in the same file. Although GAMGI uses numbers as
identifier attributes when exporting files, these are not related
in any way with the object numbers used internally in GAMGI to
identify the objects. Identifier attributes are required only
when the respective elements must be referenced somewhere else,
most notably in bonded atoms that must be referenced by the bonds.
Objects can reference parents that are only defined later,
perhaps in another file, or perhaps in another file included
by another file, without any limit to the level of depth of
nested files. For example, a bond in a file can reference atoms
that are defined in a HTTP file, fetched from somewhere in the
planet. Configuration data elements have fixed parents, so
identifiers don't apply to them.
We note that an object can only reference other objects that
are inside the block defined by its own parent. This important
restriction was introduced to disable all kinds of weird
referencing possibilities that are left open with global
identifiers, where everything can point to everything,
potentially destroying the strict hierarchy that XML files
should have, and making it difficult for GAMGI and users
alike to check and understand the objects true hierarchy.
This automatically prevents, for example, atoms belonging to
different layers from being bonded together, as bonds in one
layer cannot see atoms that are in the other layer. To see
both atoms, bonds would have to belong to the common window,
which is forbiden, because windows cannot own bonds, only
layers.
Good:
<gml>
<bond parent1="1" parent2="2"/> bond can reference parents that are defined later
<group>
<atom id="1"/> atom is inside the bond scope (the current layer block)
</group>
<atom id="2"/>
</gml>
Bad:
<gml>
<atom id="1"/>
<atom id="2"/>
<group>
<bond parent1="1" parent2="2"/> atoms are outside the bond scope (the group block)
</group>
</gml>