Added tests for compatibility with ftree and lifelines.
[gedcom-parse.git] / NEWS
1 NOTE: NO BACKWARD COMPATIBILITY IS GUARANTEED FOR 0.x RELEASES !!
2
3 release 0.20.0 (30 December 2002):
4
5  - The release numbering scheme is changed to a three-part version number.
6    Patches will just update the last digit.
7
8  - The library should now be portable, i.e it should work on any POSIX system.
9    On systems lacking glibc, libiconv is needed (see README).
10
11  - A lot of new features (see documentation):
12      - callback interface:
13         - functions to manipulate cross-references (add, delete, link and
14           unlink)
15         - functions to manipulate dates (strings to numbers and vice versa,
16           conversion between calendars, ...)
17         - support for writing Gedcom files
18         - complete concatenated text (e.g. for notes) is now passed in the
19           end callback
20      - C object model interface:
21         - functions for string retrieval and modification
22         - support for writing Gedcom files
23      - development support:
24         - m4 macro that can be used in configure.in
25         - gedcom-config script for linking and compilation flags
26
27  - The library now comes with an extra shared library (libutf8tools),
28    which needs to be linked in in any programs that use the gedcom parser
29    library (you can use the script 'gedcom-config' to generate link and
30    include flags).  You can use utf8tools in totally unrelated programs too.
31
32  - INTERFACE CHANGE: the end record callback function now takes an extra
33    argument (similar to the end element callback): a Gedcom_val, which
34    contains in the case of a REC_NOTE the complete concatenated string.
35
36  - INTERFACE CHANGE: the return value of gedcom_init() has changed from
37    void to int to be able to return a status.
38
39  - Various bugfixes.
40
41 release 0.17 (12 September 2002):
42
43  - New features (see documentation):
44      - new function gedcom_get_by_xref
45      - age values are parsed
46      - gedcom object model in C
47
48  - INTERFACE CHANGE: the callback functions now take an extra argument: the
49    record/element identifier (that is also used as first argument in the
50    *_subscribe_* functions).  The extra argument is the first argument.
51
52  - INTERFACE CHANGE: Age values are now parsed: an extra type is added to
53    the types possible in a Gedcom_val: an age_value (see documentation for
54    details).  So, instead of GEDCOM_STRING, you now need to use GEDCOM_AGE
55    for age values.
56    As a quick change, you can use the raw_value instead of the parsed_value
57    until you make the real change of using the struct age_value.
58
59  - INTERFACE CHANGE: The type of an xref_value can also be XREF_ANY, if
60    the actual type is not known yet.  This is e.g. used in the case of an
61    association (ASSO): the cross-reference can be any object type, the
62    actual type is given by the TYPE subtag.
63
64 release 0.16 (16 August 2002):
65
66  - Another bugfixing release.
67
68  - Some compatibility with Lifelines 3.0.2 is added (not necessarily complete).
69
70 release 0.15 (27 March 2002):
71
72  - Again mainly a bugfixing release
73
74  - Compatibility with ftree is added, all GEDCOM files written by ftree
75    should load fine now.
76
77  - Note for developers: you now have to call the function gedcom_init()
78    as soon as possible in your program (before any character set handling
79    is done, see documentation for details).  If the function has not been
80    called, gedcom_parse_file() will return an error.
81
82 release 0.14 (20 January 2002):
83
84  - This is mainly a bugfixing release, no extra features have been added.
85
86  - Some example code is available on how to convert from UTF-8 to the locale
87    system, and how to check the library version via configure.in (see the
88    documentation for details).
89
90 release 0.13 (5 January 2002):
91
92  - Cross-references are now parsed and checked.  For this, an extra type is
93    added to the types possible in a Gedcom_val: an xref pointer. This means
94    that GEDCOM_XREF_PTR has to be used now in some places instead of
95    GEDCOM_STRING.
96    A quick change is to replace
97      GEDCOM_STRING(val)
98    by
99      GEDCOM_XREF_PTR(val)->string
100    where applicable.  But you can also store an object in the 'object' member
101    of the struct returned by GEDCOM_XREF_PTR (see documentation).
102
103  - Other interface changes in the callbacks:
104     - parsed tag value (integer) is passed next to the string value
105     - the start record callbacks now also contain a Gedcom_val (the NOTE can
106       have a value)
107
108  - Further, various bugfixes have been made.
109
110 release 0.12 (31 December 2001):
111
112  - The calling of callbacks is now completed.
113
114  - Some initial documentation is available.
115
116  - The parsed value that is returned in callbacks can now be:
117      - a null value
118      - a string
119      - a date (struct date_value)
120    See the documentation for more info.  Parsing and checking of cross-
121    references will be added next.
122
123 release 0.11 (15 December 2001):
124
125  - Initial release from Sourceforge.net (developers only !)
126   
127 # $Id$
128 # $Name$