Version 7.1

Updated init method, fixed double-init of singleton, fixed bug when saving documents, new delegate method, fixed ubiquity URL bugs

Documentation/com.iRareMedia.iCloud-Framework.docset/Contents/Resources/Documents/Classes/iCloud.html

@@ -282,8 +282,8 @@ <h1 class="title title-header">iCloud Class Reference</h1>
 </tr>
 						</tbody></table></div>
 
-                    
-                    
+					
+					
 
 					<div class="section section-overview">
 						<a title="Overview" name="overview"></a>
@@ -323,6 +323,7 @@ <h3 class="subsubtitle task-title">Singleton</h3>
 							<li>
 	<span class="tooltip">
 		<code><a href="#//api/name/sharedCloud">+&nbsp;sharedCloud</a></code>
+		<span class="tooltip"><p>iCloud shared instance object</p></span>
 	</span>
 
 
@@ -337,6 +338,7 @@ <h3 class="subsubtitle task-title">Delegate</h3>
 							<li>
 	<span class="tooltip">
 		<code><a href="#//api/name/delegate">&nbsp;&nbsp;delegate</a></code>
+		<span class="tooltip"><p>iCloud Delegate helps call methods when document processes begin or end</p></span>
 	</span>
 	<span class="task-item-suffix">property</span>
 
@@ -351,30 +353,35 @@ <h3 class="subsubtitle task-title">Properties</h3>
 							<li>
 	<span class="tooltip">
 		<code><a href="#//api/name/query">&nbsp;&nbsp;query</a></code>
+		<span class="tooltip"><p>The current NSMetadataQuery object</p></span>
 	</span>
 	<span class="task-item-suffix">property</span>
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/fileList">&nbsp;&nbsp;fileList</a></code>
+		<span class="tooltip"><p>A list of iCloud files from the current <a href="#//api/name/query">query</a></p></span>
 	</span>
 	<span class="task-item-suffix">property</span>
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/previousQueryResults">&nbsp;&nbsp;previousQueryResults</a></code>
+		<span class="tooltip"><p>A list of iCloud files from the previous <a href="#//api/name/query">query</a></p></span>
 	</span>
 	<span class="task-item-suffix">property</span>
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/verboseLogging">&nbsp;&nbsp;verboseLogging</a></code>
+		<span class="tooltip"><p>Enable verbose logging for detailed feedback in the log. Turning this off only prints crucial log notes such as errors.</p></span>
 	</span>
 	<span class="task-item-suffix">property</span>
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/verboseAvailabilityLogging">&nbsp;&nbsp;verboseAvailabilityLogging</a></code>
+		<span class="tooltip"><p>Enable verbose availability logging for repeated feedback about iCloud availability in the log. Turning this off will prevent availability-related messages from being printed in the log. This property does not relate to the <a href="#//api/name/verboseLogging">verboseLogging</a> property.</p></span>
 	</span>
 	<span class="task-item-suffix">property</span>
 
@@ -389,24 +396,28 @@ <h3 class="subsubtitle task-title">Checking for iCloud</h3>
 							<li>
 	<span class="tooltip">
 		<code><a href="#//api/name/checkCloudAvailability">&ndash;&nbsp;checkCloudAvailability</a></code>
+		<span class="tooltip"><p>Check whether or not iCloud is available and that it can be accessed. Returns a boolean value.</p></span>
 	</span>
 
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/checkCloudUbiquityContainer">&ndash;&nbsp;checkCloudUbiquityContainer</a></code>
+		<span class="tooltip"><p>Check that the current application&rsquo;s iCloud Ubiquity Container is available. Returns a boolean value.</p></span>
 	</span>
 
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/ubiquitousContainerURL">&ndash;&nbsp;ubiquitousContainerURL</a></code>
+		<span class="tooltip"><p>Retrieve the current application&rsquo;s ubiquitous root URL</p></span>
 	</span>
 
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/ubiquitousDocumentsDirectoryURL">&ndash;&nbsp;ubiquitousDocumentsDirectoryURL</a></code>
+		<span class="tooltip"><p>Retrieve the current application&rsquo;s ubiquitous documents directory URL</p></span>
 	</span>
 
 
