V551ToV70
Table of Contents
Classes
- Ages
- Ages by the 7.0 grammar: lowercase units in the order y m w d, one space between parts and
after "<" or ">" ("<0Y" → "< 0y", "11m 99y" → "99y 11m"); a number without a unit is years,
as most 5.5.1 programs read it. CHILD, INFANT and STILLBORN become "< 8y", "< 1y" and "0y"
with the word as PHRASE; anything else becomes PHRASE of an empty age.
- Dates
- Dates by the 7.0 grammar (specification section 2.6 and appendix A), uppercase:
- Enumerations
- Enumeration values in 7.0 case and spelling (birth → BIRTH, PRE-1970 → PRE_1970, DNS/CAN →
DNS_CAN). A value the 7.0 set does not have becomes OTHER with the value as PHRASE where 7.0
has both ("1 NAME … 2 TYPE Screen" → TYPE OTHER, PHRASE Screen), and stays as it is
elsewhere; the event type a citation is from, whose set has no OTHER, is EVEN, the generic
event, with the value as PHRASE ("2 EVEN Census of Galicia" → EVEN EVEN, PHRASE Census of
Galicia). A 5.5.1 role description "(text)" is OTHER with PHRASE text.
- Events
- 7.0 EVEN of an individual or a family requires TYPE, 5.5.1 does not: an EVEN with a value
("Moved to Osaka", which describes the event) and no TYPE gets the value as its first TYPE.
- FileHeader
- HEAD.CHAR, HEAD.GEDC.FORM and HEAD.FILE describe the file, not its data, and 7.0 has none of
them (a 7.0 file is always UTF-8 and lineage-linked, and its name is whatever it is saved
as): they are removed without a loss (SPEC section 7, "Source housekeeping structures").
- Identifiers
- AFN, RFN and RIN become EXID with the TYPE the 7.0 term files define for the conversion:
- InlineRecords
- 7.0 has no inline media or source: OBJE and SOUR substructures point to records. Each one
without a pointer becomes a new record @X<n>@ (before TRLR, in order of appearance), and
the substructure points to it:
- Languages
- Languages as BCP 47 tags: the 5.5.1 language names (case-insensitive) map to their tags as
in the gedcom7code converter, except Dogri, which is "doi" (it writes "dgr", Dogrib). A value
that already is a tag of a 2- or 3-letter language ("uk", "en-GB") stays; any other becomes
"und" with the value in an extension _PHRASE (7.0 LANG has no PHRASE), as gedcom7code does;
HEAD.SCHMA documents it (Schema).
- Media
- Media files by the 7.0 types:
- NoteRecords
- The 5.5.1 NOTE record is the 7.0 shared note SNOTE, and a NOTE that points to it (in 5.5.1 a
NOTE pointer always points to a NOTE record) is SNOTE too, where 7.0 has SNOTE: under a TRAN
(5.5.1 ROMN, FONE) it stays NOTE for the structures rule, which keeps it as _NOTE. NOTE with
text stays NOTE.
- Occurrences
- An event with neither a value nor substructures (1 BURI) says that the event occurred, which
7.0 writes as Y: it has no structure without both.
- Repositories
- 5.5.1 REPO of a source without a pointer (a repository known only by its call numbers) is
REPO @VOID@ in 7.0, which requires the pointer.
- Schema
- HEAD.SCHMA documents the extension tags with a standard meaning that the conversion writes:
"_PHRASE https://gedcom.io/terms/v7/PHRASE" (a relocated PHRASE) when a LANG of the input
has no BCP 47 tag (Languages). Whether one does comes from the prepass, so that HEAD is
complete when it is converted, as convertFile() needs. A tag the input already has is left
out, as its meaning there is not known; an existing SCHMA gets the TAG added (unless it has
one for _PHRASE already), an input without HEAD a HEAD. Extensions of
the input and those without a standard URI (_SUBN, _TYPE) are not documented: Korin does not
guess or invent what they mean.
- Sexes
- SEX U with _SEX X, which the conversion to 5.5.1 writes for SEX X, is SEX X (to 5.5.5 also
_SEX N, SEX N).
- Submissions
- 7.0 has no SUBN (the LDS submission record). Its substructures move to HEAD._SUBN, one per
SUBN record, so a conversion back can restore it; the record and HEAD.SUBN, the pointer to
it, are removed. Done when HEAD is converted, with the SUBN records from the prepass: a SUBN
record may be anywhere, HEAD is first. A SUBN record an earlier step of a route made
(7.0 → 5.5.1 → 5.5.5) moves when it is converted, its values written anew.
- TextValues
- Text values by the 7.0 line rules: CONC lines are joined (7.0 has no CONC and no line length
limit; CONT stays), and "@" is doubled only at the start of a line instead of everywhere
("with @@ inside" → "with @ inside"). "@#…@" sequences are kept as text ("@#DJULIAN@ x" →
"@@#DJULIAN@ x"); the date rule, which runs after this one, reads calendar escapes in DATE
from that text. Rules after this one read values by the 7.0 rules (Context::value()).
- Translations
- FONE and ROMN, the phonetic and romanized variations of a name or place, become TRAN with a
BCP 47 LANG in place of their TYPE: the types 5.5.1 names map to a language and script
(hangul → ko-Hang, kana → ja-Kana, romaji → ja-Latn, pinyin → zh-Latn-pinyin, wadegiles →
zh-Latn-wadegile; a FONE type only for FONE, a ROMN type only for ROMN); any other type keeps
its value as _TYPE, with LANG und (FONE) or und-Latn (ROMN, a romanization is in Latin
script). An empty TYPE is dropped.
- Uids
- The vendor tag _UID is the 7.0 UID. Its value is kept as it is: the UID term says an existing
identifier "should be used without modification", so a PAF-style UUID with a checksum stays.
- Xrefs
- Xrefs and pointers. 7.0 allows only uppercase letters, digits and "_" in an xref and
reserves @VOID@: a record with any other xref (@fam 1@, @note@, @VOID@) gets @X<n>@, the next
free n in document order, and every pointer to it follows. A pointer to a record that does
not exist (compared case-sensitively: @test@ is not @TEST@) becomes the null pointer @VOID@,
except under NOTE: there it is more likely text written without "@@" escaping (@Smith family@)
and stays text (NOTE @@Smith family@), so nothing is lost, and in an extension (_IN @B1@),
which 7.0 leaves to the extension's definition. Needs the prepass: a pointer may come before the record it points to.