CRM-20816 - CiviCase `Settings.xml` - Add deprecation notices

diff --git a/CRM/Case/xml/configuration.sample/Settings.xml b/CRM/Case/xml/configuration.sample/Settings.xml
index 58dbb7cff9834872868644d146fe35ba92de5464..8a89315a5bdd1c970eee9a4e640655ed337d0689 100644 (file)
--- a/CRM/Case/xml/configuration.sample/Settings.xml
+++ b/CRM/Case/xml/configuration.sample/Settings.xml
@@ -1,16 +1,30 @@
 <?xml version="1.0" encoding="UTF-8"?>\r
 <Settings>\r
+  <!--\r
+  DEPRECATED\r
+\r
+  The settings in this document should be migrated to the conventional settings framework, which allows\r
+  a greater variety of configuration-management practices (e.g. web-based config, API access, file overrides).\r
+  -->\r
+\r
   <!-- List the group whose members should appear as contacts on all Manage Case screens.\r
      Only one group name is supported for now.\r
      It needs to match the name column in the civicrm_group table (not the title), so avoid using space characters. -->\r
   <group name="Case_Resources" />\r
+\r
   <!-- Set this to 1 if you want case activity emails to be redacted -->\r
-        <RedactActivityEmail>0</RedactActivityEmail>\r
+  <!-- SEE ALSO: Setting "civicaseRedactActivityEmail" -->\r
+  <RedactActivityEmail>0</RedactActivityEmail>\r
+\r
   <!-- Set this to 1 if you want to allow multiple clients to be associated with a single case -->\r
+  <!-- SEE ALSO: Setting "civicaseAllowMultipleCaseClients" -->\r
   <AllowMultipleCaseClients>0</AllowMultipleCaseClients>\r
+\r
   <!-- Set this to 1 if you want to have activity types on Manage Case\r
   screen sorted in XML file order, default is alphabetical -->\r
+  <!-- SEE ALSO: Setting "civicaseNaturalActivityTypeSort" -->\r
   <NaturalActivityTypeSort>0</NaturalActivityTypeSort>\r
+\r
   <!-- Add activity types which should NOT be editable here with editable = 0 -->\r
   <ActivityTypes>\r
     <ActivityType>\r