+ + +

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 - Eichmann and are an excellent way to test gedcom parsers thoroughly.
-
- + 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 + 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 +
+ 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 - -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. - Some sample UTF-8 plain text files can be found - here . Just cat them on the command line -and see the result.
-
- +
+ 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 + -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. + Some sample UTF-8 plain text files can be found + 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 - line is (in the gedcom directory):
- + 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 environment variable GCONV_PATH to the ansel - subdirectory of the gedcom directory:
- + + 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:
+

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 - show a lot of special characters.
-
- + ./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:
- + 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...
-
- + 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...
- -

+ 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 +	Possible + `val` types + +
`REC_HEAD` +	The header of the GEDCOM file +	`NULL` +	`NULL` +
`REC_FAM` +	A record describing a family +	`XREF_PTR(FAM)` +	`NULL` +
`REC_INDI` +	A record describing an individual +	`XREF_PTR(INDI)` +	`NULL` +
`REC_OBJE` +	A record describing a multimedia object +	`XREF_PTR(OBJE)` +	`NULL` +
`REC_NOTE` +	A record describing a note +	`XREF_PTR(NOTE)` +	`STRING` +
`REC_REPO` +	A record describing a source repository +	`XREF_PTR(REPO)` +	`NULL` +
`REC_SOUR` +	A record describing a source +	`XREF_PTR(SOUR)` +	`NULL` +
`REC_SUBN` +	A record describing the submission +	`XREF_PTR(SUBN)` +	`NULL` +
`REC_SUBM` +	A record describing the submitter +	`XREF_PTR(SUBM`) +	`NULL` +
`REC_USER` +	An application-specific record (the `tag` + in the start callback contains the actually used tag). +	`NULL + XREF_PTR(USER) +` +	`NULL + STRING + XREF_PTR(USER)` +

