From 139fe26f1f436a945d91f27ddf5f7c07b2af5756 Mon Sep 17 00:00:00 2001
From: Sergey Biryukov <sergeybiryukov@git.wordpress.org>
Date: Sun, 2 Feb 2020 02:40:50 +0000
Subject: [PATCH] Docs: Improve inline comments in `wp-admin/options.php` per
 the documentation standards.

See #48303.

git-svn-id: https://develop.svn.wordpress.org/trunk@47159 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-admin/options.php | 14 +++++---------
 1 file changed, 5 insertions(+), 9 deletions(-)

diff --git a/src/wp-admin/options.php b/src/wp-admin/options.php
index 2d7eddd632..2961208898 100644
--- a/src/wp-admin/options.php
+++ b/src/wp-admin/options.php
@@ -204,10 +204,7 @@ if ( ! is_multisite() ) {
  */
 $whitelist_options = apply_filters( 'whitelist_options', $whitelist_options );
 
-/*
- * If $_GET['action'] == 'update' we are saving settings sent from a settings page
- */
-if ( 'update' == $action ) {
+if ( 'update' == $action ) { // We are saving settings sent from a settings page.
 	if ( 'options' == $option_page && ! isset( $_POST['option_page'] ) ) { // This is for back compat and will eventually be removed.
 		$unregistered = true;
 		check_admin_referer( 'update-options' );
@@ -303,18 +300,17 @@ if ( 'update' == $action ) {
 		}
 	}
 
-	/**
-	 * Handle settings errors and return to options page
+	/*
+	 * Handle settings errors and return to options page.
 	 */
+
 	// If no settings errors were registered add a general 'updated' message.
 	if ( ! count( get_settings_errors() ) ) {
 		add_settings_error( 'general', 'settings_updated', __( 'Settings saved.' ), 'success' );
 	}
 	set_transient( 'settings_errors', get_settings_errors(), 30 );
 
-	/**
-	 * Redirect back to the settings page that was submitted
-	 */
+	// Redirect back to the settings page that was submitted.
 	$goback = add_query_arg( 'settings-updated', 'true', wp_get_referer() );
 	wp_redirect( $goback );
 	exit;