[Rt-commit] r13503 - rt/3.8/trunk/lib/RT

[ruz at bestpractical.com]

Author: ruz
Date: Fri Jun 20 19:23:49 2008
New Revision: 13503

Modified:
   rt/3.8/trunk/lib/RT/SharedSetting.pm

Log:
* pod changes
* add empty {Save|Update}Attribute methods

Modified: rt/3.8/trunk/lib/RT/SharedSetting.pm
==============================================================================
--- rt/3.8/trunk/lib/RT/SharedSetting.pm	(original)
+++ rt/3.8/trunk/lib/RT/SharedSetting.pm	Fri Jun 20 19:23:49 2008
@@ -89,7 +89,7 @@
 =head2 Load
 
 Takes a privacy specification and a shared-setting ID.  Loads the given object
-ID if it belongs to the stated user or group. Calls the PostLoad method on
+ID if it belongs to the stated user or group. Calls the L</PostLoad> method on
 success for any further initialization. Returns a tuple of status and message,
 where status is true on success.
 
@@ -154,7 +154,7 @@
 
 Takes a privacy, a name, and any other arguments. Saves the given parameters to
 the appropriate user/group object, and loads the resulting object. Arguments
-are passed to the SaveAttribute method, which does the actual update. Returns a
+are passed to the L</SaveAttribute> method, which does the actual update. Returns a
 tuple of status and message, where status is true on success. Defaults are:
 
   Privacy:  CurrentUser only
@@ -199,11 +199,19 @@
     }
 }
 
+=head2 SaveAttribute
+
+An empty method for subclassing. Called from L</Save> method.
+
+=cut
+
+sub SaveAttribute { }
+
 =head2 Update
 
 Updates the parameters of an existing shared setting. Any arguments are passed
-to the UpdateAttribute method. Returns a tuple of status and message, where
-status is true on success. 
+to the L</UpdateAttribute> method. Returns a tuple of status and message, where
+status is true on success.
 
 =cut
 
@@ -227,6 +235,14 @@
     return ($status, $self->loc("[_1] update: [_2]", ucfirst($self->ObjectName), $msg));
 }
 
+=head2 UpdateAttribute
+
+An empty method for subclassing. Called from L</Update> method.
+
+=cut
+
+sub UpdateAttribute { }
+
 =head2 Delete
     
 Deletes the existing shared setting. Returns a tuple of status and message,