Add file I/O usage to Core documentation. (#959)

* Add file I/O usage to documentation.

* Update defaultOptions message.

* Fix grammatical error.

1 files changed, 4 insertions, 2 deletions

diff --git a/Firebase/Core/Public/FIROptions.h b/Firebase/Core/Public/FIROptions.h
index eba0657..b4e3b3b 100644
--- a/Firebase/Core/Public/FIROptions.h
+++ b/Firebase/Core/Public/FIROptions.h
@@ -25,7 +25,8 @@ NS_SWIFT_NAME(FirebaseOptions)
 @interface FIROptions : NSObject <NSCopying>
 
 /**
- * Returns the default options.
+ * Returns the default options. The first time this is called it synchronously reads
+ * GoogleService-Info.plist from disk.
  */
 + (nullable FIROptions *)defaultOptions NS_SWIFT_NAME(defaultOptions());
 
@@ -109,7 +110,8 @@ NS_SWIFT_NAME(FirebaseOptions)
         "setters instead.");
 
 /**
- * Initializes a customized instance of FIROptions from the file at the given plist file path.
+ * Initializes a customized instance of FIROptions from the file at the given plist file path. This
+ * will read the file synchronously from disk.
  * For example,
  * NSString *filePath =
  *     [[NSBundle mainBundle] pathForResource:@"GoogleService-Info" ofType:@"plist"];