Merge "Improve documentation for $wgRecentChangesFlags"

diff --combined includes/DefaultSettings.php
index 86b0849,9264610..f8e67f5
--- 1/includes/DefaultSettings.php
--- 2/includes/DefaultSettings.php
+++ b/includes/DefaultSettings.php
@@@ -3516,13 -3516,12 +3516,13 @@@ $wgExpensiveParserFunctionLimit = 100
  $wgPreprocessorCacheThreshold = 1000;
  
  /**
 - * Enable interwiki transcluding.  Only when iw_trans=1.
 + * Enable interwiki transcluding.  Only when iw_trans=1 in the interwiki table.
   */
  $wgEnableScaryTranscluding = false;
  
  /**
 - * (see next option $wgGlobalDatabase).
 + * Expiry time for transcluded templates cached in transcache database table.
 + * Only used $wgEnableInterwikiTranscluding is set to true.
   */
  $wgTranscludeCacheExpiry = 3600;
  
@@@ -5225,11 -5224,18 +5225,18 @@@ $wgUseTagFilter = true
  $wgUnwatchedPageThreshold = false;
  
  /**
-  * Recent changes flag, shown in Recentchanges and watchlist
+  * Flags (letter symbols) shown in recent changes and watchlist to indicate
+  * certain types of edits.
   *
-  * Adding a new one:
-  *   $wgRecentChangesFlags['flag'] => array( 'letter-msg', 'tooltip-msg' );
-  * 'class' allows to set a css class different than the flag name
+  * To register a new one:
+  * @code
+  * $wgRecentChangesFlags['flag'] => array(
+  *   'letter' => 'letter-msg',
+  *   'title' => 'tooltip-msg'
+  * );
+  * @endcode
+  *
+  * Optional 'class' allows to set a css class different than the flag name.
   *
   * @since 1.22
   */