(DOCSP-14655): Port current limitations to iOS sections

source/includes/string-sort-and-query-limitations-note.rst

@@ -0,0 +1,5 @@
+.. note::
+
+   String sorting and case insensitive queries are only supported for
+   character sets in 'Latin Basic', 'Latin Supplement', 'Latin Extended
+   A', and 'Latin Extended B' (UTF-8 range 0-591).

source/sdk/ios/data-types/supported-property-types.txt

@@ -12,6 +12,9 @@ Supported Property Types - iOS SDK
    :depth: 2
    :class: singlecol
 
+Property Syntax
+---------------
+
 .. tabs-realm-languages::
 
    .. tab::
@@ -127,3 +130,22 @@ Supported Property Types - iOS SDK
       ``CGFloat`` properties are discouraged, as the type is not
       platform independent.
 
+.. _ios-size-limitations:
+
+Size Limitations
+----------------
+
+Data and string properties cannot hold more than 16MB. To store
+larger amounts of data, either:
+
+- Break the data into 16MB chunks, or
+- Store data directly on the file system and store paths to the files in the {+realm+}.
+
+{+service-short+} throws a runtime exception if your app attempts to
+store more than 16MB in a single property.
+
+To avoid size limitations and a performance impact, it is best not to
+store large blobs, such as image and video files, directly in a
+{+realm+}. Instead, save the file to a file store (such as S3) and
+keep only the location of the file and any relevant metadata in the
+{+realm+}.

source/sdk/ios/examples/define-a-realm-object-model.txt

@@ -48,6 +48,10 @@ Define a New Object Type
       .. literalinclude:: /examples/generated/code/start/ObjectModels.codeblock.define-a-model.m
          :language: objectivec
 
+.. note::
+
+   Class names are limited to a maximum of 57 UTF-8 characters.
+
 .. _ios-declare-a-property:
 
 Declare Properties
@@ -90,6 +94,10 @@ Declare Properties
       .. literalinclude:: /examples/generated/code/start/ObjectModels.codeblock.array-declaration.m
          :language: objectivec
 
+.. note::
+
+   Property names are limited to a maximum of 63 UTF-8 characters.
+
 .. _ios-specify-an-optional-required-property:
 
 Specify an Optional/Required Property

source/sdk/ios/examples/filter-data.txt

@@ -383,6 +383,7 @@ Regex-like wildcards allow more flexibility in search.
           .. literalinclude:: /examples/generated/code/start/QueryEngine.codeblock.string-operators.swift
              :language: swift
 
+.. include:: /includes/string-sort-and-query-limitations-note.rst
 
 Aggregate Operators
 ~~~~~~~~~~~~~~~~~~~

source/sdk/ios/examples/read-and-write-data.txt

@@ -191,7 +191,6 @@ guarantees a consistent order of results if you explicitly sort them.
       <Classes/RLMResults.html#/c:objc(cs)RLMResults(im)sortedResultsUsingKeyPath:ascending:>`
       with the desired key path to sort by.
 
-
       .. literalinclude:: /examples/generated/code/start/ReadWriteData.codeblock.sort.m
          :language: objectivec
 
@@ -202,6 +201,8 @@ guarantees a consistent order of results if you explicitly sort them.
    <ios-declare-relationship-properties>`, use dot-notation as if it
    were in a regular, nested object.
 
+.. include:: /includes/string-sort-and-query-limitations-note.rst
+
 .. _ios-query-a-relationship:
 
 Query a Relationship

source/sdk/ios/fundamentals/realms.txt

@@ -188,10 +188,20 @@ comparable SQLite database. Unexpected file growth may be related to the
 .. tip:: Avoid pinning old Realm transactions
 
    {+backend-short+} ties read transaction lifetimes to the memory lifetime 
-   of {+backend-short+} instances. Avoid “pinning” old Realm transactions. 
+   of {+backend-short+} instances. Avoid "pinning" old Realm transactions. 
    Use auto-refreshing {+backend-short+}s, and wrap the use of Realm APIs 
    from background threads in explicit autorelease pools.
 
+.. note::
+
+   A large {+realm+} file can cause problems for your app. Any single
+   {+realm+} file cannot be larger than the amount of memory your
+   application would be allowed to map in iOS. This limit depends on the
+   device and on how fragmented the memory space is at that point in
+   time. If you need to store more data, you can map it over multiple
+   {+realm+} files. There is an open `Radar issue
+   <http://www.openradar.me/17119975>`__.
+
 Threading
 ~~~~~~~~~