+ +

The Gedcom parser library

- -

The intention of this page is to provide some explanation - of the gedcom parser, to aid development on and with it. First, -some practical issues of testing with the parser will be explained.
-
- + +

The intention of this page is to provide some explanation + of the gedcom parser, to aid development on and with it. First, some +practical issues of testing with the parser will be explained.
+
+

Basic testing
-

-You should be able to perform a basic test using the commands:
- + + You should be able to perform a basic test using the commands:
+

./configure - make - make check
-

- If everything goes OK, you'll see that some gedcom files are parsed, - and that each parse is successful. Note that the used gedcom files - are made by Heiner + make
+ make check
+ + If everything goes OK, you'll see that some gedcom files are parsed, + and that each parse is successful. Note that the used gedcom files + are made by Heiner Eichmann and are an excellent way to test gedcom parsers thoroughly.
-
- +
+

Preparing for further testing

- The basic testing described above doesn't show anything else than "Parse - succeeded", which is nice, but not very interesting. Some more detailed - tests are possible, via the testgedcom program that is generated - by make test.
-
- However, since the output that testgedcom generates is - in UTF-8 format (more on this later), some preparation is necessary to have - a full view on it. Basically, you need a terminal that understands - and can display UTF-8 encoded characters, and you need to proper fonts installed - to display them. I'll give some advice on this here, based on the - Red Hat 7.1 distribution that I use, with glibc 2.2 and XFree86 4.0.x. - Any other distribution that has the same or newer versions for these -components should give the same results.
-
- For the first issue, the UTF-8 capable terminal, the safest bet is -to use xterm in its unicode mode (which is supported by -the xterm coming with XFree86 4.0.x). UTF-8 capabilities - have only recently been added to gnome-terminal, so probably - that is not in your distribution yet (it certainly isn't in Red Hat 7.1).
-
- For the second issue, you'll need the ISO 10646-1 fonts. These + The basic testing described above doesn't show anything else than +"Parse succeeded", which is nice, but not very interesting. Some +more detailed tests are possible, via the testgedcom program +that is generated by make test.
+
+ However, since the output that testgedcom generates is + in UTF-8 format (more on this later), some preparation is necessary to +have a full view on it. Basically, you need a terminal that understands + and can display UTF-8 encoded characters, and you need to proper fonts installed + to display them. I'll give some advice on this here, based on the + Red Hat 7.1 distribution that I use, with glibc 2.2 and XFree86 4.0.x. Any + other distribution that has the same or newer versions for these components + should give the same results.
+
+ For the first issue, the UTF-8 capable terminal, the safest bet is +to use xterm in its unicode mode (which is supported by the + xterm coming with XFree86 4.0.x). UTF-8 capabilities + have only recently been added to gnome-terminal, so probably + that is not in your distribution yet (it certainly isn't in Red Hat 7.1).
+
+ For the second issue, you'll need the ISO 10646-1 fonts. These come also with XFree86 4.0.x.
-
- The way to start xterm in unicode mode is then e.g. (put - everything on 1 line !):
- -

LANG=en_GB.UTF-8 xterm -bg 'black' -fg 'DarkGrey' -cm + + The way to start xterm in unicode mode is then e.g. (put + everything on 1 line !): + + LANG=en_GB.UTF-8 xterm -bg 'black' -fg 'DarkGrey' -cm -fn '-Misc-Fixed-Medium-R-SemiCondensed--13-120-75-75-C-60-ISO10646-1' - - This first sets the LANG variable to a locale that - uses UTF-8, and then starts xterm with a proper Unicode font. +


+            This first sets the LANG variable to a locale that 
+ uses  UTF-8, and then starts xterm with a proper Unicode font. 
   Some  sample UTF-8 plain text files can be found 
-     here     .  Just cat them on the command line
+      here     .  Just cat them on the command line 
 and see the result.

-         

-                             
+          

+                                   
     Testing the parser with debugging
-     Given the UTF-8 capable terminal, you can now let the testgedcom
-      program print the values that it parses.  An example of a command
+      Given the UTF-8 capable terminal, you can now let the testgedcom
+       program print the values that it parses.  An example of a command 
   line is (in the gedcom directory):

-                             
+                                   
     ./testgedcom -dg t/ulhc.ged

-           
-     The -dg option instructs the parser to show its own debug 
- messages   (see ./testgedcom -h for the full set of options).
-  If  everything is OK, you'll see the values from the gedcom file,
-containing  a lot of special characters.

-           

-     For the ANSEL test file (t/ansel.ged), you have to set
+            
+      The -dg option instructs the parser to show its own debug
+  messages   (see ./testgedcom -h for the full set of options). 
+  If  everything is OK, you'll see the values from the gedcom file, containing
+ a lot of special characters.

+            

+      For the ANSEL test file (t/ansel.ged), you have to set 
 the   environment variable GCONV_PATH to the ansel
- subdirectory   of the gedcom directory:

-                                       
+  subdirectory   of the gedcom directory:

+                                               
       export GCONV_PATH=./ansel

-     ./testgedcom -dg t/ansel.ged

-             
-     This is because for the ANSEL character set an extra module is needed
- for  the iconv library (more on this later).  But again, this should
+      ./testgedcom -dg t/ansel.ged

+

+ This is because for the ANSEL character set an extra module is needed + for the iconv library (more on this later). But again, this should show a lot of special characters.
-
- +
+

Testing the lexers separately

- The lexers themselves can be tested separately. For the 1-byte -lexer (i.e. supporting the encodings with 1 byte per characters, such as -ASCII, ANSI and ANSEL), the sequence of commands would be:
- -

make clean - make test_1byte -

- This will show all tokens in the t/allged.ged test file. Similar -tests can be done using make test_hilo and make test_lohi - (for the unicode lexers).
-
- This concludes the testing setup. Now for some explanations...
-
+ The lexers themselves can be tested separately. For the 1-byte + lexer (i.e. supporting the encodings with 1 byte per characters, such +as ASCII, ANSI and ANSEL), the sequence of commands would be:
+

make clean + make test_1byte +

+ This will show all tokens in the t/allged.ged test file. Similar + tests can be done using make test_hilo and make test_lohi + (for the unicode lexers).
+
+ This concludes the testing setup. Now for some explanations...
+
+

Structure of the parser

- I see the structure of a program using the gedcom parser as follows:
-
- Gedcom parsing scheme

-
-
-
- TO BE COMPLETED...
- -

$Id: parser.html,v 1.2 2001/12/01 15:29:00 -verthezp Exp $
- $Name$
-
-

- + I see the structure of a program using the gedcom parser as follows:
+
+ Gedcom parsing scheme

+
+
+
+ TO BE COMPLETED...
+ +

$Id$
$Name$

+
+

Record -	Meaning -	Possible - `xref` types -
`REC_HEAD` -	The header of the GEDCOM file -	`NULL` -
`REC_FAM` -	A record describing a family -	`STRING` -
`REC_INDI` -	A record describing an individual -	`STRING` -
`REC_OBJE` -	A record describing a multimedia object -	`STRING` -
`REC_NOTE` -	A record describing a note -	`STRING` -
`REC_REPO` -	A record describing a source repository -	`STRING` -
`REC_SOUR` -	A record describing a source -	`STRING` -
`REC_SUBN` -	A record describing the submission -	`STRING` -
`REC_SUBM` -	A record describing the submitter -	`STRING` -
`REC_USER` -	An application-specific record (the `tag` - in the start callback contains the actually used tag). -	`NULL` - `STRING` -

Record +	Meaning +	Possible + `xref` types +
`REC_HEAD` +	The header of the GEDCOM file +	`NULL` +
`REC_FAM` +	A record describing a family +	`STRING` +
`REC_INDI` +	A record describing an individual +	`STRING` +
`REC_OBJE` +	A record describing a multimedia object +	`STRING` +
`REC_NOTE` +	A record describing a note +	`STRING` +
`REC_REPO` +	A record describing a source repository +	`STRING` +
`REC_SOUR` +	A record describing a source +	`STRING` +
`REC_SUBN` +	A record describing the submission +	`STRING` +
`REC_SUBM` +	A record describing the submitter +	`STRING` +
`REC_USER` +	An application-specific record (the `tag` + in the start callback contains the actually used tag). +	`NULL` + `STRING` +

Element -	Possible - tags - -	Used within -	Possible - `val` types - -
`ELT_HEAD_SOUR` -	`SOUR` -	`REC_HEAD` -	`STRING` -
`ELT_HEAD_SOUR_VERS` -	`VERS` -	`ELT_HEAD_SOUR` -	`STRING` -
`ELT_HEAD_SOUR_NAME` -	`NAME` -	`ELT_HEAD_SOUR` -	`STRING` -
`ELT_HEAD_SOUR_CORP` -	`CORP` -	`ELT_HEAD_SOUR` -	`STRING` -
`ELT_HEAD_SOUR_DATA` -	`DATA` -	`ELT_HEAD_SOUR` -	`STRING` -
`ELT_HEAD_SOUR_DATA_DATE` -	`DATE` -	`ELT_HEAD_SOUR_DATA` -	`DATE` -
`ELT_HEAD_SOUR_DATA_COPR` -	`COPR` -	`ELT_HEAD_SOUR_DATA` -	`STRING` -
`ELT_HEAD_DEST` -	`DEST` -	`REC_HEAD` -	`STRING` -
`ELT_HEAD_DATE` -	`DATE` -	`REC_HEAD` -	`DATE` -
`ELT_HEAD_DATE_TIME` -	`TIME` -	`ELT_HEAD_DATE` -	`STRING` -
`ELT_HEAD_SUBM` -	`SUBM` -	`REC_HEAD` -	`STRING` -
`ELT_HEAD_SUBN` -	`SUBN` -	`REC_HEAD` -	`STRING` -
`ELT_HEAD_FILE` -	`FILE` -	`REC_HEAD` -	`STRING` -
`ELT_HEAD_COPR` -	`COPR` -	`REC_HEAD` -	`STRING` -
`ELT_HEAD_GEDC` -	`GEDC` -	`REC_HEAD` -	`NULL` -
`ELT_HEAD_GEDC_VERS` -	`VERS` -	`ELT_HEAD_GEDC` -	`STRING` -
`ELT_HEAD_GEDC_FORM` -	`FORM` -	`ELT_HEAD_GEDC` -	`STRING` -
`ELT_HEAD_CHAR` -	`CHAR` -	`REC_HEAD` -	`STRING` -
`ELT_HEAD_CHAR_VERS` -	`VERS` -	`ELT_HEAD_CHAR` -	`STRING` -
`ELT_HEAD_LANG` -	`LANG` -	`REC_HEAD` -	`STRING` -
`ELT_HEAD_PLAC` -	`PLAC` -	`REC_HEAD` -	`NULL` -
`ELT_HEAD_PLAC_FORM` -	`FORM` -	`ELT_HEAD_PLAC` -	`STRING` -
`ELT_HEAD_NOTE` -	`NOTE` -	`REC_HEAD` -	`STRING` -
`ELT_FAM_HUSB` -	`HUSB` -	`REC_FAM` -	`STRING` -
`ELT_FAM_WIFE` -	`WIFE` -	`REC_FAM` -	`STRING` -
`ELT_FAM_CHIL` -	`CHIL` -	`REC_FAM` -	`STRING` -
`ELT_FAM_NCHI` -	`NCHI` -	`REC_FAM` -	`STRING` -
`ELT_FAM_SUBM` -	`SUBM` -	`REC_FAM` -	`STRING` -
`ELT_INDI_RESN` -	`RESN` -	`REC_INDI` -	`STRING` -
`ELT_INDI_SEX` -	`SEX` -	`REC_INDI` -	`STRING` -
`ELT_INDI_SUBM` -	`SUBM` -	`REC_INDI` -	`STRING` -
`ELT_INDI_ALIA` -	`ALIA` -	`REC_INDI` -	`STRING` -
`ELT_INDI_ANCI` -	`ANCI` -	`REC_INDI` -	`STRING` -
`ELT_INDI_DESI` -	`DESI` -	`REC_INDI` -	`STRING` -
`ELT_INDI_RFN` -	`RFN` -	`REC_INDI` -	`STRING` -
`ELT_INDI_AFN` -	`AFN` -	`REC_INDI` -	`STRING` -
`ELT_OBJE_FORM` -	`FORM` -	`REC_OBJE` -	`STRING` -
`ELT_OBJE_TITL` -	`TITL` -	`REC_OBJE` -	`STRING` -
`ELT_OBJE_BLOB` -	`BLOB` -	`REC_OBJE` -	`NULL` -
`ELT_OBJE_BLOB_CONT` -	`CONT` -	`ELT_OBJE_BLOB` -	`STRING` -
`ELT_OBJE_OBJE` -	`OBJE` -	`REC_OBJE` -	`STRING` -
`ELT_REPO_NAME` -	`NAME` -	`REC_REPO` -	`STRING` -
`ELT_SOUR_DATA` -	`DATA` -	`REC_SOUR` -	`NULL` -
`ELT_SOUR_DATA_EVEN` -	`EVEN` -	`ELT_SOUR_DATA` -	`STRING` -
`ELT_SOUR_DATA_EVEN_DATE` -	`DATE` -	`ELT_SOUR_DATA_EVEN` -	`DATE` -
`ELT_SOUR_DATA_EVEN_PLAC` -	`PLAC` -	`ELT_SOUR_DATA_EVEN` -	`STRING` -
`ELT_SOUR_DATA_AGNC` -	`AGNC` -	`ELT_SOUR_DATA` -	`STRING` -
`ELT_SOUR_AUTH` -	`AUTH` -	`REC_SOUR` -	`STRING` -
`ELT_SOUR_TITL` -	`TITL` -	`REC_SOUR` -	`STRING` -
`ELT_SOUR_ABBR` -	`ABBR` -	`REC_SOUR` -	`STRING` -
`ELT_SOUR_PUBL` -	`PUBL` -	`REC_SOUR` -	`STRING` -
`ELT_SOUR_TEXT` -	`TEXT` -	`REC_SOUR` -	`STRING` -
`ELT_SUBN_SUBM` -	`SUBM` -	`REC_SUBN` -	`STRING` -
`ELT_SUBN_FAMF` -	`FAMF` -	`REC_SUBN` -	`STRING` -
`ELT_SUBN_TEMP` -	`TEMP` -	`REC_SUBN` -	`STRING` -
`ELT_SUBN_ANCE` -	`ANCE` -	`REC_SUBN` -	`STRING` -
`ELT_SUBN_DESC` -	`DESC` -	`REC_SUBN` -	`STRING` -
`ELT_SUBN_ORDI` -	`ORDI` -	`REC_SUBN` -	`STRING` -
`ELT_SUBN_RIN` -	`RIN` -	`REC_SUBN` -	`STRING` -
`ELT_SUBM_NAME` -	`NAME` -	`REC_SUBM` -	`STRING` -
`ELT_SUBM_LANG` -	`LANG` -	`REC_SUBM` -	`STRING` -
`ELT_SUBM_RFN` -	`RFN` -	`REC_SUBM` -	`STRING` -
`ELT_SUBM_RIN` -	`RIN` -	`REC_SUBM` -	`STRING` -
`ELT_SUB_ADDR` -	`ADDR` -	`ELT_HEAD_SOUR_CORP, -REC_REPO, REC_SUBM, -ELT_SUB_FAM_EVT`, - `ELT_SUB_FAM_EVT_EVEN, -ELT_SUB_INDIV_ATTR, -ELT_SUB_INDIV_RESI, -ELT_SUB_INDIV_BIRT, -ELT_SUB_INDIV_GEN, -ELT_SUB_INDIV_ADOP -` - -	`STRING` -
`ELT_SUB_ADDR_CONT` -	`CONT` -	`ELT_SUB_ADDR` -	`STRING` -
`ELT_SUB_ADDR_ADR1` -	`ADR1` -	`ELT_SUB_ADDR` -	`STRING` -
`ELT_SUB_ADDR_ADR2` -	`ADR2` -	`ELT_SUB_ADDR` -	`STRING` -
`ELT_SUB_ADDR_CITY` -	`CITY` -	`ELT_SUB_ADDR` -	`STRING` -
`ELT_SUB_ADDR_STAE` -	`STAE` -	`ELT_SUB_ADDR` -	`STRING` -
`ELT_SUB_ADDR_POST` -	`POST` -	`ELT_SUB_ADDR` -	`STRING` -
`ELT_SUB_ADDR_CTRY` -	`CTRY` -	`ELT_SUB_ADDR` -	`STRING` -
`ELT_SUB_PHON` -	`PHON` -	`ELT_HEAD_SOUR_CORP, -REC_REPO, REC_SUBM, -ELT_SUB_FAM_EVT, -ELT_SUB_FAM_EVT_EVEN, -ELT_SUB_INDIV_ATTR, -ELT_SUB_INDIV_RESI, -ELT_SUB_INDIV_BIRT, -ELT_SUB_INDIV_GEN, -ELT_SUB_INDIV_ADOP -` - -	`STRING` -
`ELT_SUB_ASSO` -	`ASSO` -	`REC_INDI` -	`STRING` -
`ELT_SUB_ASSO_TYPE` -	`TYPE` -	`ELT_SUB_ASSO` -	`STRING` -
`ELT_SUB_ASSO_RELA` -	`RELA` -	`ELT_SUB_ASSO` -	`STRING` -
`ELT_SUB_CHAN` -	`CHAN` -	`REC_FAM, REC_INDI, -REC_OBJE, REC_NOTE, -REC_REPO, REC_SOUR, -REC_SUBM -` -	`NULL` -
`ELT_SUB_CHAN_DATE` -	`DATE` -	`ELT_SUB_CHAN` -	`DATE` -
`ELT_SUB_CHAN_TIME` -	`TIME` -	`ELT_SUB_CHAN_DATE` -	`STRING` -
`ELT_SUB_FAMC` -	`FAMC` -	`REC_INDI` -	`STRING` -
`ELT_SUB_FAMC_PEDI` -	`PEDI` -	`ELT_SUB_FAMC` -	`STRING` -
`ELT_SUB_CONT` -	`CONT` -	`ELT_HEAD_NOTE, REC_NOTE, -ELT_SOUR_AUTH, ELT_SOUR_TITL, -ELT_SOUR_PUBL, ELT_SOUR_TEXT, -ELT_SUB_NOTE, -ELT_SUB_SOUR, ELT_SUB_SOUR_TEXT -` -	`STRING` -
`ELT_SUB_CONC` -	`CONC` -	`ELT_HEAD_NOTE, REC_NOTE, -ELT_SOUR_AUTH, ELT_SOUR_TITL, -ELT_SOUR_PUBL, ELT_SOUR_TEXT, -ELT_SUB_NOTE, -ELT_SUB_SOUR, ELT_SUB_SOUR_TEXT -` -	`STRING` -
`ELT_SUB_EVT_TYPE` -	`TYPE` -	`ELT_SUB_FAM_EVT, -ELT_SUB_FAM_EVT_EVEN, -ELT_SUB_INDIV_ATTR, -ELT_SUB_INDIV_RESI, -ELT_SUB_INDIV_BIRT, -ELT_SUB_INDIV_GEN, -ELT_SUB_INDIV_ADOP -` -	`STRING` -
`ELT_SUB_EVT_DATE` -	`DATE` -	`ELT_SUB_FAM_EVT`, - `ELT_SUB_FAM_EVT_EVEN, -ELT_SUB_INDIV_ATTR, - ELT_SUB_INDIV_RESI, - ELT_SUB_INDIV_BIRT, - ELT_SUB_INDIV_GEN, - ELT_SUB_INDIV_ADOP -` - - -	`DATE` -
`ELT_SUB_EVT_AGE` -	`AGE` -	`ELT_SUB_FAM_EVT, -ELT_SUB_FAM_EVT_EVEN, -ELT_SUB_INDIV_ATTR, -ELT_SUB_INDIV_RESI, - ELT_SUB_INDIV_BIRT, - ELT_SUB_INDIV_GEN, - ELT_SUB_INDIV_ADOP` - - -	`STRING` -
`ELT_SUB_EVT_AGNC` -	`AGNC` -	`ELT_SUB_FAM_EVT, -ELT_SUB_FAM_EVT_EVEN, -ELT_SUB_INDIV_ATTR, -ELT_SUB_INDIV_RESI, - ELT_SUB_INDIV_BIRT, - ELT_SUB_INDIV_GEN, - ELT_SUB_INDIV_ADOP` - - -	`STRING` -
`ELT_SUB_EVT_CAUS` -	`CAUS` -	`ELT_SUB_FAM_EVT, -ELT_SUB_FAM_EVT_EVEN, -ELT_SUB_INDIV_ATTR, -ELT_SUB_INDIV_RESI, - ELT_SUB_INDIV_BIRT, - ELT_SUB_INDIV_GEN, - ELT_SUB_INDIV_ADOP` - - -	`STRING` -
`ELT_SUB_FAM_EVT` -	`ANUL, CENS, DIV, - DIVF, ENGA, MARR, - MARB, MARC, MARL, - MARS` -	`REC_FAM` -	`NULL - STRING` -
`ELT_SUB_FAM_EVT_HUSB` -	`HUSB` -	`ELT_SUB_FAM_EVT`, - `ELT_SUB_FAM_EVT_EVEN` -	`NULL` -
`ELT_SUB_FAM_EVT_WIFE` -	`WIFE` -	`ELT_SUB_FAM_EVT`, - `ELT_SUB_FAM_EVT_EVEN` -	`NULL` -
`ELT_SUB_FAM_EVT_AGE` -	`AGE` -	`ELT_SUB_FAM_EVT_HUSB`, - `ELT_SUB_FAM_EVT_WIFE` -	`STRING` -
`ELT_SUB_FAM_EVT_EVEN` -	`EVEN` -	`REC_FAM` -	`NULL` -
`ELT_SUB_IDENT_REFN` -	`REFN` -	`REC_FAM, REC_INDI, -REC_OBJE, REC_NOTE, -REC_REPO, REC_SOUR -` -	`STRING` -
`ELT_SUB_IDENT_REFN_TYPE` -	`TYPE` -	`ELT_SUB_IDENT_REFN` -	`STRING` -
`ELT_SUB_IDENT_RIN` -	`RIN` -	`REC_FAM, REC_INDI, -REC_OBJE, REC_NOTE, -REC_REPO, REC_SOUR -` -	`STRING` -
`ELT_SUB_INDIV_ATTR` -	`CAST, DSCR, EDUC, - IDNO, NATI, NCHR, - NMR, OCCU, PROP, - RELI, SSN, TITL` -	`REC_INDI` -	`STRING` -
`ELT_SUB_INDIV_RESI` -	`RESI` -	`REC_INDI` -	`NULL` -
`ELT_SUB_INDIV_BIRT` -	`BIRT, CHR` -	`REC_INDI` -	`NULL - STRING` -
`ELT_SUB_INDIV_BIRT_FAMC` -	`FAMC` -	`ELT_SUB_INDIV_BIRT` -	`STRING` -
`ELT_SUB_INDIV_GEN` -	`DEAT, BURI, CREM, - BAPM, BARM, BASM, - BLES, CHRA, CONF, - FCOM, ORDN, NATU, - EMIG, IMMI, CENS, - PROB, WILL, GRAD, - RETI` -	`REC_INDI` -	`NULL - STRING` -
`ELT_SUB_INDIV_ADOP` -	`ADOP` -	`REC_INDI` -	`NULL - STRING` -
`ELT_SUB_INDIV_ADOP_FAMC` -	`FAMC` -	`ELT_SUB_INDIV_ADOP` -	`STRING` -
`ELT_SUB_INDIV_ADOP_FAMC_ADOP` -	`ADOP` -	`ELT_SUB_INDIV_ADOP_FAMC` -	`STRING` -
`ELT_SUB_INDIV_EVEN` -	`EVEN` -	`REC_INDI` -	`NULL` -
`ELT_SUB_LIO_BAPL` -	`BAPL, CONL, ENDL` -	`REC_INDI` -	`NULL` -
`ELT_SUB_LIO_BAPL_STAT` -	`STAT` -	`ELT_SUB_LIO_BAPL, -ELT_SUB_LIO_SLGC -` -	`STRING` -
`ELT_SUB_LIO_BAPL_DATE` -	`DATE` -	`ELT_SUB_LIO_BAPL, - ELT_SUB_LIO_SLGC -` - -	`DATE` -
`ELT_SUB_LIO_BAPL_TEMP` -	`TEMP` -	`ELT_SUB_LIO_BAPL, - ELT_SUB_LIO_SLGC -` - -	`STRING` -
`ELT_SUB_LIO_BAPL_PLAC` -	`PLAC` -	`ELT_SUB_LIO_BAPL, - ELT_SUB_LIO_SLGC -` - -	`STRING` -
`ELT_SUB_LIO_SLGC` -	`SLGC` -	`REC_INDI` -	`NULL` -
`ELT_SUB_LIO_SLGC_FAMC` -	`FAMC` -	`ELT_SUB_LIO_SLGC` -	`STRING` -
`ELT_SUB_LSS_SLGS` -	`SLGS` -	`REC_FAM` -	`NULL` -
`ELT_SUB_LSS_SLGS_STAT` -	`STAT` -	`ELT_SUB_LSS_SLGS` -	`STRING` -
`ELT_SUB_LSS_SLGS_DATE` -	`DATE` -	`ELT_SUB_LSS_SLGS` -	`DATE` -
`ELT_SUB_LSS_SLGS_TEMP` -	`TEMP` -	`ELT_SUB_LSS_SLGS` -	`STRING` -
`ELT_SUB_LSS_SLGS_PLAC` -	`PLAC` -	`ELT_SUB_LSS_SLGS` -	`STRING` -
`ELT_SUB_MULTIM_OBJE` -	`OBJE` -	`REC_FAM, REC_INDI, -REC_SOUR, REC_SUBM, -ELT_SUB_FAM_EVT, -ELT_SUB_FAM_EVT_EVEN, -ELT_SUB_INDIV_ATTR, -ELT_SUB_INDIV_RESI, - ELT_SUB_INDIV_BIRT, - ELT_SUB_INDIV_GEN, - ELT_SUB_INDIV_ADOP, -ELT_SUB_SOUR` -	`NULL` -
`ELT_SUB_MULTIM_OBJE_FORM` -	`FORM` -	`ELT_SUB_MULTIM_OBJE` -	`STRING` -
`ELT_SUB_MULTIM_OBJE_TITL` -	`TITL` -	`ELT_SUB_MULTIM_OBJE` -	`STRING` -
`ELT_SUB_MULTIM_OBJE_FILE` -	`FILE` -	`ELT_SUB_MULTIM_OBJE` -	`STRING` -
`ELT_SUB_NOTE` -	`NOTE` -	`REC_FAM, REC_INDI, -REC_OBJE, REC_REPO, -REC_SOUR, ELT_SOUR_DATA, -ELT_SUB_ASSO, ELT_SUB_CHAN, -ELT_SUB_FAMC,ELT_SUB_FAM_EVT, -ELT_SUB_FAM_EVT_EVEN, -ELT_SUB_INDIV_ATTR, -ELT_SUB_INDIV_RESI, - ELT_SUB_INDIV_BIRT, - ELT_SUB_INDIV_GEN, - ELT_SUB_INDIV_ADOP, -ELT_SUB_LIO_BAPL, -ELT_SUB_LIO_SLGC, -ELT_SUB_LSS_SLGS, -ELT_SUB_MULTIM_OBJE, -ELT_SUB_PERS_NAME, -ELT_SUB_PLAC, -ELT_SUB_SOUR, -ELT_SUB_REPO, -ELT_SUB_FAMS` -	`NULL - STRING` -
`ELT_SUB_PERS_NAME` -	`NAME` -	`REC_INDI` -	`STRING` -
`ELT_SUB_PERS_NAME_NPFX` -	`NPFX` -	`ELT_SUB_PERS_NAME` -	`STRING` -
`ELT_SUB_PERS_NAME_GIVN` -	`GIVN` -	`ELT_SUB_PERS_NAME` -	`STRING` -
`ELT_SUB_PERS_NAME_NICK` -	`NICK` -	`ELT_SUB_PERS_NAME` -	`STRING` -
`ELT_SUB_PERS_NAME_SPFX` -	`SPFX` -	`ELT_SUB_PERS_NAME` -	`STRING` -
`ELT_SUB_PERS_NAME_SURN` -	`SURN` -	`ELT_SUB_PERS_NAME` -	`STRING` -
`ELT_SUB_PERS_NAME_NSFX` -	`NSFX` -	`ELT_SUB_PERS_NAME` -	`STRING` -
`ELT_SUB_PLAC` -	`PLAC` -	`ELT_SUB_FAM_EVT`, - `ELT_SUB_FAM_EVT_EVEN, -ELT_SUB_INDIV_ATTR, -ELT_SUB_INDIV_RESI` -	`STRING` -
`ELT_SUB_PLAC_FORM` -	`FORM` -	`ELT_SUB_PLAC` -	`STRING` -
`ELT_SUB_SOUR` -	`SOUR` -	`REC_FAM, REC_INDI, -REC_NOTE, ELT_SUB_ASSO -ELT_SUB_FAM_EVT, -ELT_SUB_FAM_EVT_EVEN, -ELT_SUB_INDIV_ATTR, -ELT_SUB_INDIV_RESI, - ELT_SUB_INDIV_BIRT, - ELT_SUB_INDIV_GEN, - ELT_SUB_INDIV_ADOP, -ELT_SUB_LIO_BAPL, -ELT_SUB_LIO_SLGC, -ELT_SUB_LSS_SLGS, -ELT_SUB_NOTE, -ELT_SUB_PERS_NAME, -ELT_SUB_PLAC` -	`STRING` -
`ELT_SUB_SOUR_PAGE` -	`PAGE` -	`ELT_SUB_SOUR` -	`STRING` -
`ELT_SUB_SOUR_EVEN` -	`EVEN` -	`ELT_SUB_SOUR` -	`STRING` -
`ELT_SUB_SOUR_EVEN_ROLE` -	`ROLE` -	`ELT_SUB_SOUR_EVEN` -	`STRING` -
`ELT_SUB_SOUR_DATA` -	`DATA` -	`ELT_SUB_SOUR` -	`NULL` -
`ELT_SUB_SOUR_DATA_DATE` -	`DATE` -	`ELT_SUB_SOUR_DATA` -	`DATE` -
`ELT_SUB_SOUR_TEXT` -	`TEXT` -	`ELT_SUB_SOUR -ELT_SUB_SOUR_DATA` -	`STRING` -
`ELT_SUB_SOUR_QUAY` -	`QUAY` -	`ELT_SUB_SOUR` -	`STRING` -
`ELT_SUB_REPO` -	`REPO` -	`REC_SOUR` -	`STRING` -
`ELT_SUB_REPO_CALN` -	`CALN` -	`ELT_SUB_REPO` -	`STRING` -
`ELT_SUB_REPO_CALN_MEDI` -	`MEDI` -	`ELT_SUB_REPO_CALN` -	`STRING` -
`ELT_SUB_FAMS` -	`FAMS` -	`REC_INDI` -	`STRING` -
`ELT_USER` -	`any tag starting - with an underscore` -	`anywhere` -	`NULL - STRING` -

-	type checker -	cast operator -
null value -	`GEDCOM_IS_NULL(val)` -	N/A -
string -	`GEDCOM_IS_STRING(val)` -	`char* str = GEDCOM_STRING(val);` -
date -	`GEDCOM_IS_DATE(val)` -	`struct date_value dv = GEDCOM_DATE(val);`

Date_value_type +	Element +	Possible + tags + +	Used within +	Possible + `val` types + +
`ELT_HEAD_SOUR` +	`SOUR` +	`REC_HEAD` +	`STRING` +
`ELT_HEAD_SOUR_VERS` +	`VERS` +	`ELT_HEAD_SOUR` +	`STRING` +
`ELT_HEAD_SOUR_NAME` +	`NAME` +	`ELT_HEAD_SOUR` +	`STRING` +
`ELT_HEAD_SOUR_CORP` +	`CORP` +	`ELT_HEAD_SOUR` +	`STRING` +
`ELT_HEAD_SOUR_DATA` +	`DATA` +	`ELT_HEAD_SOUR` +	`STRING` +
`ELT_HEAD_SOUR_DATA_DATE` +	`DATE` +	`ELT_HEAD_SOUR_DATA` +	`DATE` +
`ELT_HEAD_SOUR_DATA_COPR` +	`COPR` +	`ELT_HEAD_SOUR_DATA` +	`STRING` +
`ELT_HEAD_DEST` +	`DEST` +	`REC_HEAD` +	`STRING` +
`ELT_HEAD_DATE` +	`DATE` +	`REC_HEAD` +	`DATE` +
`ELT_HEAD_DATE_TIME` +	`TIME` +	`ELT_HEAD_DATE` +	`STRING` +
`ELT_HEAD_SUBM` +	`SUBM` +	`REC_HEAD` +	`STRING` +
`ELT_HEAD_SUBN` +	`SUBN` +	`REC_HEAD` +	`STRING` +
`ELT_HEAD_FILE` +	`FILE` +	`REC_HEAD` +	`STRING` +
`ELT_HEAD_COPR` +	`COPR` +	`REC_HEAD` +	`STRING` +
`ELT_HEAD_GEDC` +	`GEDC` +	`REC_HEAD` +	`NULL` +
`ELT_HEAD_GEDC_VERS` +	`VERS` +	`ELT_HEAD_GEDC` +	`STRING` +
`ELT_HEAD_GEDC_FORM` +	`FORM` +	`ELT_HEAD_GEDC` +	`STRING` +
`ELT_HEAD_CHAR` +	`CHAR` +	`REC_HEAD` +	`STRING` +
`ELT_HEAD_CHAR_VERS` +	`VERS` +	`ELT_HEAD_CHAR` +	`STRING` +
`ELT_HEAD_LANG` +	`LANG` +	`REC_HEAD` +	`STRING` +
`ELT_HEAD_PLAC` +	`PLAC` +	`REC_HEAD` +	`NULL` +
`ELT_HEAD_PLAC_FORM` +	`FORM` +	`ELT_HEAD_PLAC` +	`STRING` +
`ELT_HEAD_NOTE` +	`NOTE` +	`REC_HEAD` +	`STRING` +
`ELT_FAM_HUSB` +	`HUSB` +	`REC_FAM` +	`STRING` +
`ELT_FAM_WIFE` +	`WIFE` +	`REC_FAM` +	`STRING` +
`ELT_FAM_CHIL` +	`CHIL` +	`REC_FAM` +	`STRING` +
`ELT_FAM_NCHI` +	`NCHI` +	`REC_FAM` +	`STRING` +
`ELT_FAM_SUBM` +	`SUBM` +	`REC_FAM` +	`STRING` +
`ELT_INDI_RESN` +	`RESN` +	`REC_INDI` +	`STRING` +
`ELT_INDI_SEX` +	`SEX` +	`REC_INDI` +	`STRING` +
`ELT_INDI_SUBM` +	`SUBM` +	`REC_INDI` +	`STRING` +
`ELT_INDI_ALIA` +	`ALIA` +	`REC_INDI` +	`STRING` +
`ELT_INDI_ANCI` +	`ANCI` +	`REC_INDI` +	`STRING` +
`ELT_INDI_DESI` +	`DESI` +	`REC_INDI` +	`STRING` +
`ELT_INDI_RFN` +	`RFN` +	`REC_INDI` +	`STRING` +
`ELT_INDI_AFN` +	`AFN` +	`REC_INDI` +	`STRING` +
`ELT_OBJE_FORM` +	`FORM` +	`REC_OBJE` +	`STRING` +
`ELT_OBJE_TITL` +	`TITL` +	`REC_OBJE` +	`STRING` +
`ELT_OBJE_BLOB` +	`BLOB` +	`REC_OBJE` +	`NULL` +
`ELT_OBJE_BLOB_CONT` +	`CONT` +	`ELT_OBJE_BLOB` +	`STRING` +
`ELT_OBJE_OBJE` +	`OBJE` +	`REC_OBJE` +	`STRING` +
`ELT_REPO_NAME` +	`NAME` +	`REC_REPO` +	`STRING` +
`ELT_SOUR_DATA` +	`DATA` +	`REC_SOUR` +	`NULL` +
`ELT_SOUR_DATA_EVEN` +	`EVEN` +	`ELT_SOUR_DATA` +	`STRING` +
`ELT_SOUR_DATA_EVEN_DATE` +	`DATE` +	`ELT_SOUR_DATA_EVEN` +	`DATE` +
`ELT_SOUR_DATA_EVEN_PLAC` +	`PLAC` +	`ELT_SOUR_DATA_EVEN` +	`STRING` +
`ELT_SOUR_DATA_AGNC` +	`AGNC` +	`ELT_SOUR_DATA` +	`STRING` +
`ELT_SOUR_AUTH` +	`AUTH` +	`REC_SOUR` +	`STRING` +
`ELT_SOUR_TITL` +	`TITL` +	`REC_SOUR` +	`STRING` +
`ELT_SOUR_ABBR` +	`ABBR` +	`REC_SOUR` +	`STRING` +
`ELT_SOUR_PUBL` +	`PUBL` +	`REC_SOUR` +	`STRING` +
`ELT_SOUR_TEXT` +	`TEXT` +	`REC_SOUR` +	`STRING` +
`ELT_SUBN_SUBM` +	`SUBM` +	`REC_SUBN` +	`STRING` +
`ELT_SUBN_FAMF` +	`FAMF` +	`REC_SUBN` +	`STRING` +
`ELT_SUBN_TEMP` +	`TEMP` +	`REC_SUBN` +	`STRING` +
`ELT_SUBN_ANCE` +	`ANCE` +	`REC_SUBN` +	`STRING` +
`ELT_SUBN_DESC` +	`DESC` +	`REC_SUBN` +	`STRING` +
`ELT_SUBN_ORDI` +	`ORDI` +	`REC_SUBN` +	`STRING` +
`ELT_SUBN_RIN` +	`RIN` +	`REC_SUBN` +	`STRING` +
`ELT_SUBM_NAME` +	`NAME` +	`REC_SUBM` +	`STRING` +
`ELT_SUBM_LANG` +	`LANG` +	`REC_SUBM` +	`STRING` +
`ELT_SUBM_RFN` +	`RFN` +	`REC_SUBM` +	`STRING` +
`ELT_SUBM_RIN` +	`RIN` +	`REC_SUBM` +	`STRING` +
`ELT_SUB_ADDR` +	`ADDR` +	`ELT_HEAD_SOUR_CORP, + REC_REPO, REC_SUBM, +ELT_SUB_FAM_EVT`, + `ELT_SUB_FAM_EVT_EVEN, + ELT_SUB_INDIV_ATTR, + ELT_SUB_INDIV_RESI, + ELT_SUB_INDIV_BIRT, + ELT_SUB_INDIV_GEN, + ELT_SUB_INDIV_ADOP +` + +	`STRING` +
`ELT_SUB_ADDR_CONT` +	`CONT` +	`ELT_SUB_ADDR` +	`STRING` +
`ELT_SUB_ADDR_ADR1` +	`ADR1` +	`ELT_SUB_ADDR` +	`STRING` +
`ELT_SUB_ADDR_ADR2` +	`ADR2` +	`ELT_SUB_ADDR` +	`STRING` +
`ELT_SUB_ADDR_CITY` +	`CITY` +	`ELT_SUB_ADDR` +	`STRING` +
`ELT_SUB_ADDR_STAE` +	`STAE` +	`ELT_SUB_ADDR` +	`STRING` +
`ELT_SUB_ADDR_POST` +	`POST` +	`ELT_SUB_ADDR` +	`STRING` +
`ELT_SUB_ADDR_CTRY` +	`CTRY` +	`ELT_SUB_ADDR` +	`STRING` +
`ELT_SUB_PHON` +	`PHON` +	`ELT_HEAD_SOUR_CORP, + REC_REPO, REC_SUBM, +ELT_SUB_FAM_EVT, +ELT_SUB_FAM_EVT_EVEN, + ELT_SUB_INDIV_ATTR, + ELT_SUB_INDIV_RESI, + ELT_SUB_INDIV_BIRT, + ELT_SUB_INDIV_GEN, + ELT_SUB_INDIV_ADOP +` + +	`STRING` +
`ELT_SUB_ASSO` +	`ASSO` +	`REC_INDI` +	`STRING` +
`ELT_SUB_ASSO_TYPE` +	`TYPE` +	`ELT_SUB_ASSO` +	`STRING` +
`ELT_SUB_ASSO_RELA` +	`RELA` +	`ELT_SUB_ASSO` +	`STRING` +
`ELT_SUB_CHAN` +	`CHAN` +	`REC_FAM, REC_INDI, + REC_OBJE, REC_NOTE, + REC_REPO, REC_SOUR, + REC_SUBM +` +	`NULL` +
`ELT_SUB_CHAN_DATE` +	`DATE` +	`ELT_SUB_CHAN` +	`DATE` +
`ELT_SUB_CHAN_TIME` +	`TIME` +	`ELT_SUB_CHAN_DATE` +	`STRING` +
`ELT_SUB_FAMC` +	`FAMC` +	`REC_INDI` +	`STRING` +
`ELT_SUB_FAMC_PEDI` +	`PEDI` +	`ELT_SUB_FAMC` +	`STRING` +
`ELT_SUB_CONT` +	`CONT` +	`ELT_HEAD_NOTE, REC_NOTE, + ELT_SOUR_AUTH, ELT_SOUR_TITL, + ELT_SOUR_PUBL, ELT_SOUR_TEXT, + ELT_SUB_NOTE, + ELT_SUB_SOUR, ELT_SUB_SOUR_TEXT +` +	`STRING` +
`ELT_SUB_CONC` +	`CONC` +	`ELT_HEAD_NOTE, REC_NOTE, + ELT_SOUR_AUTH, ELT_SOUR_TITL, + ELT_SOUR_PUBL, ELT_SOUR_TEXT, + ELT_SUB_NOTE, + ELT_SUB_SOUR, ELT_SUB_SOUR_TEXT +` +	`STRING` +
`ELT_SUB_EVT_TYPE` +	`TYPE` +	`ELT_SUB_FAM_EVT, +ELT_SUB_FAM_EVT_EVEN, + ELT_SUB_INDIV_ATTR, + ELT_SUB_INDIV_RESI, + ELT_SUB_INDIV_BIRT, + ELT_SUB_INDIV_GEN, + ELT_SUB_INDIV_ADOP +` +	`STRING` +
`ELT_SUB_EVT_DATE` +	`DATE` +	`ELT_SUB_FAM_EVT`, + `ELT_SUB_FAM_EVT_EVEN, + ELT_SUB_INDIV_ATTR, + ELT_SUB_INDIV_RESI, + ELT_SUB_INDIV_BIRT, + ELT_SUB_INDIV_GEN, + ELT_SUB_INDIV_ADOP +` + + +	`DATE` +
`ELT_SUB_EVT_AGE` +	`AGE` +	`ELT_SUB_FAM_EVT, +ELT_SUB_FAM_EVT_EVEN, + ELT_SUB_INDIV_ATTR, + ELT_SUB_INDIV_RESI, + ELT_SUB_INDIV_BIRT, + ELT_SUB_INDIV_GEN, + ELT_SUB_INDIV_ADOP` + + +	`STRING` +
`ELT_SUB_EVT_AGNC` +	`AGNC` +	`ELT_SUB_FAM_EVT, +ELT_SUB_FAM_EVT_EVEN, + ELT_SUB_INDIV_ATTR, + ELT_SUB_INDIV_RESI, + ELT_SUB_INDIV_BIRT, + ELT_SUB_INDIV_GEN, + ELT_SUB_INDIV_ADOP` + + +	`STRING` +
`ELT_SUB_EVT_CAUS` +	`CAUS` +	`ELT_SUB_FAM_EVT, +ELT_SUB_FAM_EVT_EVEN, + ELT_SUB_INDIV_ATTR, + ELT_SUB_INDIV_RESI, + ELT_SUB_INDIV_BIRT, + ELT_SUB_INDIV_GEN, + ELT_SUB_INDIV_ADOP` + + +	`STRING` +
`ELT_SUB_FAM_EVT` +	`ANUL, CENS, DIV, + DIVF, ENGA, MARR, + MARB, MARC, MARL, + MARS` +	`REC_FAM` +	`NULL + STRING` +
`ELT_SUB_FAM_EVT_HUSB` +	`HUSB` +	`ELT_SUB_FAM_EVT`, + `ELT_SUB_FAM_EVT_EVEN` +	`NULL` +
`ELT_SUB_FAM_EVT_WIFE` +	`WIFE` +	`ELT_SUB_FAM_EVT`, + `ELT_SUB_FAM_EVT_EVEN` +	`NULL` +
`ELT_SUB_FAM_EVT_AGE` +	`AGE` +	`ELT_SUB_FAM_EVT_HUSB`, + `ELT_SUB_FAM_EVT_WIFE` +	`STRING` +
`ELT_SUB_FAM_EVT_EVEN` +	`EVEN` +	`REC_FAM` +	`NULL` +
`ELT_SUB_IDENT_REFN` +	`REFN` +	`REC_FAM, REC_INDI, + REC_OBJE, REC_NOTE, + REC_REPO, REC_SOUR +` +	`STRING` +
`ELT_SUB_IDENT_REFN_TYPE` +	`TYPE` +	`ELT_SUB_IDENT_REFN` +	`STRING` +
`ELT_SUB_IDENT_RIN` +	`RIN` +	`REC_FAM, REC_INDI, + REC_OBJE, REC_NOTE, + REC_REPO, REC_SOUR +` +	`STRING` +
`ELT_SUB_INDIV_ATTR` +	`CAST, DSCR, EDUC, + IDNO, NATI, NCHR, + NMR, OCCU, PROP, + RELI, SSN, TITL` +	`REC_INDI` +	`STRING` +
`ELT_SUB_INDIV_RESI` +	`RESI` +	`REC_INDI` +	`NULL` +
`ELT_SUB_INDIV_BIRT` +	`BIRT, CHR` +	`REC_INDI` +	`NULL + STRING` +
`ELT_SUB_INDIV_BIRT_FAMC` +	`FAMC` +	`ELT_SUB_INDIV_BIRT` +	`STRING` +
`ELT_SUB_INDIV_GEN` +	`DEAT, BURI, CREM, + BAPM, BARM, BASM, + BLES, CHRA, CONF, + FCOM, ORDN, NATU, + EMIG, IMMI, CENS, + PROB, WILL, GRAD, + RETI` +	`REC_INDI` +	`NULL + STRING` +
`ELT_SUB_INDIV_ADOP` +	`ADOP` +	`REC_INDI` +	`NULL + STRING` +
`ELT_SUB_INDIV_ADOP_FAMC` +	`FAMC` +	`ELT_SUB_INDIV_ADOP` +	`STRING` +
`ELT_SUB_INDIV_ADOP_FAMC_ADOP` +	`ADOP` +	`ELT_SUB_INDIV_ADOP_FAMC` +	`STRING` +
`ELT_SUB_INDIV_EVEN` +	`EVEN` +	`REC_INDI` +	`NULL` +
`ELT_SUB_LIO_BAPL` +	`BAPL, CONL, ENDL` +	`REC_INDI` +	`NULL` +
`ELT_SUB_LIO_BAPL_STAT` +	`STAT` +	`ELT_SUB_LIO_BAPL, + ELT_SUB_LIO_SLGC +` +	`STRING` +
`ELT_SUB_LIO_BAPL_DATE` +	`DATE` +	`ELT_SUB_LIO_BAPL, + ELT_SUB_LIO_SLGC +` + +	`DATE` +
`ELT_SUB_LIO_BAPL_TEMP` +	`TEMP` +	`ELT_SUB_LIO_BAPL, + ELT_SUB_LIO_SLGC +` + +	`STRING` +
`ELT_SUB_LIO_BAPL_PLAC` +	`PLAC` +	`ELT_SUB_LIO_BAPL, + ELT_SUB_LIO_SLGC +` + +	`STRING` +
`ELT_SUB_LIO_SLGC` +	`SLGC` +	`REC_INDI` +	`NULL` +
`ELT_SUB_LIO_SLGC_FAMC` +	`FAMC` +	`ELT_SUB_LIO_SLGC` +	`STRING` +
`ELT_SUB_LSS_SLGS` +	`SLGS` +	`REC_FAM` +	`NULL` +
`ELT_SUB_LSS_SLGS_STAT` +	`STAT` +	`ELT_SUB_LSS_SLGS` +	`STRING` +
`ELT_SUB_LSS_SLGS_DATE` +	`DATE` +	`ELT_SUB_LSS_SLGS` +	`DATE` +
`ELT_SUB_LSS_SLGS_TEMP` +	`TEMP` +	`ELT_SUB_LSS_SLGS` +	`STRING` +
`ELT_SUB_LSS_SLGS_PLAC` +	`PLAC` +	`ELT_SUB_LSS_SLGS` +	`STRING` +
`ELT_SUB_MULTIM_OBJE` +	`OBJE` +	`REC_FAM, REC_INDI, + REC_SOUR, REC_SUBM, +ELT_SUB_FAM_EVT, + ELT_SUB_FAM_EVT_EVEN, + ELT_SUB_INDIV_ATTR, + ELT_SUB_INDIV_RESI, + ELT_SUB_INDIV_BIRT, + ELT_SUB_INDIV_GEN, + ELT_SUB_INDIV_ADOP, + ELT_SUB_SOUR` +	`NULL` +
`ELT_SUB_MULTIM_OBJE_FORM` +	`FORM` +	`ELT_SUB_MULTIM_OBJE` +	`STRING` +
`ELT_SUB_MULTIM_OBJE_TITL` +	`TITL` +	`ELT_SUB_MULTIM_OBJE` +	`STRING` +
`ELT_SUB_MULTIM_OBJE_FILE` +	`FILE` +	`ELT_SUB_MULTIM_OBJE` +	`STRING` +
`ELT_SUB_NOTE` +	`NOTE` +	`REC_FAM, REC_INDI, + REC_OBJE, REC_REPO, + REC_SOUR, ELT_SOUR_DATA, + ELT_SUB_ASSO, ELT_SUB_CHAN, + ELT_SUB_FAMC,ELT_SUB_FAM_EVT, + ELT_SUB_FAM_EVT_EVEN, + ELT_SUB_INDIV_ATTR, + ELT_SUB_INDIV_RESI, + ELT_SUB_INDIV_BIRT, + ELT_SUB_INDIV_GEN, + ELT_SUB_INDIV_ADOP, + ELT_SUB_LIO_BAPL, + ELT_SUB_LIO_SLGC, + ELT_SUB_LSS_SLGS, + ELT_SUB_MULTIM_OBJE, + ELT_SUB_PERS_NAME, + ELT_SUB_PLAC, + ELT_SUB_SOUR, + ELT_SUB_REPO, + ELT_SUB_FAMS` +	`NULL + STRING` +
`ELT_SUB_PERS_NAME` +	`NAME` +	`REC_INDI` +	`STRING` +
`ELT_SUB_PERS_NAME_NPFX` +	`NPFX` +	`ELT_SUB_PERS_NAME` +	`STRING` +
`ELT_SUB_PERS_NAME_GIVN` +	`GIVN` +	`ELT_SUB_PERS_NAME` +	`STRING` +
`ELT_SUB_PERS_NAME_NICK` +	`NICK` +	`ELT_SUB_PERS_NAME` +	`STRING` +
`ELT_SUB_PERS_NAME_SPFX` +	`SPFX` +	`ELT_SUB_PERS_NAME` +	`STRING` +
`ELT_SUB_PERS_NAME_SURN` +	`SURN` +	`ELT_SUB_PERS_NAME` +	`STRING` +
`ELT_SUB_PERS_NAME_NSFX` +	`NSFX` +	`ELT_SUB_PERS_NAME` +	`STRING` +
`ELT_SUB_PLAC` +	`PLAC` +	`ELT_SUB_FAM_EVT`, + `ELT_SUB_FAM_EVT_EVEN, + ELT_SUB_INDIV_ATTR, + ELT_SUB_INDIV_RESI` +	`STRING` +
`ELT_SUB_PLAC_FORM` +	`FORM` +	`ELT_SUB_PLAC` +	`STRING` +
`ELT_SUB_SOUR` +	`SOUR` +	`REC_FAM, REC_INDI, + REC_NOTE, ELT_SUB_ASSO +ELT_SUB_FAM_EVT, +ELT_SUB_FAM_EVT_EVEN, + ELT_SUB_INDIV_ATTR, + ELT_SUB_INDIV_RESI, + ELT_SUB_INDIV_BIRT, + ELT_SUB_INDIV_GEN, + ELT_SUB_INDIV_ADOP, + ELT_SUB_LIO_BAPL, + ELT_SUB_LIO_SLGC, + ELT_SUB_LSS_SLGS, + ELT_SUB_NOTE, + ELT_SUB_PERS_NAME, + ELT_SUB_PLAC` +	`STRING` +
`ELT_SUB_SOUR_PAGE` +	`PAGE` +	`ELT_SUB_SOUR` +	`STRING` +
`ELT_SUB_SOUR_EVEN` +	`EVEN` +	`ELT_SUB_SOUR` +	`STRING` +
`ELT_SUB_SOUR_EVEN_ROLE` +	`ROLE`	Meaning +	`ELT_SUB_SOUR_EVEN`	Relevant members +	`STRING`
`DV_NO_MODIFIER` +	`ELT_SUB_SOUR_DATA`	just a simple date +	`DATA`	date1 +	`ELT_SUB_SOUR` +	`NULL`
`DV_BEFORE` +	`ELT_SUB_SOUR_DATA_DATE` +	`DATE`	a range (BEFORE date1) +	`ELT_SUB_SOUR_DATA`	date1 +	`DATE`
`DV_AFTER` +	`ELT_SUB_SOUR_TEXT`	a range (AFTER date1) +	`TEXT`	date1 +	`ELT_SUB_SOUR + ELT_SUB_SOUR_DATA` +	`STRING`
`DV_BETWEEN` +	`ELT_SUB_SOUR_QUAY` +	`QUAY`	a range (BETWEEN date1 AND date2) +	`ELT_SUB_SOUR`	date1, date2 +	`STRING`
`DV_FROM` +	`ELT_SUB_REPO`	a period (FROM date1) +	`REPO`	date1 +	`REC_SOUR` +	`STRING`
`DV_TO` +	`ELT_SUB_REPO_CALN` +	`CALN`	a period (TO date1) +	`ELT_SUB_REPO`	date1 +	`STRING`
`DV_FROM_TO` +	`ELT_SUB_REPO_CALN_MEDI`	a period (FROM date1 TO date2) +	`MEDI`	date1, date2 +	`ELT_SUB_REPO_CALN` +	`STRING`
`DV_ABOUT` +	`ELT_SUB_FAMS` +	`FAMS`	an approximation (ABOUT date1) +	`REC_INDI`	date1 +	`STRING`
`DV_CALCULATED` +	`ELT_USER`	an approximation (CALCULATED date1) +	`any tag starting + with an underscore`	date1 +	`anywhere` +	`NULL + STRING`

The GEDCOM parser library

Libgedcom interface details

Index

Record identifiers

Element identifiers

Gedcom_val types
-

struct date_value

Gedcom_val types
+

struct date_value

struct date
-

The Gedcom parser library

Basic testing
-

Preparing for further testing

Testing the parser with debugging

Testing the lexers separately

Structure of the parser

Using the GEDCOM parser library

Index

Overview
-

Error handling

Data callback mechanism

Start and end callbacks

Callbacks for records
-

Callbacks for elements

Default callbacks
-

Other API functions
-

Debugging

Error treatment

Compatibility mode
-

`DV_ESTIMATED` +		an approximation (ESTIMATED date1) +	type checker	date1 +	cast operator
`DV_INTERPRETED` +	null value	INTERPRETED date1 FROM a given free form date phrase +	`GEDCOM_IS_NULL(val)`	date1, phrase +	N/A
`DV_PHRASE` +	string	a free form date phrase +	`GEDCOM_IS_STRING(val)`	phrase +	`char* str = GEDCOM_STRING(val);`
date +	`GEDCOM_IS_DATE(val)` +	`struct date_value dv = GEDCOM_DATE(val);`

The GEDCOM parser library

Libgedcom interface details

Index

Record identifiers

Element identifiers

Gedcom_val types -

struct date_value

Gedcom_val types +

struct date_value

struct date -

The Gedcom parser library

Basic testing -

Preparing for further testing

Testing the parser with debugging

Testing the lexers separately

Structure of the parser

Using the GEDCOM parser library

Index

Overview -

Error handling

Data callback mechanism

Start and end callbacks

Callbacks for records -

Callbacks for elements

Default callbacks -

Other API functions -

Debugging

Error treatment

Compatibility mode -

Gedcom_val types
-

Gedcom_val types
+

struct date
-

Basic testing
-

Overview
-

Callbacks for records
-

Default callbacks
-

Other API functions
-

Compatibility mode
-