[Openinteract-commits] CVS: SPOPS/doc/Manual ObjectRules.pod,1.5,1.6

[Chris W. <la...@us...>]

Update of /cvsroot/openinteract/SPOPS/doc/Manual
In directory usw-pr-cvs1:/tmp/cvs-serv27936

Modified Files:
	ObjectRules.pod 
Log Message:
small updates, pointers to what's coming, etc.


Index: ObjectRules.pod
===================================================================
RCS file: /cvsroot/openinteract/SPOPS/doc/Manual/ObjectRules.pod,v
retrieving revision 1.5
retrieving revision 1.6
diff -C2 -d -r1.5 -r1.6
*** ObjectRules.pod	2001/10/12 20:21:29	1.5
--- ObjectRules.pod	2001/10/26 03:11:22	1.6
***************
*** 69,73 ****
  them.
  
! NOTE: This item is up for debate (as of 0.40).
  
  =item 3.
--- 69,73 ----
  them.
  
! NOTE: This item is up for debate
  
  =item 3.
***************
*** 127,131 ****
  a positive cache hit.
  
! B<pre_save_action(  is_add =E<gt>; bool })>
  
  Called before a save has been attempted. If this is an add operation
--- 127,131 ----
  a positive cache hit.
  
! B<pre_save_action({ is_add =E<gt> bool })>
  
  Called before a save has been attempted. If this is an add operation
***************
*** 153,160 ****
  
  =head2 Rule Factory
- 
- B<ruleset_add( $class, \%class_ruleset )>
  
! NOTE: THIS METHOD MIGHT BE RENAMED TO 'rule_factory()'
  
  Interface for adding rules to a class. The first argument is the class
--- 153,158 ----
  
  =head2 Rule Factory
  
! B<ruleset_factory( $class, \%class_ruleset )>
  
  Interface for adding rules to a class. The first argument is the class
***************
*** 172,176 ****
  from our index:
  
!   sub ruleset_add {
      my ( $class, $rs_table ) = @_;
      my $obj_class = ref $class || $class;
--- 170,174 ----
  from our index:
  
!   sub ruleset_factory {
      my ( $class, $rs_table ) = @_;
      my $obj_class = ref $class || $class;
***************
*** 185,190 ****
  ensure that the same rule does not get entered multiple times.
  
! NOTE: THIS INTERFACE MAY BE CHANGED TO INSTEAD RETURN THE NAMES
! (PACKAGE + METHOD) OF ALL ROUTINES ADDED TO THE RULESET.
  
  =head2 Rule Processor
--- 183,198 ----
  ensure that the same rule does not get entered multiple times.
  
! B<POSSIBLE CHANGES>
! 
! Instead of the above, we may change to something like:
! 
!   sub ruleset_factory {
!     my ( $class ) = @_;
!     return { post_save_action   => \&reindex_object,
!              post_remove_action => \&remove_object_from_index };
!   }
! 
! This is simpler, easier to follow and more consistent with how we
! discover behaviors to execute during the code generation process.
  
  =head2 Rule Processor