Ticket #25229: options.patch

options.php

@@ -29 +29 @@
 if ( empty($option_page) ) // This is for back compat and will eventually be removed.
         $option_page = 'options';
 else
+
+        /** 
+         * Filter the capability required when using the Settings API. 
+         * 
+         * By default, the options groups for all registered settings require the manage_options capability. 
+         * This filter is required to change the capability required for a certain options page. 
+         * 
+         * @since 3.2.0
+         * 
+         * @param string $capability The capability used for the page, which is manage_options by default. 
+         */
         $capability = apply_filters( "option_page_capability_{$option_page}", $capability );
 
 if ( !current_user_can( $capability ) )
@@ -95 +106 @@
 } else {
         $whitelist_options['general'][] = 'new_admin_email';
         $whitelist_options['general'][] = 'WPLANG';
-
+        
+        /**
+         * Toggle post-by-email functionality.
+         *
+         * @since 3.0.0
+         *
+         * @param bool True or false, based on whether post-by-email configuration is enabled or not.
+         */
         if ( apply_filters( 'enable_post_by_email_configuration', true ) )
                 $whitelist_options['writing'] = array_merge($whitelist_options['writing'], $mail_options);
 }
 
+/**
+ * Filter the options white list. 
+ * 
+ * @since 2.7.0
+ *
+ * @param array White list options.
+ */
 $whitelist_options = apply_filters( 'whitelist_options', $whitelist_options );
 
 /*