Bug 472452: Rephrase documentation about deleting custom fields

r=glob

diff --git a/docs/en/xml/administration.xml b/docs/en/xml/administration.xml
index 8aa2935695b98deaa0f3a748bdf38e064e8d0c81..e3833bc68124ab5d395b5160ebdde4f402655508 100644 (file)
--- a/docs/en/xml/administration.xml
+++ b/docs/en/xml/administration.xml
@@ -2492,10 +2492,13 @@ ReadOnly: ENTRY, NA/NA, CANEDIT
       <title>Deleting Custom Fields</title>
 
       <para>
-        It is only possible to delete obsolete Custom Fields 
-        if the field has never been used in the database.
-        To remove a field which already has content,
-        mark it as obsolete.
+        Only custom fields which are marked as obsolete, and which never
+        have been used, can be deleted completely (else the integrity
+        of the bug history would be compromised). For custom fields marked
+        as obsolete, a "Delete" link will appear in the <quote>Action</quote>
+        column. If the custom field has been used in the past, the deletion
+        will be rejected. But marking the field as obsolete is sufficient
+        to hide it from the user interface entirely.
       </para>
     </section>
   </section>