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