@@ -421,6 +432,7 @@ <h3 class="subsubtitle task-title">Syncing with iCloud</h3>
 							<li>
 	<span class="tooltip">
 		<code><a href="#//api/name/updateFiles">&ndash;&nbsp;updateFiles</a></code>
+		<span class="tooltip"><p>Check for and update the list of files stored in your app&rsquo;s iCloud Documents Folder. This method is automatically called by iOS when there are changes to files in the iCloud Directory. The iCloudFilesDidChange:withNewFileNames: <a href="#//api/name/delegate">delegate</a> method is triggered by this method.</p></span>
 	</span>
 
 
@@ -435,24 +447,21 @@ <h3 class="subsubtitle task-title">Uploading to iCloud</h3>
 							<li>
 	<span class="tooltip">
 		<code><a href="#//api/name/saveAndCloseDocumentWithName:withContent:completion:">&ndash;&nbsp;saveAndCloseDocumentWithName:withContent:completion:</a></code>
-	</span>
-
-
-</li><li>
-	<span class="tooltip">
-		<code><a href="#//api/name/saveChangesToDocumentWithName:withContent:completion:">&ndash;&nbsp;saveChangesToDocumentWithName:withContent:completion:</a></code>
+		<span class="tooltip"><p>Create, save, and close a document in iCloud.</p></span>
 	</span>
 
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/uploadLocalOfflineDocumentsWithRepeatingHandler:completion:">&ndash;&nbsp;uploadLocalOfflineDocumentsWithRepeatingHandler:completion:</a></code>
+		<span class="tooltip"><p>Upload any local files that weren&rsquo;t created with iCloud</p></span>
 	</span>
 
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/uploadLocalDocumentToCloudWithName:completion:">&ndash;&nbsp;uploadLocalDocumentToCloudWithName:completion:</a></code>
+		<span class="tooltip"><p>Upload a local file to iCloud</p></span>
 	</span>
 
 
@@ -467,6 +476,7 @@ <h3 class="subsubtitle task-title">Sharing iCloud Content</h3>
 							<li>
 	<span class="tooltip">
 		<code><a href="#//api/name/shareDocumentWithName:completion:">&ndash;&nbsp;shareDocumentWithName:completion:</a></code>
+		<span class="tooltip"><p>Share an iCloud document by uploading it to a public URL.</p></span>
 	</span>
 
 
@@ -481,12 +491,14 @@ <h3 class="subsubtitle task-title">Deleting iCloud Content</h3>
 							<li>
 	<span class="tooltip">
 		<code><a href="#//api/name/deleteDocumentWithName:completion:">&ndash;&nbsp;deleteDocumentWithName:completion:</a></code>
+		<span class="tooltip"><p>Delete a document from iCloud.</p></span>
 	</span>
 
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/evictCloudDocumentWithName:completion:">&ndash;&nbsp;evictCloudDocumentWithName:completion:</a></code>
+		<span class="tooltip"><p>Evict a document from iCloud, move it from iCloud to the current application&rsquo;s local documents directory.</p></span>
 	</span>
 
 
@@ -501,42 +513,49 @@ <h3 class="subsubtitle task-title">Retrieving iCloud Content and Info</h3>
 							<li>
 	<span class="tooltip">
 		<code><a href="#//api/name/retrieveCloudDocumentWithName:completion:">&ndash;&nbsp;retrieveCloudDocumentWithName:completion:</a></code>
+		<span class="tooltip"><p>Open a UIDocument stored in iCloud. If the document does not exist, a new blank document will be created using the documentName provided. You can use the <a href="#//api/name/doesFileExistInCloud:">doesFileExistInCloud:</a> method to check if a file exists before calling this method.</p></span>
 	</span>
 
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/retrieveCloudDocumentObjectWithName:">&ndash;&nbsp;retrieveCloudDocumentObjectWithName:</a></code>
+		<span class="tooltip"><p>Get the relevant <a href="../Classes/iCloudDocument.html">iCloudDocument</a> object for the specified file</p></span>
 	</span>
 
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/doesFileExistInCloud:">&ndash;&nbsp;doesFileExistInCloud:</a></code>
+		<span class="tooltip"><p>Check if a file exists in iCloud</p></span>
 	</span>
 
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/fileSize:">&ndash;&nbsp;fileSize:</a></code>
+		<span class="tooltip"><p>Get the size of a file stored in iCloud</p></span>
 	</span>
 
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/fileModifiedDate:">&ndash;&nbsp;fileModifiedDate:</a></code>
+		<span class="tooltip"><p>Get the last modified date of a file stored in iCloud</p></span>
 	</span>
 
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/fileCreatedDate:">&ndash;&nbsp;fileCreatedDate:</a></code>
+		<span class="tooltip"><p>Get the creation date of a file stored in iCloud</p></span>
 	</span>
 
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/getListOfCloudFiles">&ndash;&nbsp;getListOfCloudFiles</a></code>
+		<span class="tooltip"><p>Get a list of files stored in iCloud</p></span>
 	</span>
 
 
