Imported Upstream version 1.24.2

1 files changed, 29 insertions, 3 deletions

diff --git a/README b/README
index ba8a19f..22a8101 100644
--- a/README
+++ b/README
@@ -1,7 +1,33 @@
+====================================================
+   KNOWN INCOMPATIBILITIES WITH PREVIOUS VERSIONS
+====================================================
 
-MMDB: A library for storage and manipulation of macromolecular models.
+--------------------------
+Version 1.05 (26.03.2004)
+--------------------------
 
-Written by Eugene Krissinel.
+1. CAtom::GetBonds ( RPSAtomBond AtomBond, int & nAtomBonds );
 
-Released under the modified GNU LGPL v3.
+now returns a pointer to internal list of bonded atoms. Therefore
+application MUST NEITHER attempt to deallocate AtomBond obtained from
+this function NOR modify it (doing so will cause crash). This is in
+difference of previous versions where deallocation of AtomBond was
+explicitely required.
+
+2. CAtom::GetBonds ( RPSAtomBondI AtomBondI, int & nAtomBonds );
+
+on contrary, now returns an allocated instance of the atom's bond list.
+If AtomBondI is not NULL on input, the function attempts to deallocate
+it (which will cause crash if you feed uninitialized non-NULL AtomBondI
+into the function). Application is responsible for deallocation of
+AtomBondI when appropriate.
+
+3. CAtom::GetBonds ( PSAtomBondI AtomBondI, int & nAtomBonds, int maxlength );
+
+is a new function for pre-allocated AtomBondI[0..maxlength]. Application
+is responsible for allocation and deallocation of AtomBondI.
+
+4. CAtom::GetBonds ( RPSAtomBond AtomBond, int & nAtomBonds, int maxlength );
+
+removed as there is no need in it in view of change #1 above.