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 ac44179b03ad79b21cf9b1605fe0dae1c072d6fb..c98c26c95872fa04d9434afec1c8652df469d78c 100644 (file)
--- a/docs/en/xml/administration.xml
+++ b/docs/en/xml/administration.xml
@@ -2527,10 +2527,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>