Update descriptions

Author: viraptor

README.md

@@ -11,6 +11,23 @@ Usage
 Standard file usage:
 --------------------
 
+With context managers:
+
+    with arpy.Archive('file.ar') as ar:
+        print("files: %s" % ar.namelist())
+        with ar.open('content.txt') as f:
+            print(f.read())
+
+Via headers for duplicate names:
+
+    with arpy.Archive('file.ar') as ar:
+        for header in ar.infolist():
+            print("file: %s" % header.name)
+            with ar.open(header) as f:
+                print(f.read())
+
+Or directly:
+
     ar = arpy.Archive('file.ar'))
     ar.read_all_headers()
 

arpy.py

@@ -42,12 +42,21 @@
 ar.archived_files.keys()
 
 Files themselves can be opened by getting the value of:
-f = ar.archived_files['filename']
+f = ar.archived_files[b'filename']
 
 and read through:
 f.read([length])
 
-random access through seek and tell functions is supported on the archived files
+random access through seek and tell functions is supported on the archived files.
+
+zipfile-like interface is also available:
+
+ar.namelist() will return a list of names (with possible duplicates)
+ar.infolist() will return a list of headers
+
+Use ar.open(name / header) to get the specific file.
+
+You can also use context manager syntax with either the ar file or its contents.
 """
 
 import io