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