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

Timestamp:

01/29/2020 12:33:45 AM (6 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() ) {