Commit d9f7f89f authored by Horst Plücken's avatar Horst Plücken
Browse files

First Release of addendum: 2020-01-01

parent 168696d7
......@@ -46,8 +46,12 @@
</div>
<p>&nbsp;</p>
<p>&nbsp;</p>
<p class="nomargin center">
<strong>This is a draft for Review only</strong><br>2019-12-17</p>
<div class="editors">
<dl>
<dt>First Release:</dt>
<dd>2020-01-01</dd>
</dl>
</div>
<p>&nbsp;</p>
<p>&nbsp;</p>
<p>&nbsp;</p>
......@@ -67,19 +71,16 @@
<p>This publication, The GEDCOM 5.5.1 Specification GEDCOM-L Addendum is based on the GEDCOM
5.5.1 Specification, which is a minor update of the GEDCOM 5.5 Specification. The GEDCOM
5.5 and 5.5.1 specifications were created by FamilySearch. </p>
<p>The FamilySearch GEDCOM 5.5.1 specification contains the following copyright notice:</p>
<p>Copyright © 1987, 1989, 1992, 1993, 1995, 1999 by The Church of Jesus Christ of Latter-day Saints.
This document may be copied for purposes of review only. It must not be used
for programming of genealogical software while in draft. All other rights reserved.</p>
<p>The FamilySearch GEDCOM 5.5.1 specification is a publicly distributed specification, and it's the
GEDCOM version that FamilySearch themselves use since their release of PAF 5.0 in 2000 CE.
When the creator of a standard uses that standard in its major products, including a major public
product, that standard isn't a draft.</p>
<p>The FamilySearch GEDCOM 5.5.1 specification, dated 15 November 2019, contains the following
copyright notice:</p>
<p>Copyright © 1987, 1989, 1992, 1993, 1995, 1999, 2019 by The Church of Jesus Christ of Latter-day
Saints. This document may be copied for purposes of review or programming of genealogical software,
provided this notice is included. All other rights reserved. </p>
<p>This publication, the GEDCOM 5.5.1 Specification GEDCOM-L Addendum, is published for the
purposes of review and programming of genealogical software. It is based on The GEDCOM
5.5.1 Specification and an in-depth and in-place review (for the purposes of
programming) of the FamilySearch GEDCOM 5.5.1 specification done by the mMembers of GEDCOM-L</p>
<p>This publication is copyrighted too. The copyright notice is on the front page.</p>
programming) of the FamilySearch GEDCOM 5.5.1 specification done by the <a href="#8-6">Members of GEDCOM-L
group</a>.</p>
<p>This document is licensed under a Creative Commons Attribution-NoDerivatives 4.0 International
License – see the front page.</p>
......@@ -99,7 +100,6 @@
<li class="toc-1"><span><a href="#3-5">3.5&nbsp;&nbsp; GEDCOM Tags</a></span><span><a href="#p-7">7</a></span></li>
<li class="toc-1"><span><a href="#3-5">3.6&nbsp;&nbsp; Additions, Modifications and Explanations</a></span><span><a href="#p-7">7</a></span></li>
<li class="toc-2"><span><a href="#3-6-1">3.6.1&nbsp;&nbsp; Marking of Modification</a></span><span><a href="#p-8">8</a></span></li>
<li class="toc-2"><span><a href="#3-6-2">3.6.2&nbsp;&nbsp; Document Changes</a></span><span><a href="#p-8">8</a></span></li>
<li class="toc-0"><span><a href="#4-0">4&nbsp;&nbsp; Top-Level Record Structures</a></span><span><a href="#p-9">9</a></span></li>
<li class="toc-1"><span><a href="#4-1">4.1&nbsp;&nbsp; HEADER</a></span><span><a href="#p-9">9</a></span></li>
<li class="toc-1"><span><a href="#4-2">4.2&nbsp;&nbsp; RECORD</a></span><span><a href="#p-10">10</a></span></li>
......@@ -108,7 +108,7 @@
<li class="toc-1"><span><a href="#4-5">4.5&nbsp;&nbsp; MULTIMEDIA_RECORD</a></span><span><a href="#p-11">11</a></span></li>
<li class="toc-1"><span><a href="#4-6">4.6&nbsp;&nbsp; SOURCE_RECORD</a></span><span><a href="#p-12">12</a></span></li>
<li class="toc-1"><span><a href="#4-7">4.7&nbsp;&nbsp; SUBMITTER_RECORD</a></span><span><a href="#p-12">12</a></span></li>
<li class="toc-1"><span><a href="#4-8">4.8&nbsp;&nbsp; _LOC_RECORD</a></span><span><a href="#p-13">13</a></span></li>
<li class="toc-1"><span><a href="#4-8">4.8&nbsp;&nbsp; LOCATION_RECORD</a></span><span><a href="#p-13">13</a></span></li>
<li class="toc-0"><span><a href="#5-0">5&nbsp;&nbsp; Substructures and Primitive Elements</a></span><span><a href="#p-14">14</a></span></li>
<li class="toc-1"><span><a href="#5-1">5.1&nbsp;&nbsp; ADDR Structure</a></span><span><a href="#p-14">14</a></span></li>
<li class="toc-1"><span><a href="#5-2">5.2&nbsp;&nbsp; AGE Line</a></span><span><a href="#p-15">15</a></span></li>
......@@ -121,13 +121,13 @@
<li class="toc-1"><span><a href="#5-9">5.9&nbsp;&nbsp; FAMILY_EVENT_STRUCTURE</a></span><span><a href="#p-18">18</a></span></li>
<li class="toc-1"><span><a href="#5-10">5.10&nbsp;&nbsp; INDIVIDUAL_ATTRIBUTE_STRUCTURE</a></span><span><a href="#p-19">19</a></span></li>
<li class="toc-1"><span><a href="#5-11">5.11&nbsp;&nbsp; INDIVIDUAL_EVENT_STRUCTURE</a></span><span><a href="#p-20">20</a></span></li>
<li class="toc-1"><span><a href="#5-12">5.12&nbsp;&nbsp; MULTIMEDIA_LINK</a></span><span><a href="#p-21">21</a></span></li>
</ul>
<div class="trl">-- GEDCOM 5.5.1 Specification GEDCOM-L Addendum --</div>
<div class="pager-hr-trl" id="p-4">page 4</div>
<ul class="leaders top-margin">
<li class="toc-1"><span><a href="#5-12">5.12&nbsp;&nbsp; MULTIMEDIA_LINK</a></span><span><a href="#p-21">21</a></span></li>
<li class="toc-1"><span><a href="#5-13">5.13&nbsp;&nbsp; NAME Structure</a></span><span><a href="#p-23">23</a></span></li>
<li class="toc-2"><span><a href="#5-13-1">5.13.1&nbsp;&nbsp; "Rufname"</a></span><span><a href="#p-23">23</a></span></li>
<li class="toc-1"><span><a href="#5-14">5.14&nbsp;&nbsp; PLAC_STRUCTURE</a></span><span><a href="#p-24">24</a></span></li>
......@@ -146,7 +146,7 @@
<li class="toc-1"><span><a href="#6-2">6.2&nbsp;&nbsp; Field Size</a></span><span><a href="#p-30">30</a></span></li>
<li class="toc-0"><span><a href="#7-0">7&nbsp;&nbsp; User-defined Tags</a></span><span><a href="#p-31">31</a></span></li>
<li class="toc-1"><span><a href="#7-1">7.1&nbsp;&nbsp; Introduction</a></span><span><a href="#p-31">31</a></span></li>
<li class="toc-1"><span><a href="#7-2">7.2&nbsp;&nbsp; _LOC Record</a></span><span><a href="#p-31">31</a></span></li>
<li class="toc-1"><span><a href="#7-2">7.2&nbsp;&nbsp; Location Record</a></span><span><a href="#p-31">31</a></span></li>
<li class="toc-2"><span><a href="#7-2-1">7.2.1&nbsp;&nbsp; Syntax</a></span><span><a href="#p-32">32</a></span></li>
<li class="toc-2"><span><a href="#7-2-2">7.2.2&nbsp;&nbsp; Example of Hierarchical _LOC Records</a></span><span><a href="#p-34">34</a></span></li>
<li class="toc-1"><span><a href="#7-3">7.3&nbsp;&nbsp; _SCHEMA_STRUCTURE</a></span><span><a href="#p-36">36</a></span></li>
......@@ -161,15 +161,16 @@
<li class="toc-1"><span><a href="#8-3">8.3&nbsp;&nbsp; List of Standard GEDCOM Tags</a></span><span><a href="#p-43">43</a></span></li>
<li class="toc-1"><span><a href="#8-4">8.4&nbsp;&nbsp; List of User-defined GEDCOM Tags</a></span><span><a href="#p-47">47</a></span></li>
<li class="toc-1"><span><a href="#8-5">8.5&nbsp;&nbsp; List of Non-standard Tags</a></span><span><a href="#p-47">47</a></span></li>
<li class="toc-1"><span><a href="#8-6">8.6&nbsp;&nbsp; Members of GEDCOM-L Group</a></span><span><a href="#p-48">48</a></span></li>
</ul>
<div class="trl">-- GEDCOM 5.5.1 Specification GEDCOM-L Addendum --</div>
<div class="pager-hr-trl" id="p-5">page 5</div>
<ul class="leaders top-margin">
<li class="toc-1"><span><a href="#8-6">8.6&nbsp;&nbsp; Members of GEDCOM-L Group</a></span><span><a href="#p-48">48</a></span></li>
<li class="toc-0"><span><a href="#9-0">9&nbsp;&nbsp; What's New</a></span><span><a href="#p-49">49</a></span></li>
</ul>
<p> All content-related changes to the previous publication are marked light yellow like this line.</p>
<div class="trl">-- GEDCOM 5.5.1 Specification GEDCOM-L Addendum --</div>
<div class="pager-hr-trl" id="p-6">page 6</div>
......@@ -270,9 +271,6 @@
<strong>GEDCOM-L Addendum</strong></li>
</ul>
<h4 id="3-6-2">3.6.2 Document Changes</h4>
<p>All content-related changes to the previous publication are marked light yellow like this line.</p>
<div class="trl">-- GEDCOM 5.5.1 Specification GEDCOM-L Addendum --</div>
<div class="pager-hr-trl" id="p-9">page 9</div>
......@@ -484,32 +482,29 @@
<div class="trl">-- GEDCOM 5.5.1 Specification GEDCOM-L Addendum --</div>
<div class="pager-hr-trl" id="p-13">page 13</div>
<h3 id="4-8">4.8 _LOC_RECORD</h3>
<h3 id="4-8">4.8 LOCATION_RECORD</h3>
<table class="record-structure">
<tr><td class="code level-0" id="stru-lore">_LOC_RECORD:=</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">0 @&lt;XREF:_LOC&gt;@ _LOC &nbsp;{1:1}</td><td class="page">p. <a href="#p-31">31</a></td></tr>
<tr><td class="code level-0" id="stru-lore">LOCATION_RECORD:=</td><td class="page">p. <a href="#p-31">31</a></td></tr>
<tr><td class="code level-0">0 @&lt;XREF:_LOC&gt;@ _LOC &nbsp;{1:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">1 NAME &lt;PLACE_NAME&gt; &nbsp;{1:M}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">2 DATE &lt;DATE_VALUE&gt; &nbsp;{0:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">2 _NAMC &lt;PLACE_NAME_ADDITION&gt; &nbsp;{0:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">2 ABBR &lt;ABBREVIATION_OF_NAME&gt; &nbsp;{0:M}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">3 TYPE &lt;TYPE_OF_ABBREVIATION&gt; &nbsp;{0:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">2 LANG &lt;LANGUAGE_ID&gt; &nbsp;{0:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">2 &lt;&lt;SOURCE_CITATION&gt;&gt; &nbsp;{0:M}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">1 TYPE &lt;TYPE_OF_LOCATION&gt; &nbsp;{0:M}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">2 _GOVTYPE &lt;GOVID_OF_TYPE&gt; &nbsp;{0:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">2 DATE &lt;DATE_VALUE&gt; &nbsp;{0:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">2 &lt;&lt;SOURCE_CITATION&gt;&gt; &nbsp;{0:M}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">1 _FPOST &lt;FOKO_POSTCODE&gt; &nbsp;{0:M}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">2 DATE &lt;DATE_VALUE&gt; &nbsp;{0:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">1 _POST &lt;POSTAL_CODE&gt; &nbsp;{0:M}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">2 DATE &lt;DATE_VALUE&gt; &nbsp;{0:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">2 &lt;&lt;SOURCE_CITATION&gt;&gt; &nbsp;{0:M}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">1 _GOV &lt;GOV_IDENTIFIER&gt; &nbsp;{0:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">1 _FSTAE &lt;FOKO_TERRITORY_IDENTIFIER&gt; &nbsp;{0:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">1 _FCTRY &lt;FOKO_STATE_IDENTIFIER&gt; &nbsp;{0:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">1 MAP &nbsp;{0:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">2 LATI &lt;PLACE_LATITUDE&gt; &nbsp;{1:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">2 LONG &lt;PLACE_LONGITUDE&gt; &nbsp;{1:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">1 _MAIDENHEAD &lt;MAIDENHEAD_LOCATOR&gt; &nbsp;{0:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">1 RELI &lt;DENOMINATION&gt; &nbsp;{0:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">1 EVEN [&lt;EVENT_DESCRIPTOR&gt;|&lt;NULL&gt;] &nbsp;{0:M}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">2 &lt;&lt;EVENT_DETAIL&gt;&gt; &nbsp;{0:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">1 _LOC @&lt;XREF:_LOC&gt;@ &nbsp;{0:M}</td><td>&nbsp;</td></tr>
......@@ -885,7 +880,7 @@
<tr><td class="code level-0">n NATI &lt;NATIONAL_OR_TRIBAL_ORIGIN&gt; &nbsp;{1:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">+1 &lt;&lt;INDIVIDUAL_EVENT_DETAIL&gt;&gt; &nbsp;{0:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">|</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">n NCHI &lt;COUNT_OF_CHILDREN&gt;14 &nbsp;{1:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">n NCHI &lt;COUNT_OF_CHILDREN&gt; &nbsp;{1:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">+1 &lt;&lt;INDIVIDUAL_EVENT_DETAIL&gt;&gt; &nbsp;{0:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">|</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">n NMR &lt;COUNT_OF_MARRIAGES&gt; &nbsp;{1:1}</td><td>&nbsp;</td></tr>
......@@ -1347,8 +1342,7 @@
<h3 id="5-18">5.18 _STATUS_STRUCTURE / _STAT</h3>
<table class="record-structure">
<tr><td class="code level-0" id="stru-st">&lt;STATUS_STRUCTURE&gt;:=</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">n SOUR @&lt;XREF:SOUR&gt;@ &nbsp;{1:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">n _STAT &lt;STATUS_TEXT&gt;</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">n _STAT &lt;STATUS_TEXT&gt; &nbsp;{1:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">+1 DATE &lt;DATE_VALUE&gt; &nbsp;{0:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">+1 &lt;&lt;PLACE_STRUCTURE&gt;&gt; &nbsp;{0:1}</td><td class="page">p. <a href="#p-24">24</a></td></tr>
<tr><td class="code level-0">+1 &lt;&lt;NOTE_STRUCTURE&gt;&gt; &nbsp;{0:M}</td><td>&nbsp;</td></tr>
......@@ -1507,27 +1501,27 @@
<p>According to the standard all user-defined tags must begin with an underscore character "_" (0x95),
should only be interpreted in the context of the sending system and are defined as follows:</p>
<table class="record-structure">
<tr><td class="code level-0">NEW_TAG := {Size=1:15}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">NEW_TAG := {Size=2:15}</td><td>&nbsp;</td></tr>
</table>
<p><strong>GEDCOM-L Addendum</strong></p>
<ul>
<li>There is no restriction, which tags may be subordinated to a user-defined tag. In particular, it is
permissible to subordinate to a user defined tag further user-defined tag.</li>
permissible to subordinate to a user-defined tag further user-defined tag.</li>
<li>It is agreed that explicitly defined tags in the standard may be used as subordinated tags to
user-defined tags. In this case all provisions of the standards apply for the subordinated tag
with the exception of the in the Standard not listed assignment to its superior tag</li>
<li>It is recommended to explain user-defined tags used in a GEDCOM file in the file header by the
_SCHEMA_STRUCTURE – See details on page 36.</li>
_SCHEMA_STRUCTURE – See details on page <a href="#p-36">36</a>.</li>
<li>In agreements for the implementation of the GEDCOM standard 5.5.1 the program authors
have already defined for instance following user defined tags:
have already defined for instance following user-defined tags:
<ul>
<li>_LOC - Location record - See details on pages 13, 31 and as part of the PLAC record on page 23.</li>
<li>_RUFNAME - See details as part of the tag NAME on page 23 "Rufname".</li>
<li>_SCHEMA_STRUCTURE – See details on page 36.</li>
<li>_LOC - Location record - See details on pages <a href="#p-13">13</a>, <a href="#p-31">31</a> and as part of the PLAC record on page <a href="#p-23">23</a>.</li>
<li>_RUFNAME - See details as part of the tag NAME on page <a href="#p-23">23</a> "Rufname".</li>
<li>_SCHEMA_STRUCTURE – See details on page <a href="#p-36">36</a>.</li>
</ul>
</li>
</ul>
<h3 id="7-2">7.2 _LOC Record</h3>
<h3 id="7-2">7.2 Location Record</h3>
<p>Tag <strong>_LOC {LOCATION}</strong></p>
<p>Locations are described using the PLAC tag. In the GEDCOM standard, this tag is not sufficient to
represent the data of a hierarchical structure, the historical relationships between different locations
......@@ -1560,7 +1554,7 @@
<p>It is recommended to use for &lt;XREF:_LOC&gt; the form @Pnnn@ with nnn as a positive integer.</p>
<p>The location record itself is structured as follows:</p>
<table class="record-structure">
<tr><td class="code level-0">0 @&lt;XREF:_LOC&gt;@ _LOC</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">0 @&lt;XREF:_LOC&gt;@ _LOC &nbsp;{1:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">1 NAME &lt;PLACE_NAME&gt; &nbsp;{1:M}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">2 DATE &lt;DATE_VALUE&gt; &nbsp;{0:1}</td><td>&nbsp;</td></tr>
<tr><td class="code level-0">2 ABBR &lt;ABBREVIATION_OF_NAME&gt; &nbsp;{0:M}</td><td>&nbsp;</td></tr>
......@@ -1648,7 +1642,7 @@
<p><strong>&lt;TYPE_OF_ADMINISTRATIVE_IDENTIFIER&gt;</strong> := {Size=1:35} Type of official or public identifier.</p>
<p>__________________<br>
[1]GOV: Historic Gazetteer, a project of the "Society for Computergenealogy, e.V." (CompGen)</p>
[1]GOV: Historic Gazetteer, a project of the "Computer Genealogy Society of Germany" (CompGen) </p>
<div class="trl">-- GEDCOM 5.5.1 Specification GEDCOM-L Addendum --</div>
<div class="pager-hr-trl" id="p-34">page 34</div>
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment