[ios, macos] Document style attribute interdependencies

1 files changed, 4 insertions, 2 deletions

diff --git a/platform/darwin/src/MGLBackgroundStyleLayer.h b/platform/darwin/src/MGLBackgroundStyleLayer.h
index ecf4f995e9..544354d978 100644
--- a/platform/darwin/src/MGLBackgroundStyleLayer.h
+++ b/platform/darwin/src/MGLBackgroundStyleLayer.h
@@ -12,8 +12,10 @@ NS_ASSUME_NONNULL_BEGIN
 
 /**
  The color with which the background will be drawn.
-
+ 
  The default value of this property is an `NSColor` or `UIColor`object whose RGB value is 0, 0, 0 and whose alpha value is 1. Set this property to `nil` to reset it to the default.
+ 
+ This property is only applied to the style if `backgroundPattern` is set to `nil`. Otherwise, it is ignored.
  */
 @property (nonatomic, null_resettable) id <MGLStyleAttributeValue> backgroundColor;
 
@@ -24,7 +26,7 @@ NS_ASSUME_NONNULL_BEGIN
 
 /**
  The opacity at which the background will be drawn.
-
+ 
  The default value of this property is `1`. Set this property to `nil` to reset it to the default.
  */
 @property (nonatomic, null_resettable) id <MGLStyleAttributeValue> backgroundOpacity;