[Openinteract-commits] CVS: OpenInteract2/lib/OpenInteract2 Observer.pm,1.4,1.5

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

Update of /cvsroot/openinteract/OpenInteract2/lib/OpenInteract2
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv8513/OpenInteract2

Modified Files:
	Observer.pm 
Log Message:
cosmetic


Index: Observer.pm
===================================================================
RCS file: /cvsroot/openinteract/OpenInteract2/lib/OpenInteract2/Observer.pm,v
retrieving revision 1.4
retrieving revision 1.5
diff -C2 -d -r1.4 -r1.5
*** Observer.pm	18 Mar 2005 04:09:48 -0000	1.4
--- Observer.pm	21 Sep 2005 04:08:53 -0000	1.5
***************
*** 33,36 ****
--- 33,38 ----
          }
      }
+ 
+     # barely documented: Allow registration of objects...
      elsif ( my $observer_obj = $observer_info->{object} ) {
          my $error = $class->_require_module( $observer_obj );
***************
*** 48,51 ****
--- 50,55 ----
          }
      }
+ 
+     # barely documented: Allow registration of coderefs...
      elsif ( my $observer_sub = $observer_info->{sub} ) {
          $observer_sub =~ /^(.*)::(.*)$/;
***************
*** 229,238 ****
   # You can also declare the observer in your package's package.conf
   # file; it's mapped the same no matter where it's declared
!  # File: pkg/mypackage-2.00/package.conf
   
!  name           mypackage
!  version        2.00
!  author         Kilroy (ki...@wa...)
!  observer       allcaps   OpenInteract2::Filter::AllCaps
   
   # Create the filter -- see OpenInteract2::Filter::AllCaps shipped
--- 233,247 ----
   # You can also declare the observer in your package's package.conf
   # file; it's mapped the same no matter where it's declared
!  # File: pkg/mypackage-2.00/package.ini
   
!  [package]
!  name    = mypackage
!  version = 2.00
!  author  = Kilroy (ki...@wa...)
!  
!  [package observer]
!  allcaps = OpenInteract2::Filter::AllCaps
!  
!  ...
   
   # Create the filter -- see OpenInteract2::Filter::AllCaps shipped
***************
*** 264,269 ****
  
  Most observers react to one or two types of events. For instance, if
! you're using the C<delicious_tags> package there's an observer that
! looks like this:
  
   sub update {
--- 273,278 ----
  
  Most observers react to one or two types of events. For instance, if
! you're using the C<object_tags> package there's an observer that looks
! like this:
  
   sub update {
***************
*** 390,415 ****
  Most of the time you'll register an observer name with a class. The
  following registers two observers to classes under the names 'wiki'
! and 'delicious_tag':
  
   [observer]
   wiki          = OpenInteract2::Observer::Wikify
!  delicious_tag = OpenInteract2::Observer::AddDeliciousTags
! 
! This standard usage is actually a shortcut for:
! 
!  [observer wiki]
!  class = OpenInteract2::Observer::Wikify
!  
!  [observer delicious_tag]
!  class = OpenInteract2::Observer::AddDeliciousTags
! 
! Or more generically:
! 
!  [observer observer-name]
!  observation-type = value
  
! In addition to assigning class observers register a particular
! subroutine or object instance. The three observation types are
! 'class', 'object' and 'sub' (see
  L<Class::Observable|Class::Observable> for what these mean and how
  they are setup), so you could have:
--- 399,411 ----
  Most of the time you'll register an observer name with a class. The
  following registers two observers to classes under the names 'wiki'
! and 'object_tag':
  
   [observer]
   wiki          = OpenInteract2::Observer::Wikify
!  object_tag    = OpenInteract2::Observer::AddObjectTags
  
! In addition to assigning class observers you can also register a
! particular subroutine or object instance. The three observation types
! are 'class', 'object' and 'sub' (see
  L<Class::Observable|Class::Observable> for what these mean and how
  they are setup), so you could have:
***************
*** 421,426 ****
   sub    = OpenInteract2::FooFilter::other_sub
  
! Using the object is fairly rare and you should probably use the class observer for
! its simplicity.
  
  =head2 Configuration: Mapping the Observer to an Action
--- 417,422 ----
   sub    = OpenInteract2::FooFilter::other_sub
  
! Using the object is fairly rare and you should probably use the class
! observer for its simplicity.
  
  =head2 Configuration: Mapping the Observer to an Action
***************
*** 429,438 ****
  C<$WEBSITE_DIR/conf/observer.ini>. Under the 'map' section you assign
  an observer to one or more actions. Here as assign the observer 'wiki'
! to 'news' and 'page' and 'delicious_tag' to 'news':
  
   [map]
   wiki = news
   wiki = page
!  delicious_tag = news
  
  Note that the mapping is ignorant of:
--- 425,440 ----
  C<$WEBSITE_DIR/conf/observer.ini>. Under the 'map' section you assign
  an observer to one or more actions. Here as assign the observer 'wiki'
! to 'news' and 'page' and 'object_tag' to 'news':
  
   [map]
   wiki = news
   wiki = page
!  object_tag = news
! 
! You could also use the standard INI-shortcuts for lists:
! 
!  [map]
!  @,wiki = news,page
!  object_tag = news
  
  Note that the mapping is ignorant of:
***************
*** 456,459 ****
--- 458,463 ----
  L<Class::Observable>
  
+ L<OpenInteract2::Setup::InitializeObservers>
+ 
  =head1 COPYRIGHT