Various export enhancements and fixes, including:

- A new SPExportFile class, providing an abstract interface to the handling and creation of export files.
- Enables the centralisation of all file/file handle creation logic as well as better support for handling situations where files fail to be created, including files that already exist at the export location.
- New SPExportFileHandleStatus constants to support the reporting of file handle creation.
- Update SPExporter to use the new file class instead of directly using an instance of SPFileHandle.
- Add the necessary logic to deal with files that already exist on disk, by providing the user with 3 options: cancel the export, ignore the files in question or overwrite them. We might want to enhance this to make new files sequential in name to prevent overwriting. Fixes issue #742.
- New SPExportFileUtilities category, which centralises all the logic relating to writing export type headers as well as dealing with problems occurred during file/file handle creation.
- Improve feedback given on the export progress sheet during export initialisation.
- Tidy up and improve comments.

1 files changed, 9 insertions, 0 deletions

diff --git a/Source/SPExportFilenameUtilities.m b/Source/SPExportFilenameUtilities.m
index 64101b21..0695d29e 100644
--- a/Source/SPExportFilenameUtilities.m
+++ b/Source/SPExportFilenameUtilities.m
@@ -60,6 +60,8 @@
 
 /**
  * Generates the default export filename based on the selected export options.
+ *
+ * @return The default filename.
  */
 - (NSString *)generateDefaultExportFilename
 {
@@ -85,6 +87,8 @@
 
 /**
  * Returns the current default export file extension based on the selected export type.
+ *
+ * @return The default filename extension.
  */
 - (NSString *)currentDefaultExportFileExtension
 {
@@ -123,6 +127,11 @@
 
 /**
  * Expands the custom filename format based on the selected tokens.
+ *
+ * @param format The filename format that is to be expanded.
+ * @param table  A table name to be used within the expanded filename.
+ *
+ * @return The expanded filename.
  */
 - (NSString *)expandCustomFilenameFormatFromString:(NSString *)format usingTableName:(NSString *)table
 {