@@ -551,12 +570,14 @@ <h3 class="subsubtitle task-title">Managing iCloud Content</h3>
 							<li>
 	<span class="tooltip">
 		<code><a href="#//api/name/renameOriginalDocument:withNewName:completion:">&ndash;&nbsp;renameOriginalDocument:withNewName:completion:</a></code>
+		<span class="tooltip"><p>Rename a document in iCloud</p></span>
 	</span>
 
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/duplicateOriginalDocument:withNewName:completion:">&ndash;&nbsp;duplicateOriginalDocument:withNewName:completion:</a></code>
+		<span class="tooltip"><p>Duplicate a document in iCloud</p></span>
 	</span>
 
 
@@ -571,18 +592,21 @@ <h3 class="subsubtitle task-title">iCloud Document State</h3>
 							<li>
 	<span class="tooltip">
 		<code><a href="#//api/name/documentStateForFile:completion:">&ndash;&nbsp;documentStateForFile:completion:</a></code>
+		<span class="tooltip"><p>Get the current document state of a file stored in iCloud</p></span>
 	</span>
 
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/monitorDocumentStateForFile:onTarget:withSelector:">&ndash;&nbsp;monitorDocumentStateForFile:onTarget:withSelector:</a></code>
+		<span class="tooltip"><p>Monitor changes in the state of a document stored in iCloud</p></span>
 	</span>
 
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/stopMonitoringDocumentStateChangesForFile:onTarget:">&ndash;&nbsp;stopMonitoringDocumentStateChangesForFile:onTarget:</a></code>
+		<span class="tooltip"><p>Stop monitoring changes to the state of a document stored in iCloud</p></span>
 	</span>
 
 
@@ -597,12 +621,21 @@ <h3 class="subsubtitle task-title">Resolving iCloud Conflicts</h3>
 							<li>
 	<span class="tooltip">
 		<code><a href="#//api/name/findUnresolvedConflictingVersionsOfFile:">&ndash;&nbsp;findUnresolvedConflictingVersionsOfFile:</a></code>
+		<span class="tooltip"><p>Find all the conflicting versions of a specified document</p></span>
 	</span>
 
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/resolveConflictForFile:withSelectedFileVersion:">&ndash;&nbsp;resolveConflictForFile:withSelectedFileVersion:</a></code>
+		<span class="tooltip"><p>Your application can follow one of three strategies for resolving document-version conflicts:</p>
+
+<ul>
+<li>Merge the changes from the conflicting versions.</li>
+<li>Choose one of the document versions based on some pertinent factor, such as the version with the latest modification date.</li>
+<li>Enable the user to view conflicting versions of a document and select the one to use.</li>
+</ul>
+</span>
 	</span>
 
 
@@ -615,14 +648,23 @@ <h3 class="subsubtitle task-title">Deprecated Methods</h3>
 
 						<ul class="task-list">
 							<li>
