Merge pull request #449 from phatblat/phatblat/pr/desinit

jspahrsummers · jspahrsummers · commit 2811537bebe1 · 2015-03-20T20:30:33.000-07:00
Mark NS_DESIGNATED_INITIALIZER methods
diff --git a/ObjectiveGit/GTBlame.h b/ObjectiveGit/GTBlame.h
@@ -16,7 +16,7 @@
 @interface GTBlame : NSObject
 
 /// Designated initializer.
-- (instancetype)initWithGitBlame:(git_blame *)blame;
+- (instancetype)initWithGitBlame:(git_blame *)blame NS_DESIGNATED_INITIALIZER;
 
 /// Get all the hunks in the blame. A convenience wrapper around `enumerateHunksUsingBlock:`
 @property (nonatomic, strong, readonly) NSArray *hunks;
diff --git a/ObjectiveGit/GTBlameHunk.h b/ObjectiveGit/GTBlameHunk.h
@@ -15,7 +15,7 @@
 /// A `GTBlameHunk` is an object that provides authorship info for a set of lines in a `GTBlame`.
 @interface GTBlameHunk : NSObject
 
-- (instancetype)initWithGitBlameHunk:(git_blame_hunk)hunk;
+- (instancetype)initWithGitBlameHunk:(git_blame_hunk)hunk NS_DESIGNATED_INITIALIZER;
 
 /// A NSRange where `location` is the (1 based) starting line number,
 /// and `length` is the number of lines in the hunk.
