Repository files navigation

This repository contains the source of the Xamarin API documentation for native functions in Apple operating systems:

• iOS
• macOS
• tvOS
• watchOS

As an example, you can navigate toUIKit Namespace to start browsing.

This project has adopted theMicrosoft Open Source Code of Conduct.For more information see theCode of Conduct FAQ or contactopencode@microsoft.com with any additional questions or comments.

All Xamarin Apple API docs are written in theindicative mood. For instance, instead of saying "You call this function to foo the bar," the docs should be "The developer calls this function to foo the bar." The agents we refer to are typically "the developer," "the method" (or "the object"), "the framework," and "the system" (meaning the underlying operating system or hardware services). The indicative mood often takes a little time to get used to, but it helps avoid ambiguity about responsibilities and cuts down on the temptation to use passive voice.

API docs are divided betweensummary andremarks elements. Summaries are displayed in IntelliSense and should be quite short (perhaps around 140 characters, certainly fewer than 250). If there is a numeric value with an underlying unit-of-measure, include the unit in the summary (e.g., "The angle, in radians," or "the distance, in meters").

Summaries may contain tags, but should not wrap their content in another tag:

• Right:<summary>Foos the <paramref name="bar"/>.</summary>
• Wrong:<summary><para>Foos the <paramref name="bar"/>.</para></summary>

• make all: run xmllint with the bundled monodoc-ecma.xsl toverify the syntax of the documentation in the repository

Use github.com/xamarin/DocWriter to author documentation.

In case macdoc blows up when trying to load the documentation or you can't compile the docs or similar check for:

• busted index.xml: run the abovemissing script which willgive you the entry in the xml that are not present in thefilesystem

• parse error: runmake all to check for syntax errors in thedocumentation files

Run macdoc by passing the absolute path to the en/ directory(i.e. where the index.xml file is) preprended with the character '+'.

./macdoc.app/Contents/MacOS/macdoc '+/path/to/ios-api-docs/en/'

You need a recent macdoc. You can compile it yourself by cloningmonomac and running the build processthere. Macdoc is under the samples directory.

This repository is also submoduled by XamarinVS to fetch the baseline docs from where MSXML docs are generated and later merged with iOS docs on the user's machine.

On January 22, 2018, commits 542f219f and ce6f06729 renamed the directories from, e.g.,en/MonoTouch.UIKit toen/UIKit. In almost all casesgit log {type.xml} will track back only to these commits. To track past those commits, use:

git log --follow --find-copies-harder --find-renames=40 {type.xml}

Lowering thefind-renames threshold to around 40 seems to work in almost all cases. You can try lower thresholds, although at some point you could presumably start triggering incorrect matches.

Microsoft and any contributors grant you a license to the Microsoft documentation and other contentin this repository under theCreative Commons Attribution 4.0 International Public License,see theLICENSE file, and grant you a license to any code in the repository under theMIT License, see theLICENSE-CODE file.

Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentationmay be either trademarks or registered trademarks of Microsoft in the United States and/or other countries.The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks.For more information, see Microsoft'sgeneral trademark guidelines.

For more information about privacy concerns, seePrivacy at Microsoft.

Microsoft and any contributors reserve all others rights, whether under their respective copyrights, patents,or trademarks, whether by implication, estoppel or otherwise.