From d6e13dec0247c88520cd207d908f86228974942c Mon Sep 17 00:00:00 2001
From: Alex Zolotarev <alex@mapswithme.com>
Date: Thu, 4 Jul 2013 20:43:42 +0300
Subject: [PATCH] [ios][api] Added some comments and minor fix

---
 api/iOS/src/MapsWithMeAPI.h |  5 ++++-
 api/iOS/src/MapsWithMeAPI.m | 14 +++-----------
 2 files changed, 7 insertions(+), 12 deletions(-)

diff --git a/api/iOS/src/MapsWithMeAPI.h b/api/iOS/src/MapsWithMeAPI.h
index 0e9c73d495..3a111c80ef 100644
--- a/api/iOS/src/MapsWithMeAPI.h
+++ b/api/iOS/src/MapsWithMeAPI.h
@@ -34,7 +34,6 @@
 
 // Wrapper for a pin on a map
 @interface MWMPin : NSObject
-
 // [required] pin latitude and longitude
 @property (nonatomic, assign) double lat;
 @property (nonatomic, assign) double lon;
@@ -56,8 +55,12 @@
 + (MWMPin *) pinFromUrl:(NSURL *)url;
 // returns NO if MapsWithMe is not installed or outdated version doesn't support API calls
 + (BOOL) isApiSupported;
+// Displays given point on a map, title and id are optional
+// If id contains valid url, it will be opened from MapsWithMe after selecting "More Details..." for the pin
 + (BOOL) showLat:(double)lat lon:(double)lon title:(NSString *)optionalTitle id:(NSString *)optionalId;
+// The same as above but using pin wrapper
 + (BOOL) showPin:(MWMPin *)pin;
+// Displays any number of pins
 + (BOOL) showPins:(NSArray *)pins;
 
 @end
diff --git a/api/iOS/src/MapsWithMeAPI.m b/api/iOS/src/MapsWithMeAPI.m
index c5df220f9b..8058654301 100644
--- a/api/iOS/src/MapsWithMeAPI.m
+++ b/api/iOS/src/MapsWithMeAPI.m
@@ -170,17 +170,9 @@ static NSString * MWMUrlScheme = @"mapswithme://";
 
   NSURL * url = [[NSURL alloc] initWithString:str];
   [str release];
-  if (url)
-  {
-    [[UIApplication sharedApplication] openURL:url];
-    [url release];
-    return YES;
-  }
-  else
-  {
-    NSLog(@"Can't generate correct url");
-    return NO;
-  }
+  BOOL const result = [[UIApplication sharedApplication] openURL:url];
+  [url release];
+  return result;
 }
 
 + (NSString *) detectBackUrlScheme