diff --git a/ObjectiveGit/GTBranch.h b/ObjectiveGit/GTBranch.h
@@ -52,7 +52,7 @@ typedef NS_ENUM(NSInteger, GTBranchType) {
 + (NSString *)localNamePrefix;
 + (NSString *)remoteNamePrefix;
 
-- (id)initWithReference:(GTReference *)ref repository:(GTRepository *)repo;
+- (id)initWithReference:(GTReference *)ref repository:(GTRepository *)repo NS_DESIGNATED_INITIALIZER;
 + (id)branchWithReference:(GTReference *)ref repository:(GTRepository *)repo;
 
 /// Get the target commit for this branch
diff --git a/ObjectiveGit/GTConfiguration+Private.h b/ObjectiveGit/GTConfiguration+Private.h
@@ -18,6 +18,6 @@
 /// repository - The repository in which the config resides. May be nil.
 ///
 /// Returns the initialized object.
-- (id)initWithGitConfig:(git_config *)config repository:(GTRepository *)repository;
+- (id)initWithGitConfig:(git_config *)config repository:(GTRepository *)repository NS_DESIGNATED_INITIALIZER;
 
 @end
diff --git a/ObjectiveGit/GTDiff.h b/ObjectiveGit/GTDiff.h
@@ -263,7 +263,7 @@ typedef NS_OPTIONS(NSInteger, GTDiffFindOptionsFlags) {
 /// repository - The repository in which the diff lives. Cannot be nil.
 ///
 /// Returns the initialized object.
-- (instancetype)initWithGitDiff:(git_diff *)diff repository:(GTRepository *)repository;
+- (instancetype)initWithGitDiff:(git_diff *)diff repository:(GTRepository *)repository NS_DESIGNATED_INITIALIZER;
 
 /// The libgit2 diff object.
 - (git_diff *)git_diff __attribute__((objc_returns_inner_pointer));
diff --git a/ObjectiveGit/GTDiffDelta.m b/ObjectiveGit/GTDiffDelta.m
@@ -32,7 +32,7 @@ @interface GTDiffDelta ()
 ///                  the given diff delta. Must not be nil.
 ///
 /// This is the designated initializer for this class.
-- (instancetype)initWithGitDiffDeltaBlock:(git_diff_delta (^)(void))deltaAccessor patchGeneratorBlock:(int (^)(git_patch **patch))patchGenerator;
+- (instancetype)initWithGitDiffDeltaBlock:(git_diff_delta (^)(void))deltaAccessor patchGeneratorBlock:(int (^)(git_patch **patch))patchGenerator NS_DESIGNATED_INITIALIZER;
 
 @end
 
diff --git a/ObjectiveGit/GTDiffFile.h b/ObjectiveGit/GTDiffFile.h
@@ -51,6 +51,6 @@ typedef NS_OPTIONS(NSInteger, GTDiffFileFlag) {
 /// file - The git_diff_file wrapped by the receiver.
 ///
 /// Returns an initialized GTDiffFile.
-- (instancetype)initWithGitDiffFile:(git_diff_file)file;
+- (instancetype)initWithGitDiffFile:(git_diff_file)file NS_DESIGNATED_INITIALIZER;
 
 @end
diff --git a/ObjectiveGit/GTDiffHunk.h b/ObjectiveGit/GTDiffHunk.h
@@ -24,7 +24,7 @@
 ///
 /// The contents of a hunk are lazily loaded, therefore we initialise the object
 /// simply with the patch it originates from and which hunk index it represents.
-- (instancetype)initWithPatch:(GTDiffPatch *)patch hunkIndex:(NSUInteger)hunkIndex;
+- (instancetype)initWithPatch:(GTDiffPatch *)patch hunkIndex:(NSUInteger)hunkIndex NS_DESIGNATED_INITIALIZER;
 
 /// Perfoms the given block on each line in the hunk.
 ///
diff --git a/ObjectiveGit/GTDiffLine.h b/ObjectiveGit/GTDiffLine.h
@@ -44,6 +44,6 @@ typedef NS_ENUM(char, GTDiffLineOrigin) {
 @property (nonatomic, readonly) NSInteger lineCount;
 
 /// Designated initialiser.
-- (instancetype)initWithGitLine:(const git_diff_line *)line;
+- (instancetype)initWithGitLine:(const git_diff_line *)line NS_DESIGNATED_INITIALIZER;
 
 @end
diff --git a/ObjectiveGit/GTDiffPatch.h b/ObjectiveGit/GTDiffPatch.h
@@ -36,7 +36,7 @@
 ///         automatically be freed when the receiver is deallocated. Must not be
 ///         NULL.
 /// delta - The diff delta corresponding to this patch. Must not be nil.
-- (instancetype)initWithGitPatch:(git_patch *)patch delta:(GTDiffDelta *)delta;
+- (instancetype)initWithGitPatch:(git_patch *)patch delta:(GTDiffDelta *)delta NS_DESIGNATED_INITIALIZER;
 
 /// Returns the underlying patch object.
 - (git_patch *)git_patch __attribute__((objc_returns_inner_pointer));
diff --git a/ObjectiveGit/GTEnumerator.h b/ObjectiveGit/GTEnumerator.h
@@ -66,7 +66,7 @@ typedef NS_OPTIONS(unsigned int, GTEnumeratorOptions) {
 /// error - If not NULL, set to any error that occurs.
 ///
 /// Returns an initialized enumerator, or nil if an error occurs.
-- (id)initWithRepository:(GTRepository *)repo error:(NSError **)error;
+- (id)initWithRepository:(GTRepository *)repo error:(NSError **)error NS_DESIGNATED_INITIALIZER;
 
 /// Marks a commit to start traversal from.
 ///
diff --git a/ObjectiveGit/GTFetchHeadEntry.h b/ObjectiveGit/GTFetchHeadEntry.h
@@ -33,6 +33,6 @@
 /// remoteURLString - URL String where this was originally fetched from. Cannot be nil.
 /// targetOID       - Target OID. Cannot be nil.
 /// merge           - Indicates if this is pending a merge.
-- (instancetype)initWithReference:(GTReference *)reference remoteURLString:(NSString *)remoteURLString targetOID:(GTOID *)targetOID isMerge:(BOOL)merge;
+- (instancetype)initWithReference:(GTReference *)reference remoteURLString:(NSString *)remoteURLString targetOID:(GTOID *)targetOID isMerge:(BOOL)merge NS_DESIGNATED_INITIALIZER;
 
 @end
diff --git a/ObjectiveGit/GTFilter.h b/ObjectiveGit/GTFilter.h
@@ -45,7 +45,7 @@ extern const NSInteger GTFilterErrorNameAlreadyRegistered;
 /// applyBlock - The block to use to apply the filter. Cannot be nil.
 ///
 /// Returns the initialized object.
-- (id)initWithName:(NSString *)name attributes:(NSString *)attributes applyBlock:(NSData * (^)(void **payload, NSData *from, GTFilterSource *source, BOOL *applied))applyBlock;
+- (id)initWithName:(NSString *)name attributes:(NSString *)attributes applyBlock:(NSData * (^)(void **payload, NSData *from, GTFilterSource *source, BOOL *applied))applyBlock NS_DESIGNATED_INITIALIZER;
 
 /// Look up a filter based on its name.
 ///
diff --git a/ObjectiveGit/GTFilterList.h b/ObjectiveGit/GTFilterList.h
@@ -26,7 +26,7 @@ typedef NS_OPTIONS(NSInteger, GTFilterListOptions) {
 /// filterList - The filter list to wrap and take ownership of. This filter list
 ///              will be automatically disposed when the receiver deallocates.
 ///              Must not be NULL.
-- (instancetype)initWithGitFilterList:(git_filter_list *)filterList;
+- (instancetype)initWithGitFilterList:(git_filter_list *)filterList NS_DESIGNATED_INITIALIZER;
 
 /// Returns the underlying `git_filter_list`.
 - (git_filter_list *)git_filter_list __attribute__((objc_returns_inner_pointer));
diff --git a/ObjectiveGit/GTFilterSource.h b/ObjectiveGit/GTFilterSource.h
@@ -43,6 +43,6 @@ typedef NS_ENUM(NSInteger, GTFilterSourceMode) {
 /// source - The filter source. Cannot be NULL.
 ///
 /// Returns the initialized object.
-- (id)initWithGitFilterSource:(const git_filter_source *)source;
+- (id)initWithGitFilterSource:(const git_filter_source *)source NS_DESIGNATED_INITIALIZER;
 
 @end
diff --git a/ObjectiveGit/GTIndex.h b/ObjectiveGit/GTIndex.h
@@ -76,7 +76,7 @@
 /// repository - The repository in which the index resides. Cannot be nil.
 ///
 /// Returns the initialized index.
-- (instancetype)initWithGitIndex:(git_index *)index repository:(GTRepository *)repository;
+- (instancetype)initWithGitIndex:(git_index *)index repository:(GTRepository *)repository NS_DESIGNATED_INITIALIZER;
 
 /// The underlying `git_index` object.
 - (git_index *)git_index __attribute__((objc_returns_inner_pointer));
diff --git a/ObjectiveGit/GTIndexEntry.h b/ObjectiveGit/GTIndexEntry.h
@@ -54,7 +54,7 @@ typedef NS_ENUM(NSInteger, GTIndexEntryStatus) {
 /// entry - The libgit2 index entry. Cannot be NULL.
 ///
 /// Returns the initialized object.
-- (id)initWithGitIndexEntry:(const git_index_entry *)entry;
+- (id)initWithGitIndexEntry:(const git_index_entry *)entry NS_DESIGNATED_INITIALIZER;
 
 /// The underlying `git_index_entry` object.
 - (const git_index_entry *)git_index_entry __attribute__((objc_returns_inner_pointer));
diff --git a/ObjectiveGit/GTOID.h b/ObjectiveGit/GTOID.h
@@ -25,7 +25,7 @@
 /// git_oid - The underlying git_oid. Cannot be NULL.
 ///
 /// Returns the initialized receiver.
-- (id)initWithGitOid:(const git_oid *)git_oid;
+- (id)initWithGitOid:(const git_oid *)git_oid NS_DESIGNATED_INITIALIZER;
 
 /// Initializes the receiver by converting the given SHA to an OID.
 ///
@@ -57,7 +57,7 @@
 /// error  - Will be filled with an error object in if the SHA cannot be parsed
 ///
 /// Returns the initialized receiver.
-- (id)initWithSHACString:(const char *)string error:(NSError **)error;
+- (id)initWithSHACString:(const char *)string error:(NSError **)error NS_DESIGNATED_INITIALIZER;
 
 /// Creates a new instance with the given git_oid using initWithGitOid:
 + (instancetype)oidWithGitOid:(const git_oid *)git_oid;
diff --git a/ObjectiveGit/GTObject.h b/ObjectiveGit/GTObject.h
@@ -56,7 +56,7 @@ typedef NS_ENUM(int, GTObjectType) {
 @property (nonatomic, readonly) GTOID *OID;
 
 /// Convenience initializers
-- (id)initWithObj:(git_object *)theObject inRepository:(GTRepository *)theRepo;
+- (id)initWithObj:(git_object *)theObject inRepository:(GTRepository *)theRepo NS_DESIGNATED_INITIALIZER;
 + (id)objectWithObj:(git_object *)theObject inRepository:(GTRepository *)theRepo;
 
 /// The underlying `git_object`.
diff --git a/ObjectiveGit/GTObjectDatabase.h b/ObjectiveGit/GTObjectDatabase.h
@@ -38,7 +38,7 @@
 /// error - The error if one occurred.
 ///
 /// Returns the initialized object.
-- (id)initWithRepository:(GTRepository *)repo error:(NSError **)error;
+- (id)initWithRepository:(GTRepository *)repo error:(NSError **)error NS_DESIGNATED_INITIALIZER;
 
 /// The underlying `git_odb` object.
 - (git_odb *)git_odb __attribute__((objc_returns_inner_pointer));
diff --git a/ObjectiveGit/GTOdbObject.h b/ObjectiveGit/GTOdbObject.h
@@ -21,7 +21,7 @@
 /// repository - The repository in which the object resides. Cannot be nil.
 ///
 /// Returns the initialized object.
-- (id)initWithOdbObj:(git_odb_object *)object repository:(GTRepository *)repository;
+- (id)initWithOdbObj:(git_odb_object *)object repository:(GTRepository *)repository NS_DESIGNATED_INITIALIZER;
 
 /// The underlying `git_odb_object`.
 - (git_odb_object *)git_odb_object __attribute__((objc_returns_inner_pointer));
diff --git a/ObjectiveGit/GTReference.h b/ObjectiveGit/GTReference.h
@@ -65,7 +65,7 @@ typedef NS_OPTIONS(NSInteger, GTReferenceType) {
 + (id)referenceByResolvingSymbolicReference:(GTReference *)symbolicRef error:(NSError **)error;
 - (id)initByResolvingSymbolicReference:(GTReference *)symbolicRef error:(NSError **)error;
 
-- (id)initWithGitReference:(git_reference *)ref repository:(GTRepository *)repository;
+- (id)initWithGitReference:(git_reference *)ref repository:(GTRepository *)repository NS_DESIGNATED_INITIALIZER;
 
 /// The underlying `git_reference` object.
 - (git_reference *)git_reference __attribute__((objc_returns_inner_pointer));
diff --git a/ObjectiveGit/GTReflog+Private.h b/ObjectiveGit/GTReflog+Private.h
@@ -17,6 +17,6 @@
 /// reference - The reference whose reflog is being represented. Cannot be nil.
 ///
 /// Returns the initialized object.
-- (id)initWithReference:(GTReference *)reference;
+- (id)initWithReference:(GTReference *)reference NS_DESIGNATED_INITIALIZER;
 
 @end
diff --git a/ObjectiveGit/GTReflogEntry+Private.h b/ObjectiveGit/GTReflogEntry+Private.h
@@ -17,6 +17,6 @@
 /// reflog - The reflog in which the entry resides. Cannot be nil.
 ///
 /// Returns the initialized object.
-- (id)initWithGitReflogEntry:(const git_reflog_entry *)entry reflog:(GTReflog *)reflog;
+- (id)initWithGitReflogEntry:(const git_reflog_entry *)entry reflog:(GTReflog *)reflog NS_DESIGNATED_INITIALIZER;
 
 @end
diff --git a/ObjectiveGit/GTRemote.h b/ObjectiveGit/GTRemote.h
@@ -88,7 +88,7 @@ typedef enum {
 ///
 /// remote - The underlying `git_remote` object. Cannot be nil.
 /// repo   - The repository the remote belongs to. Cannot be nil.
-- (instancetype)initWithGitRemote:(git_remote *)remote inRepository:(GTRepository *)repo;
+- (instancetype)initWithGitRemote:(git_remote *)remote inRepository:(GTRepository *)repo NS_DESIGNATED_INITIALIZER;
 
 /// The underlying `git_remote` object.
 - (git_remote *)git_remote __attribute__((objc_returns_inner_pointer));
diff --git a/ObjectiveGit/GTRepository.h b/ObjectiveGit/GTRepository.h
@@ -187,7 +187,7 @@ extern NSString * const GTRepositoryInitOptionsOriginURLString;
 ///              after this method is invoked. This must not be nil.
 ///
 /// Returns an initialized GTRepository.
-- (id)initWithGitRepository:(git_repository *)repository;
+- (id)initWithGitRepository:(git_repository *)repository NS_DESIGNATED_INITIALIZER;
 
 /// The underlying `git_repository` object.
 - (git_repository *)git_repository __attribute__((objc_returns_inner_pointer));
diff --git a/ObjectiveGit/GTStatusDelta.h b/ObjectiveGit/GTStatusDelta.h
@@ -46,6 +46,6 @@ typedef NS_ENUM(NSInteger, GTStatusDeltaStatus) {
 @property (nonatomic, readonly) double similarity;
 
 /// Designated initializer.
-- (instancetype)initWithGitDiffDelta:(const git_diff_delta *)delta;
+- (instancetype)initWithGitDiffDelta:(const git_diff_delta *)delta NS_DESIGNATED_INITIALIZER;
 
 @end
diff --git a/ObjectiveGit/GTSubmodule.h b/ObjectiveGit/GTSubmodule.h
@@ -97,7 +97,7 @@ typedef NS_OPTIONS(NSInteger, GTSubmoduleStatus) {
 ///              nil.
 ///
 /// Returns an initialized GTSubmodule, or nil if an error occurs.
-- (id)initWithGitSubmodule:(git_submodule *)submodule parentRepository:(GTRepository *)repository;
+- (id)initWithGitSubmodule:(git_submodule *)submodule parentRepository:(GTRepository *)repository NS_DESIGNATED_INITIALIZER;
 
 /// The underlying `git_submodule` object.
 - (git_submodule *)git_submodule __attribute__((objc_returns_inner_pointer));
diff --git a/ObjectiveGit/GTTreeBuilder.h b/ObjectiveGit/GTTreeBuilder.h
@@ -59,7 +59,7 @@ typedef NS_ENUM(NSInteger, GTFileMode) {
 /// error      - The error if one occurred.
 ///
 /// Returns the initialized object, or nil if an error occurred.
-- (id)initWithTree:(GTTree *)treeOrNil repository:(GTRepository *)repository error:(NSError **)error;
+- (id)initWithTree:(GTTree *)treeOrNil repository:(GTRepository *)repository error:(NSError **)error NS_DESIGNATED_INITIALIZER;
 
 /// The underlying `git_treebuilder` object.
 - (git_treebuilder *)git_treebuilder __attribute__((objc_returns_inner_pointer));
