From b716b2e971d5678ebda98fc820202981ce0f5924 Mon Sep 17 00:00:00 2001
From: Aryeh Gregor <simetrical@users.mediawiki.org>
Date: Sun, 23 Aug 2009 20:09:59 +0000
Subject: [PATCH] Reformat comment

<3 vim Ctrl-V
---
 includes/Preferences.php | 45 +++++++++++++++++++++-------------------
 1 file changed, 24 insertions(+), 21 deletions(-)

diff --git a/includes/Preferences.php b/includes/Preferences.php
index 9553a401ae..92a91419a0 100644
--- a/includes/Preferences.php
+++ b/includes/Preferences.php
@@ -1,27 +1,30 @@
 <?php
 
 /**
- General information about this file:
-  We're now using the HTMLForm object with some customisation to generate the Preferences
-   form. This object handles generic submission, CSRF protection, layout and other logic
-   in a reusable manner. We subclass it as a PreferencesForm to make some minor
-   customisations.
-  In order to generate the form, the HTMLForm object needs an array structure detailing the
-   form fields available, and that's what this class is for. Each element of the array is
-   a basic property-list, including the type of field, the label it is to be given in the
-   form, callbacks for validation and 'filtering', and other pertinent information. Note that
-   the 'default' field is named for generic forms, and does not represent the preference's
-   default (which is stored in $wgDefaultUserOptions), but the default for the form field,
-   which should be whatever the user has set for that preference. There is no need to
-   override it unless you have some special storage logic (for instance, those not presently
-   stored as options, but which are best set from the user preferences view).
-  Field types are implemented as subclasses of the generic HTMLFormField object, and
-   typically implement at least getInputHTML, which generates the HTML for the input field
-   to be placed in the table. 
-  Once fields have been retrieved and validated, submission logic is handed over to the
-   tryUISubmit static method of this class.
-  */
-
+ * We're now using the HTMLForm object with some customisation to generate the
+ * Preferences form. This object handles generic submission, CSRF protection,
+ * layout and other logic in a reusable manner. We subclass it as a PreferencesForm
+ * to make some minor customisations.
+ *
+ * In order to generate the form, the HTMLForm object needs an array structure
+ * detailing the form fields available, and that's what this class is for. Each
+ * element of the array is a basic property-list, including the type of field,
+ * the label it is to be given in the form, callbacks for validation and
+ * 'filtering', and other pertinent information. Note that the 'default' field
+ * is named for generic forms, and does not represent the preference's default
+ * (which is stored in $wgDefaultUserOptions), but the default for the form
+ * field, which should be whatever the user has set for that preference. There
+ * is no need to override it unless you have some special storage logic (for
+ * instance, those not presently stored as options, but which are best set from
+ * the user preferences view).
+ *
+ * Field types are implemented as subclasses of the generic HTMLFormField
+ * object, and typically implement at least getInputHTML, which generates the
+ * HTML for the input field to be placed in the table.
+ *
+ * Once fields have been retrieved and validated, submission logic is handed
+ * over to the tryUISubmit static method of this class.
+ */
 class Preferences {
 	static $defaultPreferences = null;
 	static $saveFilters =
-- 
2.20.1