Record +	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` +	`XREF_PTR(SUBM)` +
`ELT_HEAD_SUBN` +	`SUBN` +	`REC_HEAD` +	`XREF_PTR(SUBN)` +
`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` +	`XREF_PTR(INDI)` +
`ELT_FAM_WIFE` +	`WIFE` +	`REC_FAM` +	`XREF_PTR(INDI)` +
`ELT_FAM_CHIL` +	`CHIL` +	`REC_FAM` +	`XREF_PTR(INDI)` +
`ELT_FAM_NCHI` +	`NCHI` +	`REC_FAM` +	`STRING` +
`ELT_FAM_SUBM` +	`SUBM` +	`REC_FAM` +	`XREF_PTR(SUBM)` +
`ELT_INDI_RESN` +	`RESN` +	`REC_INDI` +	`STRING` +
`ELT_INDI_SEX` +	`SEX` +	`REC_INDI` +	`STRING` +
`ELT_INDI_SUBM` +	`SUBM` +	`REC_INDI` +	`XREF_PTR(SUBM)` +
`ELT_INDI_ALIA` +	`ALIA` +	`REC_INDI` +	`XREF_PTR(INDI)` +
`ELT_INDI_ANCI` +	`ANCI` +	`REC_INDI` +	`XREF_PTR(SUBM)` +
`ELT_INDI_DESI` +	`DESI` +	`REC_INDI` +	`XREF_PTR(SUBM)` +
`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` +	`XREF_PTR(OBJE)` +
`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` +	`XREF_PTR(SUBM)` +
`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` +	`XREF_PTR(INDI)` +
`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` +	`XREF_PTR(FAM)` +
`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` +	`XREF_PTR(FAM)` +
`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` +	`XREF_PTR(FAM)` +
`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` +	`XREF_PTR(FAM)` +
`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 + XREF_PTR(OBJE) +` +
`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 + XREF_PTR(NOTE) +` +
`ELT_SUB_PERS_NAME` +	`NAME` +	`REC_INDI` +	`STRING` +
`ELT_SUB_PERS_NAME_NPFX`	Meaning +	`NPFX`	Possible - `xref` types +	`ELT_SUB_PERS_NAME` +	`STRING`	Possible - `val` types - -
`REC_HEAD` +	`ELT_SUB_PERS_NAME_GIVN`	The header of the GEDCOM file +	`GIVN`	`NULL` +	`ELT_SUB_PERS_NAME` +	`STRING`	`NULL` -
`REC_FAM` +	`ELT_SUB_PERS_NAME_NICK`	A record describing a family +	`NICK`	`XREF_PTR(FAM)` +	`ELT_SUB_PERS_NAME` +	`STRING`	`NULL` -
`REC_INDI` +	`ELT_SUB_PERS_NAME_SPFX`	A record describing an individual +	`SPFX`	`XREF_PTR(INDI)` +	`ELT_SUB_PERS_NAME` +	`STRING`	`NULL` -
`REC_OBJE` +	`ELT_SUB_PERS_NAME_SURN`	A record describing a multimedia object +	`SURN`	`XREF_PTR(OBJE)` +	`ELT_SUB_PERS_NAME` +	`STRING`	`NULL` -
`REC_NOTE` +	`ELT_SUB_PERS_NAME_NSFX` +	`NSFX`	A record describing a note +	`ELT_SUB_PERS_NAME`	`XREF_PTR(NOTE)` +	`STRING`	`STRING` -
`REC_REPO` +	`ELT_SUB_PLAC`	A record describing a source repository +	`PLAC`	`XREF_PTR(REPO)` +	`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 + XREF_PTR(SOUR)` +
`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`	`NULL` -
`ELT_SUB_SOUR_QUAY` +	`QUAY` +	`ELT_SUB_SOUR` +	`STRING` +
`ELT_SUB_REPO` +	`REPO` +	`REC_SOUR`	A record describing a source +	`XREF_PTR(REPO)` +
`ELT_SUB_REPO_CALN`	`XREF_PTR(SOUR)` +	`CALN` +	`ELT_SUB_REPO` +	`STRING`	`NULL` -
`REC_SUBN` +	`ELT_SUB_REPO_CALN_MEDI`	A record describing the submission +	`MEDI`	`XREF_PTR(SUBN)` +	`ELT_SUB_REPO_CALN` +	`STRING`	`NULL` -
`REC_SUBM` +	`ELT_SUB_FAMS`	A record describing the submitter +	`FAMS` +	`REC_INDI`	`XREF_PTR(SUBM`) +	`XREF_PTR(FAM)`	`NULL` -
`REC_USER` +	`ELT_USER` +	`any tag starting + with an underscore`	An application-specific record (the `tag` - in the start callback contains the actually used tag). +	`anywhere`	`NULL -XREF_PTR(USER) -` + STRING + XREF_PTR(USER)	`NULL -STRING -XREF_PTR(USER)` -

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` -	`XREF_PTR(SUBM)` -
`ELT_HEAD_SUBN` -	`SUBN` -	`REC_HEAD` -	`XREF_PTR(SUBN)` -
`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` -	`XREF_PTR(INDI)` -
`ELT_FAM_WIFE` -	`WIFE` -	`REC_FAM` -	`XREF_PTR(INDI)` -
`ELT_FAM_CHIL` -	`CHIL` -	`REC_FAM` -	`XREF_PTR(INDI)` -
`ELT_FAM_NCHI` -	`NCHI` -	`REC_FAM` -	`STRING` -
`ELT_FAM_SUBM` -	`SUBM` -	`REC_FAM` -	`XREF_PTR(SUBM)` -
`ELT_INDI_RESN` -	`RESN` -	`REC_INDI` -	`STRING` -
`ELT_INDI_SEX` -	`SEX` -	`REC_INDI` -	`STRING` -
`ELT_INDI_SUBM` -	`SUBM` -	`REC_INDI` -	`XREF_PTR(SUBM)` -
`ELT_INDI_ALIA` -	`ALIA` -	`REC_INDI` -	`XREF_PTR(INDI)` -
`ELT_INDI_ANCI` -	`ANCI` -	`REC_INDI` -	`XREF_PTR(SUBM)` -
`ELT_INDI_DESI` -	`DESI` -	`REC_INDI` -	`XREF_PTR(SUBM)` -
`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` -	`XREF_PTR(OBJE)` -
`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` -	`XREF_PTR(SUBM)` -
`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` -	`XREF_PTR(INDI)` -
`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` -	`XREF_PTR(FAM)` -
`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` -	`XREF_PTR(FAM)` -
`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` -	`XREF_PTR(FAM)` -
`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` -	`XREF_PTR(FAM)` -
`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 -XREF_PTR(OBJE) -` -
`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 -XREF_PTR(NOTE) -` -
`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 -XREF_PTR(SOUR)` -
`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` -	`XREF_PTR(REPO)` -
`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` -	`XREF_PTR(FAM)` -
`ELT_USER` -	`any tag starting - with an underscore` -	`anywhere` -	`NULL - STRING -XREF_PTR(USER)` -

-	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);`
xref pointer -	`GEDCOM_IS_XREF_PTR(val)` -	`struct xref_value *xr = GEDCOM_XREF_PTR(val);` -
+	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);`
xref pointer +	`GEDCOM_IS_XREF_PTR(val)` +	`struct xref_value *xr = GEDCOM_XREF_PTR(val);` +

