clarify docs and changelog

Author: UmanShahzad

CHANGELOG.md

@@ -2,10 +2,14 @@
 
 ## 4.1.0
 
+- The SDK version is available via `ipinfo.version` as `SDK_VERSION`.
 - Most private functions on all handlers (i.e. those that start with `_`) are
   now moved to `ipinfo.handler_utils`.
 - All constants that existed on handlers (i.e. `REQUEST_TIMEOUT_DEFAULT`) are
   now moved to `ipinfo.handler_utils`.
+- Cache behavior for the synchronous handler is a bit different now; the item
+  actually cached is the item _after_ formatting is complete, rather than
+  before.
 - Both the sync and async handlers have the following improvements:
     - `timeout` can be specified as a keyword-arg to getDetails to optionally
       override the client-level timeout.

ipinfo/handler.py

@@ -116,8 +116,9 @@ def getBatchDetails(
         input list).
 
         The input list is broken up into batches to abide by API requirements.
-        The batch size can be adjusted with `batch_size` but is clipped to (and
-        also defaults to) `BATCH_MAX_SIZE`.
+        The batch size can be adjusted with `batch_size` but is clipped to 
+        `BATCH_MAX_SIZE`.
+        Defaults to `BATCH_MAX_SIZE`.
 
         For each batch, `timeout_per_batch` indicates the maximum seconds to
         spend waiting for the HTTP request to complete. If any batch fails with
@@ -127,11 +128,13 @@ def getBatchDetails(
         `timeout_total` is a seconds-denominated hard-timeout for the time
         spent in HTTP operations; regardless of whether all batches have
         succeeded so far, if `timeout_total` is reached, the whole operation
-        will fail. Defaults to being turned off.
+        will fail by raising `TimeoutExceededError`.
+        Defaults to being turned off.
 
         `raise_on_fail`, if turned off, will return any result retrieved so far
         rather than raise an exception when errors occur, including timeout and
-        quota errors. Defaults to on.
+        quota errors.
+        Defaults to on.
         """
         if batch_size == None:
             batch_size = BATCH_MAX_SIZE