Vendor dialects¶
Programs write GEDCOM with mistakes of their own. Korin knows the program that wrote a file
from HEAD.SOUR ($doc->sourceSystem(): the system identifier, VERS, NAME and the
Extension\Program when the identifier is known) and corrects the mistakes that are
documented. A correction only decides the encoding or the version a file is read in: no line
changes, preserve mode writes the file as it was, and each correction is reported as KV1010
(info). ReadOptions::withDialects(false) turns them off.
$doc = Gedcom::read('family.ged');
$doc->sourceSystem()?->program(); // Program::PersonalAncestralFile
$doc->sourceSystem()?->version(); // "5.2.18.0"
Corrections¶
| Program | Mistake | Read as | Source |
|---|---|---|---|
Personal Ancestral File 5 (PAF, VERS 5 or later) |
Writes GEDCOM 5.5.1 (UTF-8, EMAIL) and declares 5.5 |
5.5.1 | 1, 2 |
Brother's Keeper before 6.1.12 (BROSKEEP) |
Writes CHAR IBMPC for Windows-1252 |
Windows-1252, when the content is not ASCII | 1 |
| GEDitCOM; MacFamilyTree before 8.3.5 | Writes CHAR ASCII with 2 VERS MacOS Roman (2 VERS MACINTOSH) for MacRoman |
MacRoman, when the content is not ASCII | 1 |
Without a VERS under HEAD.SOUR, Brother's Keeper is taken to be older than 6.1.12: from
6.1.12 on it writes CHAR ASCII instead.
CHAR values¶
Besides the values of the specifications (ANSEL, ASCII, UNICODE, UTF-8), these values of
HEAD.CHAR are read as the encoding they name, with KV1101. Upper and lower case, spaces,
- and _ do not matter.
HEAD.CHAR |
Encoding | Written by 1 |
|---|---|---|
ANSI, WINDOWS, IBM WINDOWS, CP1252, WINDOWS-1252, LATIN1, ISO-8859-1, ISO8859 |
Windows-1252 (Windows-1251 when the content is Cyrillic) | Parentele, EasyTree, Reunion, TribalPages, Lifelines, GenealogyJ, Genealogica Grafica |
WINDOWS-1251, CP1251, CYRILLIC |
Windows-1251 | Rodovid |
WINDOWS-1250, CP1250 |
Windows-1250 | GenoPro, Rodokmen Pro |
IBMPC, IBM, IBM-PC, OEM, CP437 |
CP437 | Reunion, Cumberland Family Tree, Généatique |
MSDOS, MS-DOS, IBM DOS, CP850 |
CP850 | AbrEdit, Family Tree Maker for Windows, Reunion, EasyTree |
MACINTOSH, MACROMAN |
MacRoman | MacFamilyTree from 8.3.5 |
When the content contradicts CHAR (UTF-8 under CHAR ANSEL, 8-bit bytes under CHAR ASCII),
the content wins (KV1102); see the README.
Programs¶
Extension\Program knows the identifiers of the table of Tamura Jones 3, compared without
case: Ancestry (ANCESTRY, Ancestry.com Family Trees), Ancestral Quest (AncestQuest,
EFT), Brother's Keeper (BROSKEEP), Family Historian (FAMILY_HISTORIAN), Family Tree Maker
(FTM, FTW), GEDitCOM, GeneWeb, GenoPro, Gramps, Heredis (HEREDIS, and the identifier of each
version: HEREDIS PC2018), Legacy, MacFamilyTree (SyniumFamilyTree), MyHeritage
(MYHERITAGE), Personal Ancestral File (PAF, PAF 2.31), Reunion, RootsMagic, webtrees.
A program not in the table has a SourceSystem without a Program.
Extension tags (_UID, _APID, _FSFTID, …) are kept whoever wrote them.