[Openinteract-commits] CVS: OpenInteract2/doc/Manual Conversion.pod,1.13,1.14

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

Update of /cvsroot/openinteract/OpenInteract2/doc/Manual
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv28544/doc/Manual

Modified Files:
	Conversion.pod 
Log Message:
some conversion updates, including package.ini


Index: Conversion.pod
===================================================================
RCS file: /cvsroot/openinteract/OpenInteract2/doc/Manual/Conversion.pod,v
retrieving revision 1.13
retrieving revision 1.14
diff -C2 -d -r1.13 -r1.14
*** Conversion.pod	28 Nov 2004 16:19:25 -0000	1.13
--- Conversion.pod	17 Mar 2005 02:29:13 -0000	1.14
***************
*** 106,121 ****
  =back
  
! There is no structural change necessary for these files to
! work. However, depending on your scenario you may wish to upgrade your
! package by a whole version number to indicate that it will only work
! with OI2. This also allows you to maintain two source trees for a
! particular package, just in case you need to support both of them.
  
  B<package.conf>
  
! The only structural change is that the 'template_blocks' directive has
! been removed from the package configuration.
  
! To change:
  
  =over 4
--- 106,123 ----
  =back
  
! Except for C<package.conf> there is no structural change necessary for
! these files to work. However, depending on your scenario you may wish
! to upgrade your package by a whole version number to indicate that it
! will only work with OI2. This also allows you to maintain two source
! trees for a particular package, just in case you need to support both
! of them.
  
  B<package.conf>
  
! This has been replaced by C<package.ini>; the script
! C<scripts/translate_package_to_ini.pl> shipped with OI2 will do this
! for you.
  
! Additionally, you'll need to change:
  
  =over 4
***************
*** 142,146 ****
  You can also use the L<ExtUtils::Manifest|ExtUtils::Manifest> trick:
  
! [% INCLUDE examples/conversion_eu_manifest | indent 2 %]
  
  =head2 Configuration (conf/)
--- 144,148 ----
  You can also use the L<ExtUtils::Manifest|ExtUtils::Manifest> trick:
  
!  $ perl -MExtUtils::Manifest -e 'ExtUtils::Manifest::mkmanifest()'
  
  =head2 Configuration (conf/)
***************
*** 204,218 ****
  =head2 Documentation (doc/)
  
! Documentation is pretty much the same. The system documentation tool
! under C</SystemDoc/> will pick up all POD files in a package's C<doc/>
! directory. Instead of using an index (C<titles>) that always, always
! got out of sync, we instead just parse all the docs and grab the title
! out of it. Yes, it's more expensive, but how often are you browsing
! package docs? (And you have fast disk drives and/or an aggressively
! caching filesystem, right?)
! 
! And because OI no longer has error handlers you can delete the
! C<ERRORS> section from your POD. (Packages generated with OI had this
! by default.)
  
  To change:
--- 206,213 ----
  =head2 Documentation (doc/)
  
! Documenation has moved to the C<OpenInteract2::App> subclass. And
! because OI no longer has error handlers you can delete the C<ERRORS>
! section from your POD. (Packages generated with OI had this by
! default.)
  
  To change:
***************
*** 226,232 ****
  =item *
  
! C<package.pod> - If you have a file of this name, rename it to
! 'packagename'.pod -- e.g., 'gallery.pod' if you're modifying the
! 'gallery' package, etc.
  
  =back
--- 221,226 ----
  =item *
  
! C<package.pod> - Copy the content into
! C<OpenInteract2::App::YourPackage>.
  
  =back
***************
*** 276,280 ****
  =head2 Template (template/)
  
! 
  
  =head2 Examples (eg/)
--- 270,274 ----
  =head2 Template (template/)
  
! These should remain the same.
  
  =head2 Examples (eg/)
***************
*** 311,320 ****
--- 305,329 ----
  =head2 Request vs. Context
  
+ In OpenInteract 1.x the omnipresent object was C<$R>. In OpenInteract
+ 2.x it's C<CTX>, imported from L<OpenInteract2::Context>. The main
+ difference is that we now have a clear separation of concerns -- the
+ context holds data that lives from request to request; per-request
+ data are held in the objects returned by the C<request()> and
+ C<response()> methods, represented by L<OpenInteract2::Request> and
+ L<OpenInteract2::Response> classes.
+ 
  =head2 Logging
  
+ We now use the L<Log::Log4perl> package from CPAN -- see
+ L<OpenInteract2::Manual::Logging> for more information.
+ 
  =head2 Libraries (OpenInteract/)
  
+ These get moved to C<OpenInteract2/>
+ 
  =head2 Handlers (OpenInteract/Handler)
  
+ These get moved to C<OpenInteract2/Action>.
+ 
  =head1 COPYRIGHT