X-Git-Url: https://git.dlugolecki.net.pl/?a=blobdiff_plain;f=README;h=d2dbe71370093ba00c281532c9cace2ed39d233d;hb=2b88c0dab029f5342b9935dd657451b9bf0de303;hp=0dee7b29f4c8b0a053bde87f38108569da5913c5;hpb=f0775fe0dbf452814ada20f660c796dc13c877d5;p=gedcom-parse.git diff --git a/README b/README index 0dee7b2..d2dbe71 100644 --- a/README +++ b/README @@ -5,7 +5,12 @@ to parse and process arbitrary genealogy files in the standard gedcom format. Its main features are: - - strict callback-based parser written in C (using lex/yacc) + - portable to any POSIX systems (libiconv is needed on systems that lack + glibc 2.2, see below) + + - strict callback-based parser written in C (using lex/yacc), a C object + model is also available (compare to the difference between SAX and DOM + in XML). - supports the Gedcom 5.5 standard fully @@ -22,9 +27,14 @@ Its main features are: - specific parsing and checking of cross-references + - specific parsing of age values + + - support for writing Gedcom files + - "compatibility-mode" parsing, to allow for not-exactly-standard syntaxes used by other genealogy programs; currently, compatibility is added for: - ftree + - Lifelines 3.0.2 (not complete) NOTE: - NO BACKWARD COMPATIBILITY is guaranteed for 0.x releases ! @@ -33,6 +43,9 @@ To do list: - specific parsing of other special values - compatibility with other genealogy programs - older/newer Gedcom standards ? + - modifying data + - writing GEDML files + - C++ object model - ... For more information, refer to the documentation in the doc subdirectory, @@ -48,18 +61,27 @@ spin-off, and which uses this library: Requirements: ------------ - - glibc 2.2 or higher +For using the library: + - either glibc 2.2 or higher, or libiconv + +Note: -To build from sources, you'll also need: + The official libiconv package doesn't have ANSEL support, and is not + extensible except by modifying its source code. + + There is a modified libiconv package available on the SourceForge project + page, which is called 'libiconv-gedcom-1.8.x', based on libiconv 1.8. + Install this if you need ANSEL support and you don't have glibc 2.2. + +To compile the package, you'll need: - gcc + +To compile from the CVS sources, you'll need in addition: - autoconf - automake - flex - bison (won't work with plain yacc) - -It is possible that it also runs on other platforms than Linux (and that the -glibc version requirement can be loosened), however, I can only support Linux -because that is the only platform I have... + - perl Installation: