From 75f86142d0088c0c45469a91b931534a2af8799d Mon Sep 17 00:00:00 2001 From: David Ayers Date: Mon, 14 Feb 2005 12:11:49 +0000 Subject: [PATCH] * EOAccess/EOModel.m (writeToFile:): Clairfy documentation about setting receivers name and path. git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/gdl2/trunk@20708 72102866-910b-0410-8b05-ffd578937521 --- ChangeLog | 5 +++++ EOAccess/EOModel.m | 19 +++++++++++-------- 2 files changed, 16 insertions(+), 8 deletions(-) diff --git a/ChangeLog b/ChangeLog index c5e8f70..e59192c 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2005-02-10 David Ayers + + * EOAccess/EOModel.m (writeToFile:): Clairfy documentation about + setting receivers name and path. + 2005-02-13 Manuel Guesdon * EOControl/EOClassDescription.m: o use IMPs diff --git a/EOAccess/EOModel.m b/EOAccess/EOModel.m index 07a3a49..a043e6b 100644 --- a/EOAccess/EOModel.m +++ b/EOAccess/EOModel.m @@ -581,18 +581,21 @@ NSString *EOEntityLoadedNotification = @"EOEntityLoadedNotification"; } /** - * Writes the receivers plist representation into an - * .eomodeld file wrapper located at path. - * Depending on the the path extension .eomodeld or .eomodel + *

Writes the receivers plist representation into an + * .eomodeld file wrapper located at path.

+ *

Depending on the the path extension .eomodeld or .eomodel * the corresponding format will be used. * If the path has neither .eomodeld nor .eomodel path - * extension, .eomodeld will be used. - * If the file located at path already exists, a back is created + * extension, .eomodeld will be used.

+ *

If the file located at path already exists, a back is created * by appending a '~' character to file name. * If a backup file already exists, when trying to create a backup, - * the old backup will be deleted. - * If any of the file operations fail, an NSInvalidArgumentException - * will be raised. + * the old backup will be deleted.

+ *

If any of the file operations fail, an NSInvalidArgumentException + * will be raised.

+ *

This method as the side effeect of setting the receivers path and + * name. The this change can happen even if the write operation fails + * with an exception.

*/ - (void)writeToFile: (NSString *)path {