[iOS, macOS] update comments

1 files changed, 10 insertions, 12 deletions

diff --git a/platform/darwin/src/MGLRendererConfiguration.h b/platform/darwin/src/MGLRendererConfiguration.h
index bbcc3a8c75..bfe88b7209 100644
--- a/platform/darwin/src/MGLRendererConfiguration.h
+++ b/platform/darwin/src/MGLRendererConfiguration.h
@@ -23,21 +23,19 @@ MGL_EXPORT
 /** The cache dir to use. */
 @property (nonatomic, readonly) mbgl::optional<std::string> cacheDir;
 
-/** The name of the font family to use for client-side text rendering.
-
- Currently only used for CJK glyphs. Changing this at run time is not currently
- supported. By default, client-side rendering is enabled for CJK glyphs using Apple
- system default font.
+/** The name of the font family to use for client-side text rendering of CJK ideographs.
+ 
+ Set MGLIdeographicFontFamilyName in your containing application's Info.plist to
+ font family name(s) that will be available at run time, such as “PingFang TC”
+ or “Marker Felt”. This plist key accepts:
  
- Set `MGLIdeographicFontFamilyName` in your containing app's Info.plist to a string
- value for using your specific local font which will be available at run time,
- e.g. "PingFang TC".
+ - A string value of a single font family name.
  
- Set `MGLIdeographicFontFamilyName` in your containing app's Info.plist to a array of
- font family names. Once the front ones are unavaiable, it will fallback to others until
- using default system font.
+ - An array of font family names. Fonts will be used in the defined order,
+ eventually falling back to default system font if none are available.
  
- Set `MGLIdeographicFontFamilyName` to a Boolean value `NO` for using your custom remote font.
+ - A boolean value NO to disable client-side rendering of CJK glyphs —
+ remote fonts specified in your style will be used instead.
  */
 @property (nonatomic, readonly) mbgl::optional<std::string> localFontFamilyName;