Date_value_type -	Meaning -	Relevant members -
`DV_NO_MODIFIER` -	just a simple date -	date1 -
`DV_BEFORE` -	a range (BEFORE date1) -	date1 -
`DV_AFTER` -	a range (AFTER date1) -	date1 -
`DV_BETWEEN` -	a range (BETWEEN date1 AND date2) -	date1, date2 -
`DV_FROM` -	a period (FROM date1) -	date1 -
`DV_TO` -	a period (TO date1) -	date1 -
`DV_FROM_TO` -	a period (FROM date1 TO date2) -	date1, date2 -
`DV_ABOUT` -	an approximation (ABOUT date1) -	date1 -
`DV_CALCULATED` -	an approximation (CALCULATED date1) -	date1 -
`DV_ESTIMATED` -	an approximation (ESTIMATED date1) -	date1 -
`DV_INTERPRETED` -	INTERPRETED date1 FROM a given free form date +
Date_value_type +	Meaning +	Relevant members +
`DV_NO_MODIFIER` +	just a simple date +	date1 +
`DV_BEFORE` +	a range (BEFORE date1) +	date1 +
`DV_AFTER` +	a range (AFTER date1) +	date1 +
`DV_BETWEEN` +	a range (BETWEEN date1 AND date2) +	date1, date2 +
`DV_FROM` +	a period (FROM date1) +	date1 +
`DV_TO` +	a period (TO date1) +	date1 +
`DV_FROM_TO` +	a period (FROM date1 TO date2) +	date1, date2 +
`DV_ABOUT` +	an approximation (ABOUT date1) +	date1 +
`DV_CALCULATED` +	an approximation (CALCULATED date1) +	date1 +
`DV_ESTIMATED` +	an approximation (ESTIMATED date1) +	date1 +
`DV_INTERPRETED` +	INTERPRETED date1 FROM a given free form date phrase -	date1, phrase -
`DV_PHRASE` -	a free form date phrase -	phrase -
date1, phrase +
`DV_PHRASE` +	a free form date phrase +	phrase +

Libgedcom interface details

Index

Record identifiers

Element identifiers

Element identifiers

Gedcom_val types
-

struct date_value

struct date
-

struct xref_value

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
-

Overview
+

Error handling

Data callback mechanism

Start and end callbacks

Callbacks for records
-

Callbacks for elements

Default callbacks
+

Default callbacks
-

Other API functions
-

Debugging

Error treatment

Compatibility mode
-

Libgedcom interface details

Index

Record identifiers

Element identifiers

Element identifiers

Gedcom_val types -

struct date_value

struct date -

struct xref_value

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 -

Overview +

Error handling

Data callback mechanism

Start and end callbacks

Callbacks for records -

Callbacks for elements

Default callbacks +

Default callbacks -

Other API functions -

Debugging

Error treatment

Compatibility mode -

Gedcom_val types
-

struct date
-

Basic testing
-

Overview
-

Overview
+

Callbacks for records
-

Default callbacks
+

Default callbacks
-

Other API functions
-

Compatibility mode
-