Update README via replace-VERSION (GNU make is used anyway).
[gedcom-parse.git] / NEWS
1 NOTE: NO BACKWARD COMPATIBILITY IS GUARANTEED FOR 0.x RELEASES !!
2
3 release 0.17 (12 September 2002):
4
5  - New features (see documentation):
6      - new function gedcom_get_by_xref
7      - age values are parsed
8      - gedcom object model in C
9
10  - INTERFACE CHANGE: the callback functions now take an extra argument: the
11    record/element identifier (that is also used as first argument in the
12    *_subscribe_* functions).  The extra argument is the first argument.
13
14  - INTERFACE CHANGE: Age values are now parsed: an extra type is added to
15    the types possible in a Gedcom_val: an age_value (see documentation for
16    details).  So, instead of GEDCOM_STRING, you now need to use GEDCOM_AGE
17    for age values.
18    As a quick change, you can use the raw_value instead of the parsed_value
19    until you make the real change of using the struct age_value.
20
21  - INTERFACE CHANGE: The type of an xref_value can also be XREF_ANY, if
22    the actual type is not known yet.  This is e.g. used in the case of an
23    association (ASSO): the cross-reference can be any object type, the
24    actual type is given by the TYPE subtag.
25
26 release 0.16 (16 August 2002):
27
28  - Another bugfixing release.
29
30  - Some compatibility with Lifelines 3.0.2 is added (not necessarily complete).
31
32 release 0.15 (27 March 2002):
33
34  - Again mainly a bugfixing release
35
36  - Compatibility with ftree is added, all GEDCOM files written by ftree
37    should load fine now.
38
39  - Note for developers: you now have to call the function gedcom_init()
40    as soon as possible in your program (before any character set handling
41    is done, see documentation for details).  If the function has not been
42    called, gedcom_parse_file() will return an error.
43
44 release 0.14 (20 January 2002):
45
46  - This is mainly a bugfixing release, no extra features have been added.
47
48  - Some example code is available on how to convert from UTF-8 to the locale
49    system, and how to check the library version via configure.in (see the
50    documentation for details).
51
52 release 0.13 (5 January 2002):
53
54  - Cross-references are now parsed and checked.  For this, an extra type is
55    added to the types possible in a Gedcom_val: an xref pointer. This means
56    that GEDCOM_XREF_PTR has to be used now in some places instead of
57    GEDCOM_STRING.
58    A quick change is to replace
59      GEDCOM_STRING(val)
60    by
61      GEDCOM_XREF_PTR(val)->string
62    where applicable.  But you can also store an object in the 'object' member
63    of the struct returned by GEDCOM_XREF_PTR (see documentation).
64
65  - Other interface changes in the callbacks:
66     - parsed tag value (integer) is passed next to the string value
67     - the start record callbacks now also contain a Gedcom_val (the NOTE can
68       have a value)
69
70  - Further, various bugfixes have been made.
71
72 release 0.12 (31 December 2001):
73
74  - The calling of callbacks is now completed.
75
76  - Some initial documentation is available.
77
78  - The parsed value that is returned in callbacks can now be:
79      - a null value
80      - a string
81      - a date (struct date_value)
82    See the documentation for more info.  Parsing and checking of cross-
83    references will be added next.
84
85 release 0.11 (15 December 2001):
86
87  - Initial release from Sourceforge.net (developers only !)
88   
89 # $Id$
90 # $Name$