Changeset 47122 for trunk/src/wp-admin/menu.php

Timestamp:

01/29/2020 12:43:23 AM (5 years ago)

Author:

SergeyBiryukov

Message:

Docs: Improve inline comments per the documentation standards.

Includes minor code layout fixes for better readability.

See #48303.

File:

• trunk/src/wp-admin/menu.php (modified) (6 diffs)

trunk/src/wp-admin/menu.php

@@ -61 +61 @@
 $menu[4] = array( '', 'read', 'separator1', '', 'wp-menu-separator' );
 
-// $menu[5] = Posts
+// $menu[5] = Posts.
 
 $menu[10]                     = array( __( 'Media' ), 'upload_files', 'upload.php', '', 'menu-top menu-icon-media', 'menu-media', 'dashicons-admin-media' );
@@ -83 +83 @@
     $submenu['link-manager.php'][15] = array( __( 'Link Categories' ), 'manage_categories', 'edit-tags.php?taxonomy=link_category' );
 
-// $menu[20] = Pages
+// $menu[20] = Pages.
 
 // Avoid the comment count query for users who cannot edit_posts.
@@ -108 +108 @@
 $submenu['edit-comments.php'][0] = array( __( 'All Comments' ), 'edit_posts', 'edit-comments.php' );
 
-$_wp_last_object_menu = 25; // The index of the last top-level menu in the object menu group
+$_wp_last_object_menu = 25; // The index of the last top-level menu in the object menu group.
 
 $types   = (array) get_post_types(
@@ -140 +140 @@
 
     $menu_class = 'menu-top menu-icon-' . $ptype_for_id;
-    // 'post' special case
+    // 'post' special case.
     if ( 'post' === $ptype ) {
         $menu_class    .= ' open-if-no-js';
@@ -220 +220 @@
  */
 function _add_themes_utility_last() {
-    // Must use API on the admin_menu hook, direct modification is only possible on/before the _admin_menu hook
+    // Must use API on the admin_menu hook, direct modification is only possible on/before the _admin_menu hook.
     add_submenu_page( 'themes.php', __( 'Theme Editor' ), __( 'Theme Editor' ), 'edit_themes', 'theme-editor.php' );
 }
@@ -298 +298 @@
     $submenu['options-general.php'][45] = array( __( 'Privacy' ), 'manage_privacy_options', 'options-privacy.php' );
 
-$_wp_last_utility_menu = 80; // The index of the last top-level menu in the utility menu group
+$_wp_last_utility_menu = 80; // The index of the last top-level menu in the utility menu group.
 
 $menu[99] = array( '', 'read', 'separator-last', '', 'wp-menu-separator' );
 
-// Back-compat for old top-levels
+// Back-compat for old top-levels.
 $_wp_real_parent_file['post.php']       = 'edit.php';
 $_wp_real_parent_file['post-new.php']   = 'edit.php';