+	<span class="tooltip">
+		<code><a href="#//api/name/saveChangesToDocumentWithName:withContent:completion:">&ndash;&nbsp;saveChangesToDocumentWithName:withContent:completion:</a></code>
+		<span class="tooltip"><p>DEPRECATED. Use <a href="#//api/name/saveAndCloseDocumentWithName:withContent:completion:">saveAndCloseDocumentWithName:withContent:completion:</a> instead. Record changes made to a document in iCloud. Changes are saved when the document is closed. (<b class="deprecated">Deprecated:</b><span class="deprecated"> Deprecated beginning in version 7.1. Use saveAndCloseDocumentWithName:withContent:completion: instead. This method may become unavailable in a future version.</span>)</p></span>
+	</span>
+
+
+</li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/uploadLocalOfflineDocumentsWithDelegate:">+&nbsp;uploadLocalOfflineDocumentsWithDelegate:</a></code>
+		<span class="tooltip"><p>DEPRECATED. Use uploadLocalOfflineDocuments instead, like so: [[iCloud sharedCloud] uploadLocalOfflineDocuments]; (<b class="deprecated">Deprecated:</b><span class="deprecated"> Deprecated in version 7.0. Use uploadLocalOfflineDocuments instead.</span>)</p></span>
 	</span>
 
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/updateFilesWithDelegate:">+&nbsp;updateFilesWithDelegate:</a></code>
+		<span class="tooltip"><p>DEPRECATED. Use updateFiles instead, like so: [[iCloud sharedCloud] updateFiles]; (<b class="deprecated">Deprecated:</b><span class="deprecated"> Deprecated in version 7.0. Use updateFiles instead.</span>)</p></span>
 	</span>
 
 
@@ -1995,7 +2037,7 @@ <h3 class="subsubtitle method-title">saveChangesToDocumentWithName:withContent:c
 
 
 	<div class="method-subsection brief-description">
-		<p>DEPRECATED. Use saveAndCloseDocumentWithName: instead. Record changes made to a document in iCloud. Changes are saved when the document is closed. (<b class="deprecated">Deprecated:</b><span class="deprecated"> This method is deprecated starting in version 7.1. Use methodNameHere: instead. This method may become unavailable in a future version.</span>)</p>
+		<p>DEPRECATED. Use <a href="#//api/name/saveAndCloseDocumentWithName:withContent:completion:">saveAndCloseDocumentWithName:withContent:completion:</a> instead. Record changes made to a document in iCloud. Changes are saved when the document is closed. (<b class="deprecated">Deprecated:</b><span class="deprecated"> Deprecated beginning in version 7.1. Use saveAndCloseDocumentWithName:withContent:completion: instead. This method may become unavailable in a future version.</span>)</p>
 	</div>		
 
 
@@ -2401,8 +2443,6 @@ <h4 class="method-subtitle">Declared In</h4>
 					</div>
 
 
-
-
 				</div>
 				<div class="main-navigation navigation-bottom">
 					<ul>

Documentation/com.iRareMedia.iCloud-Framework.docset/Contents/Resources/Documents/Classes/iCloudDocument.html

@@ -133,8 +133,8 @@ <h1 class="title title-header">iCloudDocument Class Reference</h1>
 </tr>
 						</tbody></table></div>
 
-                    
-                    
+					
+					
 
 					<div class="section section-overview">
 						<a title="Overview" name="overview"></a>
@@ -171,6 +171,7 @@ <h3 class="subsubtitle task-title">Methods</h3>
 							<li>
 	<span class="tooltip">
 		<code><a href="#//api/name/initWithFileURL:">&ndash;&nbsp;initWithFileURL:</a></code>
+		<span class="tooltip"><p>Initialize a new UIDocument with the specified file path</p></span>
 	</span>
 
 
@@ -185,24 +186,28 @@ <h3 class="subsubtitle task-title">Delegate</h3>
 							<li>
 	<span class="tooltip">
 		<code><a href="#//api/name/delegate">&nbsp;&nbsp;delegate</a></code>
+		<span class="tooltip"><p><a href="../Classes/iCloud.html">iCloud</a> Delegate helps call methods when document processes begin or end</p></span>
 	</span>
 	<span class="task-item-suffix">property</span>
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/contents">&nbsp;&nbsp;contents</a></code>
+		<span class="tooltip"><p>The data to read or write to a UIDocument</p></span>
 	</span>
 	<span class="task-item-suffix">property</span>
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/localizedName">&ndash;&nbsp;localizedName</a></code>
+		<span class="tooltip"><p>Retrieve the localized name of the current document</p></span>
 	</span>
 
 
 </li><li>
 	<span class="tooltip">
 		<code><a href="#//api/name/stateDescription">&ndash;&nbsp;stateDescription</a></code>
+		<span class="tooltip"><p>Retrieve a user-readable form of the document state</p></span>
 	</span>
 
 
@@ -437,8 +442,6 @@ <h4 class="method-subtitle">Declared In</h4>
 					</div>
 
 
-
-
 				</div>
 				<div class="main-navigation navigation-bottom">
 					<ul>