add/improve BVMOpenLinkManager documentation

buyvmmanager/BVMLinkOpenManager.h

@@ -9,19 +9,32 @@ typedef NS_ENUM(NSInteger, BVMBrowser) {
 
 @interface BVMLinkOpenManager : NSObject
 
+/**
+ * Returns YES if the given browser is available on this device.
+ */
 + (BOOL)browserAvailable:(BVMBrowser)browser;
 
+/**
+ * Returns the user's selected default browser.
+ */
 + (BVMBrowser)selectedBrowser;
+
+/**
+ * Sets the user's selected default browser.
+ */
 + (void)setSelectedBrowser:(BVMBrowser)browser;
 
 /**
- * Open the given URL.
+ * Opens the given URL.
  *
  * If HTTP or HTTPS, uses the defaut browser.
  */
 + (void)openURL:(NSURL *)url;
 + (void)openURLString:(NSString *)urlString;
 
+/**
+ * Returns the human-friendly name for the given browser.
+ */
 + (NSString *)nameForBrowser:(BVMBrowser)browser;
 
 @end

buyvmmanager/BVMLinkOpenManager.m

@@ -36,6 +36,7 @@ + (BOOL)browserAvailable:(BVMBrowser)browser
 #pragma mark Default browser management
 
 + (BVMBrowser)selectedBrowser {
+    // note: if not set, this falls back to 0 == BVMBrowserSafari
     return [[NSUserDefaults standardUserDefaults] integerForKey:kBVMBrowserPrefsKey];
 }