[Rt-commit] rt branch, 4.2/customfieldgroupings-doc-warnings, created. rt-4.1.6-242-g823dbef

[Kevin Falcone]

The branch, 4.2/customfieldgroupings-doc-warnings has been created
        at  823dbefe5f2f7ca9fffb7211c3d0f4a5d41dfe2b (commit)

- Log -----------------------------------------------------------------
commit 823dbefe5f2f7ca9fffb7211c3d0f4a5d41dfe2b
Author: Kevin Falcone <falcone at bestpractical.com>
Date:   Wed Feb 13 19:59:07 2013 -0500

    Explicitly call out a few limits in what you can rearrange.
    
    These are things I can see someone thinking they can do, so we should be
    explicit and have a pointer to point to when it doesn't work.

diff --git a/etc/RT_Config.pm.in b/etc/RT_Config.pm.in
index 42a812d..906ef3f 100755
--- a/etc/RT_Config.pm.in
+++ b/etc/RT_Config.pm.in
@@ -848,8 +848,12 @@ Set(@CustomFieldValuesSources, ());
 
 =item C<%CustomFieldGroupings>
 
-This option affects the display of ticket and user custom fields in the web
-interface.  A nested datastructure defines how to group together custom fields
+This option affects the display of ticket and user custom fields in the
+web interface. It does not address the sorting of custom fields. The
+order that custom fields are rendered is controlled by the Ticket
+Custom Fields tab in Queue Configuration in the Admin UI.
+
+A nested datastructure defines how to group together custom fields
 under a mix of built-in and arbitrary headings ("groupings").
 
 Set C<%CustomFieldGroupings> to a nested hash similar to the following:
@@ -870,7 +874,9 @@ are hashrefs.  The second level keys are the grouping names and the values are
 array refs containing a list of CF names.
 
 There are several special built-in groupings which RT displays in specific
-places (usually the collapsible box of the same title).
+places (usually the collapsible box of the same title). You may only
+append Custom Fields to the list in these boxes, not reorder or remove
+core fields.
 
 For C<RT::Ticket>, these groupings are: C<Basics>, C<Dates>, C<Links>, C<People>
 

-----------------------------------------------------------------------