Documentation improvements

This commit is contained in:
Andreas Linde
2013-09-16 12:53:40 +02:00
parent fed4684969
commit 88b50694d7
2 changed files with 15 additions and 9 deletions

View File

@@ -90,21 +90,21 @@ typedef void(^tValidationCompletion)(BOOL validated, NSError *error);
* Authentication is a 2 step process: * Authentication is a 2 step process:
* *
* 1. authenticate: * 1. authenticate:
* a token is acquired depending on the authenticationType * a token is acquired depending on the `authenticationType`
* 2. validation: * 2. validation:
* the acquired token from step 1 is validated depending the validationType * the acquired token from step 1 is validated depending the `validationType`
* *
* There are currently 3 ways of authentication: * There are currently 3 ways of authentication (`BITAuthenticatorAuthType`):
* *
* 1. authenticate the user via email only (`BITAuthenticatorAuthTypeEmail`) * 1. authenticate the user via email only (`BITAuthenticatorAuthTypeEmail`)
* 2. authenticate the user via email & password (`BITAuthenticatorAuthTypeEmailAndPassword`) * 2. authenticate the user via email & password (`BITAuthenticatorAuthTypeEmailAndPassword`)
* 3. authenticate the device via its UDID (_Default_) (`BITAuthenticatorAuthTypeUDIDProvider`) * 3. authenticate the device via its UDID (_Default_) (`BITAuthenticatorAuthTypeUDIDProvider`)
* *
* There are currently 4 ways of validation: * There are currently 4 ways of validation (`BITAuthenticatorValidationType`):
* *
* 1. never (_Default_) (`BITAuthenticatorValidationTypeNever`) * 1. never (_Default_) (`BITAuthenticatorValidationTypeNever`)
* 2. optional (`BITAuthenticatorValidationTypeOptional`) * 2. optional (`BITAuthenticatorValidationTypeOptional`)
* 3. on first launch of a new app version(`BITAuthenticatorValidationTypeOnFirstLaunch`) * 3. on first launch of a new app version (`BITAuthenticatorValidationTypeOnFirstLaunch`)
* 4. every time the app becomes active (needs internet connection) (`BITAuthenticatorValidationTypeOnAppActive`) * 4. every time the app becomes active (needs internet connection) (`BITAuthenticatorValidationTypeOnAppActive`)
* *
*/ */
@@ -114,13 +114,19 @@ typedef void(^tValidationCompletion)(BOOL validated, NSError *error);
/** /**
* Defines the authentication mechanism to be used * Defines the authentication mechanism to be used
* *
* _Default_: BITAuthenticatorAuthTypeUDIDProvider * The values are listed here: `BITAuthenticatorAuthType`
*
* _Default_: `BITAuthenticatorAuthTypeUDIDProvider`
*/ */
@property (nonatomic, assign) BITAuthenticatorAuthType authenticationType; @property (nonatomic, assign) BITAuthenticatorAuthType authenticationType;
/** /**
* _Default_: BITAuthenticatorValidationTypeNever * Defines the validation mechanism to be used
*
* The values are listed here: `BITAuthenticatorValidationType`
*
* _Default_: `BITAuthenticatorValidationTypeNever`
*/ */
@property (nonatomic, assign) BITAuthenticatorValidationType validationType; @property (nonatomic, assign) BITAuthenticatorValidationType validationType;

View File

@@ -809,7 +809,7 @@
); );
runOnlyForDeploymentPostprocessing = 0; runOnlyForDeploymentPostprocessing = 0;
shellPath = /bin/sh; shellPath = /bin/sh;
shellScript = "/usr/local/bin/appledoc \\\n --output \"${SOURCE_ROOT}/../documentation\" \\\n --ignore Vendor \\\n --ignore Products \\\n --ignore Support \\\n --ignore .m \\\n --ignore *Private.h \\\n --create-html \\\n --create-docset \\\n --install-docset \\\n --keep-intermediate-files \\\n --project-name \"${HOCKEYSDK_DOCSET_NAME} ${VERSION_STRING}\" \\\n --project-version \"${VERSION_STRING}\" \\\n --project-company \"Bit Stadium GmbH\" \\\n --company-id \"de.bitstadium\" \\\n --docset-bundle-name \"${HOCKEYSDK_DOCSET_NAME} ${VERSION_STRING}\" \\\n --docset-feed-name \"${HOCKEYSDK_DOCSET_NAME}\" \\\n --docset-desc \"\" \\\n --docset-platform-family \"iphoneos\" \\\n --index-desc \"${SOURCE_ROOT}/../docs/index.md\" \\\n --include \"${SOURCE_ROOT}/../docs/index.html\" \\\n --include \"${SOURCE_ROOT}/../docs/\" \\\n --merge-categories \\\n --no-repeat-first-par \\\n --warn-undocumented-object \\\n --warn-undocumented-member \\\n --warn-empty-description \\\n --warn-unknown-directive \\\n --warn-invalid-crossref \\\n --warn-missing-arg \\\n --logformat xcode \\\n --exit-threshold 2 \\\n \"${SOURCE_ROOT}/../\"\n"; shellScript = "/usr/local/bin/appledoc \\\n --output \"${SOURCE_ROOT}/../documentation\" \\\n --ignore Vendor \\\n --ignore Products \\\n --ignore Support \\\n --ignore .m \\\n --ignore *Private.h \\\n --ignore BITAttributedLabel.h \\\n --ignore BITStoreButton.h \\\n --ignore BITFeedbackListViewCell.h \\\n --ignore BITAppStoreHeader.h \\\n --ignore BITFeedbackMessage.h \\\n --create-html \\\n --create-docset \\\n --install-docset \\\n --keep-intermediate-files \\\n --project-name \"${HOCKEYSDK_DOCSET_NAME} ${VERSION_STRING}\" \\\n --project-version \"${VERSION_STRING}\" \\\n --project-company \"Bit Stadium GmbH\" \\\n --company-id \"de.bitstadium\" \\\n --docset-bundle-name \"${HOCKEYSDK_DOCSET_NAME} ${VERSION_STRING}\" \\\n --docset-feed-name \"${HOCKEYSDK_DOCSET_NAME}\" \\\n --docset-desc \"\" \\\n --docset-platform-family \"iphoneos\" \\\n --index-desc \"${SOURCE_ROOT}/../docs/index.md\" \\\n --include \"${SOURCE_ROOT}/../docs/index.html\" \\\n --include \"${SOURCE_ROOT}/../docs/\" \\\n --merge-categories \\\n --no-repeat-first-par \\\n --warn-undocumented-object \\\n --warn-undocumented-member \\\n --warn-empty-description \\\n --warn-unknown-directive \\\n --warn-invalid-crossref \\\n --warn-missing-arg \\\n --logformat xcode \\\n --exit-threshold 2 \\\n \"${SOURCE_ROOT}/../\"\n";
}; };
1EE9071A16F6871F003DDE1D /* ShellScript */ = { 1EE9071A16F6871F003DDE1D /* ShellScript */ = {
isa = PBXShellScriptBuildPhase; isa = PBXShellScriptBuildPhase;