Merging latest improvements including a revamped Repo interface before more changes are to be done on the way diffing is handled

Merge branch 'improvements'

* improvements:
  Improved archive function by allowing it to directly write to an output stream - previously it would cache everything to memory and try to provide zipping functionality itself
  repo: made init and clone methods less specific, previously they wanted to do it 'barely' only. New method names closely follow the default git command names
  repo.commit_delta_base: removed
  Object can now create objects of the proper type in case one attempts to create an object directly - this feature is used in several places now, allowing for additional type-checking
  repo: removed commits_between but added a note about how this can be achieved using the iter_commits method; reorganized methods within the type as a start for more interface changes
  Added Commit.iter_parents to iterate all parents
  repo: removed a few methods because of redundancy or because it will be obsolete once the interface overhaul is finished. This commit is just intermediate
  All times are not stored as time_struct, but as simple int to consume less memory

1 files changed, 25 insertions, 1 deletions

diff --git a/CHANGES b/CHANGES
index c4ea13b0..babf2733 100644
--- a/CHANGES
+++ b/CHANGES
@@ -20,6 +20,14 @@ General
   may change without prior notice.
 * Renamed all find_all methods to list_items - this method is part of the Iterable interface
   that also provides a more efficients and more responsive iter_items method
+* All dates, like authored_date and committer_date, are stored as seconds since epoc
+  to consume less memory - they can be converted using time.gmtime in a more suitable 
+  presentation format if needed.
+* Named method parameters changed on a wide scale to unify their use. Now git specific 
+  terms are used everywhere, such as "Reference" ( ref ) and "Revision" ( rev ).
+  Prevously multiple terms where used making it harder to know which type was allowed
+  or not.
+  
 
 Item Iteration
 --------------
@@ -41,7 +49,23 @@ Repo
   of the active branch.
 * tree method now requires a Ref instance as input and defaults to the active_branche
   instead of master
-* Removed 'log' method as it as effectively the same as the 'commits' method
+* Removed the following methods:
+  - 'log' method as it as effectively the same as the 'commits' method
+  - 'commits_since' as it is just a flag given to rev-list in Commit.iter_items
+  - 'commit_count' as it was just a redirection to the respective commit method
+  - 'commits_between', replaced by a note on the iter_commits method as it can 
+     achieve the same thing
+  - 'commit_delta_from' as it was a very special case by comparing two different
+     repositories which are likely to have completly different commits. For
+     related repositories, i.e. clones, git-rev-list would be sufficient to find 
+     commits that would need to be transferred for example.
+  - 'create' method which equals the 'init' method's functionality
+* Renamed the following methods:
+  - commits to iter_commits to improve the performance, adjusted signature
+  - init_bare to init, implying less about the options to be used
+  - fork_bare to clone, as it was to represent general clone functionality, but implied
+    a bare clone to be more versatile
+  - archive_tar_gz and archive_tar and replaced by archive method with different signature
 * 'commits' method has no max-count of returned commits anymore, it now behaves 
  like git-rev-list