[Rt-commit] rt branch, 4.2/convert-upgrading-4.2-to-pod, repushed

[Jim Brandt]

The branch 4.2/convert-upgrading-4.2-to-pod was deleted and repushed:
       was aafd79758e5ce87cd6bb6139782a03c16bf522de
       now 88c44a64dc0e2e1bc716b479dc71666498738d4b

1:  4cae93f ! 1:  24483b5 Convert UPGRADING-4.2 to POD
    @@ -206,10 +206,13 @@
     +
     +=item *
     +
    -+RT was recording additional time change transactions during merge, so
    -+the time difference in a ticket's history doesn't add up to the value on
    -+the ticket. This has been fixed. Time is adjusted during merge, but now
    -+transactions are not recorded.
    ++On merge, RT retains transactions from both tickets. Previously, RT
    ++also recorded explicit time change transactions during a
    ++merge to adjust the total time spent. This caused the total time
    ++spent, as summed from transactions, to be different from the ticket's
    ++overall time spent. This has been fixed: time is adjusted during the
    ++merge commit itself, removing the need for the confusing
    ++extra transactions, and keeping the summed time spent consistent.
     +
     +In order to fix the history records of old ticket you can run the following
     +command:
    @@ -307,86 +310,83 @@
     -* On Oracle, sessions are now stored in the database by default instead of
     -  on-disk.  If you wish to preserve the original behaviour, ensure the
     -  following is in your RT_SiteConfig.pm:
    --
    --    Set($WebSessionClass, "Apache::Session::File");
    --
    ++=item *
    ++
    ++The Articles menu is now a top-level menu item and display is controlled by
    ++the right C<ShowArticlesMenu>.  This right is only grantable globally to groups
    ++or users.  During the upgrade, the new right will be automatically granted to
    ++Privileged users so that the menu doesn't disappear for anyone previously
    ++using it.  You may wish to revoke the right from Privileged and grant it
    ++more selectively.
    ++
    ++=item *
    ++
    ++The Owner drop-down now only includes privileged users (no matter if
    ++unprivileged users have been granted the OwnTicket right) because
    ++configurations which have unprivileged Owners are exceedingly rare,
    ++and granting Everyone the OwnTicket right is a common cause of
    ++performance problems.  Unprivileged Owners (if they exist) may still
    ++be set using the Autocompleter.
    ++
    ++=item *
    ++
    ++The functionality that changed the ticket status to Open when the Started
    ++date is set has been moved to a Scrip called 'On transaction and SetStarted
    ++Open Ticket'. If you do not depend on this functionality, the Scrip can
    ++be deleted.
    ++
    ++=item *
    ++
    ++New installs will notify Ccs and one-time Ccs/Bccs on create and Owners on
    ++create and correspond.  Upgraded installations will not.  If you'd like to
    ++adjust your scrips, the actions are available from the admin scrip pages.
    ++
    ++=item *
    ++
    ++Notifications to AdminCcs on approvals are now handled via the New Pending
    ++Approval template in the hidden ___Approvals queue.  If you customized the
    ++Transaction template, you should port your changes to New Pending Approval.
    ++
    ++=item *
    ++
    ++On Oracle, sessions are now stored in the database by default instead of
    ++on-disk.  If you wish to preserve the original behavior, ensure that
    ++L<RT_Config/$WebSessionClass> is set in your C<RT_SiteConfig.pm>:
    + 
    +     Set($WebSessionClass, "Apache::Session::File");
    + 
     -* Configuration options dealing with "external authentication" have been
     -  renamed to reduce confusion with the common extension
     -  RT::Authen::ExternalAuth.  The old names will work, but produce
     -  deprecation warnings.  The old names, and their new counterparts, are:
    --
    ++=item *
    ++
    ++Configuration options dealing with "external authentication" have been
    ++renamed to reduce confusion with the common extension
    ++L<RT::Authen::ExternalAuth>.  The old names will work, but produce
    ++deprecation warnings.  The old names, and their new counterparts, are:
    ++
    ++    WebExternalAuth           => WebRemoteUserAuth
    ++    WebExternalAuthContinuous => WebRemoteUserContinuous
    ++    WebFallbackToInternalAuth => WebFallbackToRTLogin
    ++    WebExternalGecos          => WebRemoteUserGecos
    ++    WebExternalAuto           => WebRemoteUserAutocreate
    ++    AutoCreate                => UserAutocreateDefaultsOnLogin
    ++
    ++=item *
    ++
    ++Due to many long-standing bugs and limitations, the "Offline Tool" was
    ++removed.
    + 
     -      WebExternalAuth           => WebRemoteUserAuth
     -      WebExternalAuthContinuous => WebRemoteUserContinuous
     -      WebFallbackToInternalAuth => WebFallbackToRTLogin
     -      WebExternalGecos          => WebRemoteUserGecos
     -      WebExternalAuto           => WebRemoteUserAutocreate
     -      AutoCreate                => UserAutocreateDefaultsOnLogin
    --
    ++=back
    + 
     -* Due to many long-standing bugs and limitations, the "Offline Tool" was
     -  removed.
    -+=item *
    -+
    -+The Articles menu is now a top-level menu item and display is controlled by
    -+the right C<ShowArticlesMenu>.  This right is only grantable globally to groups
    -+or users.  During the upgrade, the new right will be automatically granted to
    -+Privileged users so that the menu doesn't disappear for anyone previously
    -+using it.  You may wish to revoke the right from Privileged and grant it
    -+more selectively.
    -+
    -+=item *
    -+
    -+The Owner drop-down now only includes privileged users (no matter if
    -+unprivileged users have been granted the OwnTicket right) because
    -+configurations which have unprivileged Owners are exceedingly rare,
    -+and granting Everyone the OwnTicket right is a common cause of
    -+performance problems.  Unprivileged Owners (if they exist) may still
    -+be set using the Autocompleter.
    -+
    -+=item *
    -+
    -+The functionality that changed the ticket status to Open when the Started
    -+date is set has been moved to a Scrip called 'On transaction and SetStarted
    -+Open Ticket'. If you do not depend on this functionality, the Scrip can
    -+be deleted.
    -+
    -+=item *
    -+
    -+New installs will notify Ccs and one-time Ccs/Bccs on create and Owners on
    -+create and correspond.  Upgraded installations will not.  If you'd like to
    -+adjust your scrips, the actions are available from the admin scrip pages.
    -+
    -+=item *
    -+
    -+Notifications to AdminCcs on approvals are now handled via the New Pending
    -+Approval template in the hidden ___Approvals queue.  If you customized the
    -+Transaction template, you should port your changes to New Pending Approval.
    -+
    -+=item *
    -+
    -+On Oracle, sessions are now stored in the database by default instead of
    -+on-disk.  If you wish to preserve the original behavior, ensure that
    -+L<RT_Config/$WebSessionClass> is set in your C<RT_SiteConfig.pm>.
    -+
    -+=item *
    -+
    -+Configuration options dealing with "external authentication" have been
    -+renamed to reduce confusion with the common extension
    -+L<RT::Authen::ExternalAuth>.  The old names will work, but produce
    -+deprecation warnings.  The old names, and their new counterparts, are:
    -+
    -+    WebExternalAuth           => WebRemoteUserAuth
    -+    WebExternalAuthContinuous => WebRemoteUserContinuous
    -+    WebFallbackToInternalAuth => WebFallbackToRTLogin
    -+    WebExternalGecos          => WebRemoteUserGecos
    -+    WebExternalAuto           => WebRemoteUserAutocreate
    -+    AutoCreate                => UserAutocreateDefaultsOnLogin
    -+
    -+=item *
    -+
    -+Due to many long-standing bugs and limitations, the "Offline Tool" was
    -+removed.
    -+
    -+=back
    -+
     +=cut
     
2:  aafd797 = 2:  88c44a6 Add intro text to UPGRADING-4.2 doc