Changeset 47119 for trunk/src/wp-admin/includes/network.php

Timestamp:

01/29/2020 12:33:45 AM (7 years ago)

Author:

SergeyBiryukov

Message:

Docs: Improve comments in some wp-admin files per the documentation standards.

Follow-up to [47084].

Props passoniate, apedog.
Fixes #49223, #49227.

File:

• trunk/src/wp-admin/includes/network.php (modified) (7 diffs)

trunk/src/wp-admin/includes/network.php

@@ -182 +182 @@
         if ( isset( $_POST['subdomain_install'] ) ) {
                 $subdomain_install = (bool) $_POST['subdomain_install'];
-        } elseif ( apache_mod_loaded( 'mod_rewrite' ) ) { // assume nothing
+        } elseif ( apache_mod_loaded( 'mod_rewrite' ) ) { // Assume nothing.
                 $subdomain_install = true;
         } elseif ( ! allow_subdirectory_install() ) {
@@ -189 +189 @@
                 $subdomain_install = false;
                 $got_mod_rewrite   = got_mod_rewrite();
-                if ( $got_mod_rewrite ) { // dangerous assumptions
+                if ( $got_mod_rewrite ) { // Dangerous assumptions.
                         echo '<div class="updated inline"><p><strong>' . __( 'Note:' ) . '</strong> ';
                         printf(
@@ -207 +207 @@
                 }
 
-                if ( $got_mod_rewrite || $is_apache ) { // Protect against mod_rewrite mimicry (but ! Apache)
+                if ( $got_mod_rewrite || $is_apache ) { // Protect against mod_rewrite mimicry (but ! Apache).
                         echo '<p>';
                         printf(
@@ -226 +226 @@
                         <strong><?php _e( 'You cannot change this later.' ); ?></strong></p>
                 <p><?php _e( 'You will need a wildcard DNS record if you are going to use the virtual host (sub-domain) functionality.' ); ?></p>
-                <?php // @todo: Link to an MS readme? ?>
+                <?php // @todo Link to an MS readme? ?>
                 <table class="form-table" role="presentation">
                         <tr>
@@ -548 +548 @@
         <?php
         if ( iis7_supports_permalinks() ) :
-                // IIS doesn't support RewriteBase, all your RewriteBase are belong to us
+                // IIS doesn't support RewriteBase, all your RewriteBase are belong to us.
                 $iis_subdir_match       = ltrim( $base, '/' ) . $subdir_match;
                 $iis_rewrite_base       = ltrim( $base, '/' ) . $rewrite_base;
@@ -617 +617 @@
 
                 <?php
-        else : // end iis7_supports_permalinks(). construct an htaccess file instead:
+        else : // End iis7_supports_permalinks(). Construct an .htaccess file instead:
 
                 $ms_files_rewriting = '';
@@ -659 +659 @@
 
                 <?php
-        endif; // end IIS/Apache code branches.
+        endif; // End IIS/Apache code branches.
 
         if ( ! is_multisite() ) {