Updated readme, adding code examples and explanations

README.md

@@ -13,17 +13,38 @@ I'm always open to improvements, so please submit your pull requests, or [create
 
 ```Objective-C
 URKArchive *archive = [URKArchive rarArchiveAtPath:@"An Archive.rar"];
-
 NSError *error = nil;
+```
 
+## Listing the file names in an archive
+```Objective-C
 NSArray *filesInArchive = [archive listFilenames:&error];
+for (NSString *name in filesInArchive) {
+    NSLog(@"Archived file: %@", name);
+}
+```
+
+## Listing the file details in an archive
+```Objective-C
+NSArray *fileInfosInArchive = [archive listFileInfo:&error];
+for (URKFileInfo *info in fileInfosInArchive) {
+    NSLog(@"Archive name: %@ | File name: %@ | Size: %lld", info.archiveName, info.filename, info.uncompressedSize);
+}
+```
+
+## Extracting files to a directory
+```Objective-C
 BOOL extractFilesSuccessful = [archive extractFilesTo:@"some/directory"
                                             overWrite:NO
                                              progress:
     ^(URKFileInfo *currentFile, CGFloat percentArchiveDecompressed) {
         NSLog(@"Extracting %@: %f%% complete", currentFile.filename, percentArchiveDecompressed);
     }
                                                 error:&error];
+```
+
+## Extracting a file into memory
+```Objective-C
 NSData *extractedData = [archive extractDataFromFile:@"a file in the archive.jpg"
                                             progress:^(CGFloat percentDecompressed) {
                                                          NSLog(@"Extracting, %f%% complete", percentDecompressed);