- Merge in changes from FeedbackReporter framework master up to 9bcc34dd34396f9e0285f96a148c2071c52e7abb, including localisation improvements and code cleanu$

 - Disable retrieval of user's "Me" card from the address book to avoid Security warnings about accessing Contacts on 10.8

1 files changed, 11 insertions, 3 deletions

diff --git a/Frameworks/FeedbackReporter.framework/Versions/A/Headers/FRFeedbackReporter.h b/Frameworks/FeedbackReporter.framework/Versions/A/Headers/FRFeedbackReporter.h
index e1ffe927..954f7ce1 100644
--- a/Frameworks/FeedbackReporter.framework/Versions/A/Headers/FRFeedbackReporter.h
+++ b/Frameworks/FeedbackReporter.framework/Versions/A/Headers/FRFeedbackReporter.h
@@ -1,5 +1,5 @@
 /*
- * Copyright 2008, Torsten Curdt
+ * Copyright 2008-2011, Torsten Curdt
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -16,10 +16,12 @@
 
 #import <Cocoa/Cocoa.h>
 
-@protocol FRFeedbackReporterDelegate
+@protocol FRFeedbackReporterDelegate <NSObject>
 @optional
 - (NSDictionary*) customParametersForFeedbackReport;
 - (NSMutableDictionary*) anonymizePreferencesForFeedbackReport:(NSMutableDictionary *)preferences;
+- (NSString *) targetUrlForFeedbackReport;
+- (NSString *) feedbackDisplayName;
 @end
 
 @interface FRFeedbackReporter : NSObject {
@@ -29,14 +31,20 @@
         id<FRFeedbackReporterDelegate> delegate;
 }
 
+// Creates and returns the singleton FRFeedbackReporter. Does not perform any checks or other real work.
 + (FRFeedbackReporter *)sharedReporter;
 
+// Gets/sets the delegate.
 - (id<FRFeedbackReporterDelegate>) delegate;
 - (void) setDelegate:(id<FRFeedbackReporterDelegate>) delegate;
 
+// Displays the feedback user interface allowing the user to provide general feedback. Returns YES if it was able to display the UI, NO otherwise.
 - (BOOL) reportFeedback;
+
+// Searches the disk for crash logs, and displays the feedback user interface if there are crash logs newer than since the last check. Updates the 'last crash check date' in user defaults. Returns YES if it was able to display the UI, NO otherwise.
 - (BOOL) reportIfCrash;
+
+// Displays the feedback user interface for the given exception. Do not pass nil. Returns YES if it was able to display the UI, NO otherwise.
 - (BOOL) reportException:(NSException *)exception;
 
 @end
-