WordPress.org
Get WordPress

Make WordPress Core

Changeset 25746


Ignore:
Timestamp:
10/09/2013 08:38:26 PM (11 years ago)
Author:
nacin
Message:

Default themes: Don't use / docblocks for simple multiline comments.

props DrewAPicture, ericlewis.
fixes #25256.

Location:
trunk/src/wp-content/themes
Files:
37 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/wp-content/themes/twentyeleven/author.php

    r25625 r25746  
    1616
    1717                <?php
    18                     /**
     18                    /*
    1919                     * Queue the first post, that way we know what author
    2020                     * we're dealing with (if that is the case).
    … …  
    3131
    3232                <?php
    33                     /**
     33                    /*
    3434                     * Since we called the_post() above, we need to
    3535                     * rewind the loop back to the beginning that way
    … …  
    6868
    6969                    <?php
    70                         /**
     70                        /*
    7171                         * Include the Post-Format-specific template for the content.
    7272                         * If you want to overload this in a child theme then include a file

  • trunk/src/wp-content/themes/twentyeleven/category.php

    r25625 r25746  
    4141
    4242                    <?php
    43                         /**
     43                        /*
    4444                         * Include the Post-Format-specific template for the content.
    4545                         * If you want to overload this in a child theme then include a file

  • trunk/src/wp-content/themes/twentyeleven/comments.php

    r25625 r25746  
    1818    </div><!-- #comments -->
    1919    <?php
    20             /**
     20            /*
    2121             * Stop the rest of comments.php from being processed,
    2222             * but don't kill the script entirely -- we still have
    … …  
    4747        <ol class="commentlist">
    4848            <?php
    49                 /**
     49                /*
    5050                 * Loop through and list the comments. Tell wp_list_comments()
    5151                 * to use twentyeleven_comment() to format the comments.
    … …  
    6767
    6868        <?php
    69         /**
     69        /*
    7070         * If there are no comments and comments are closed, let's leave a little note, shall we?
    7171         * But we only want the note on posts and pages that had comments in the first place.

  • trunk/src/wp-content/themes/twentyeleven/footer.php

    r25625 r25746  
    1616
    1717            <?php
    18                 /**
     18                /*
    1919                 * A sidebar in the footer? Yep. You can can customize
    2020                 * your footer with three columns of widgets.

  • trunk/src/wp-content/themes/twentyeleven/functions.php

    r25625 r25746  
    3939 */
    4040
    41 /**
    42  * Set the content width based on the theme's design and stylesheet.
    43  */
     41// Set the content width based on the theme's design and stylesheet.
    4442if ( ! isset( $content_width ) )
    4543    $content_width = 584;
    4644
    47 /**
     45/*
    4846 * Tell WordPress to run twentyeleven_setup() when the 'after_setup_theme' hook is run.
    4947 */
    … …  
    7371function twentyeleven_setup() {
    7472
    75     /**
     73    /*
    7674     * Make Twenty Eleven available for translation.
    7775     * Translations can be added to the /languages/ directory.
    … …  
    108106    // Add support for custom backgrounds.
    109107    add_theme_support( 'custom-background', array(
    110         /**
     108        /*
    111109         * Let WordPress know what our default background color is.
    112110         * This is dependent on our current color scheme.
    … …  
    163161    }
    164162
    165     /**
     163    /*
    166164     * We'll be using post thumbnails for custom header images on posts and pages.
    167165     * We want them to be the size of the header image that we just defined.
    … …  
    170168    set_post_thumbnail_size( $custom_header_support['width'], $custom_header_support['height'], true );
    171169
    172     /**
     170    /*
    173171     * Add Twenty Eleven's custom image sizes.
    174172     * Used for large feature (header) images.

  • trunk/src/wp-content/themes/twentyeleven/header.php

    r25625 r25746  
    2626<meta name="viewport" content="width=device-width" />
    2727<title><?php
    28     /**
    29      * Print the <title> tag based on what is being viewed.
    30      */
     28    // Print the <title> tag based on what is being viewed.
    3129    global $page, $paged;
    3230
    … …  
    5351<![endif]-->
    5452<?php
    55     /**
     53    /*
    5654     * We add some JavaScript to pages with the comment form
    5755     * to support sites with threaded comments (when in use).
    … …  
    6058        wp_enqueue_script( 'comment-reply' );
    6159
    62     /**
     60    /*
    6361     * Always have wp_head() just before the closing </head>
    6462     * tag of your theme, or you will break many plugins, which
    … …  
    8482                    // Compatibility with versions of WordPress prior to 3.4.
    8583                    if ( function_exists( 'get_custom_header' ) ) {
    86                         /**
     84                        /*
    8785                         * We need to figure out what the minimum width should be for our featured image.
    8886                         * This result would be the suggested width if the theme were to implement flexible widths.
    … …  
    9593            <a href="<?php echo esc_url( home_url( '/' ) ); ?>">
    9694                <?php
    97                     /**
     95                    /*
    9896                     * The header image.
    9997                     * Check if this is a post or page, if it has a thumbnail, and if it's a big one

  • trunk/src/wp-content/themes/twentyeleven/image.php

    r25625 r25746  
    4949                                <div class="attachment">
    5050<?php
    51     /**
     51    /*
    5252     * Grab the IDs of all the image attachments in a gallery so we can get the URL of the next adjacent image in a gallery,
    5353     * or the first image (if we're looking at the last image in a gallery), or, in a gallery of one, just the link to that image file

  • trunk/src/wp-content/themes/twentyeleven/search.php

    r25625 r25746  
    2525
    2626                    <?php
    27                         /**
     27                        /*
    2828                         * Include the Post-Format-specific template for the content.
    2929                         * If you want to overload this in a child theme then include a file

  • trunk/src/wp-content/themes/twentyeleven/showcase.php

    r25625 r25746  
    2727
    2828                <?php
    29                     /**
     29                    /*
    3030                     * We are using a heading by rendering the_content
    3131                     * If we have content for this page, let's display it.
    … …  
    3838
    3939                <?php
    40                     /**
     40                    /*
    4141                     * Begin the featured posts section.
    4242                     *
    … …  
    6262                    if ( $featured->have_posts() ) :
    6363
    64                     /**
     64                    /*
    6565                     * We will need to count featured posts starting from zero
    6666                     * to create the slider navigation.
    … …  
    8585                    $counter_slider++;
    8686
    87                     /**
     87                    /*
    8888                     * We're going to add a class to our featured post for featured images
    8989                     * by default it'll have the feature-text class.
    … …  
    109109
    110110                        <?php
    111                             /**
     111                            /*
    112112                             * If the thumbnail is as big as the header image
    113113                             * make it a large featured post, otherwise render it small

  • trunk/src/wp-content/themes/twentyeleven/sidebar-footer.php

    r25625 r25746  
    1010
    1111<?php
    12     /**
     12    /*
    1313     * The footer widget area is triggered if any of the areas
    1414     * have widgets. So let's check that first.

  • trunk/src/wp-content/themes/twentyeleven/tag.php

    r25625 r25746  
    4141
    4242                    <?php
    43                         /**
     43                        /*
    4444                         * Include the Post-Format-specific template for the content.
    4545                         * If you want to overload this in a child theme then include a file

  • trunk/src/wp-content/themes/twentyten/archive.php

    r25627 r25746  
    1919
    2020<?php
    21     /**
     21    /*
    2222     * Queue the first post, that way we know
    2323     * what date we're dealing with (if that is the case).
    … …  
    4343
    4444<?php
    45     /**
     45    /*
    4646     * Since we called the_post() above, we need to
    4747     * rewind the loop back to the beginning that way
    … …  
    5050    rewind_posts();
    5151
    52     /**
     52    /*
    5353     * Run the loop for the archives page to output the posts.
    5454     * If you want to overload this in a child theme then include a file

  • trunk/src/wp-content/themes/twentyten/attachment.php

    r25627 r25746  
    1414
    1515            <?php
    16             /**
     16            /*
    1717             * Run the loop to output the attachment.
    1818             * If you want to overload this in a child theme then include a file

  • trunk/src/wp-content/themes/twentyten/author.php

    r25627 r25746  
    1414
    1515<?php
    16     /**
     16    /*
    1717     * Queue the first post, that way we know who
    1818     * the author is when we try to get their name,
    … …  
    5252
    5353<?php
    54     /**
     54    /*
    5555     * Since we called the_post() above, we need to
    5656     * rewind the loop back to the beginning that way
    … …  
    5959    rewind_posts();
    6060
    61     /**
     61    /*
    6262     * Run the loop for the author archive page to output the authors posts
    6363     * If you want to overload this in a child theme then include a file

  • trunk/src/wp-content/themes/twentyten/category.php

    r25627 r25746  
    2121                        echo '<div class="archive-meta">' . $category_description . '</div>';
    2222
    23                 /**
     23                /*
    2424                 * Run the loop for the category page to output the posts.
    2525                 * If you want to overload this in a child theme then include a file

  • trunk/src/wp-content/themes/twentyten/comments.php

    r25627 r25746  
    1919            </div><!-- #comments -->
    2020<?php
    21         /**
     21        /*
    2222         * Stop the rest of comments.php from being processed,
    2323         * but don't kill the script entirely -- we still have
    … …  
    4747            <ol class="commentlist">
    4848                <?php
    49                     /**
     49                    /*
    5050                     * Loop through and list the comments. Tell wp_list_comments()
    5151                     * to use twentyten_comment() to format the comments.
    … …  
    6666
    6767    <?php
    68     /**
     68    /*
    6969     * If there are no comments and comments are closed, let's leave a little note, shall we?
    7070     * But we only want the note on posts and pages that had comments in the first place.

  • trunk/src/wp-content/themes/twentyten/footer.php

    r25627 r25746  
    1717
    1818<?php
    19     /**
     19    /*
    2020     * A sidebar in the footer? Yep. You can can customize
    2121     * your footer with four columns of widgets.
    … …  
    4747
    4848<?php
    49     /**
     49    /*
    5050     * Always have wp_footer() just before the closing </body>
    5151     * tag of your theme, or you will break many plugins, which

  • trunk/src/wp-content/themes/twentyten/functions.php

    r25627 r25746  
    3939 */
    4040
    41 /**
     41/*
    4242 * Set the content width based on the theme's design and stylesheet.
    4343 *
    … …  
    4848    $content_width = 640;
    4949
    50 /** Tell WordPress to run twentyten_setup() when the 'after_setup_theme' hook is run. */
     50/* Tell WordPress to run twentyten_setup() when the 'after_setup_theme' hook is run. */
    5151add_action( 'after_setup_theme', 'twentyten_setup' );
    5252
    … …  
    8585    add_theme_support( 'automatic-feed-links' );
    8686
    87     /**
     87    /*
    8888     * Make theme available for translation.
    8989     * Translations can be filed in the /languages/ directory
    … …  
    105105
    106106    $custom_header_support = array(
    107         /**
     107        /*
    108108         * The default image to use.
    109109         * The %s is a placeholder for the theme template directory URI.
    … …  
    148148    }
    149149
    150     /**
     150    /*
    151151     * We'll be using post thumbnails for custom header images on posts and pages.
    152152     * We want them to be 940 pixels wide by 198 pixels tall.

  • trunk/src/wp-content/themes/twentyten/header.php

    r25627 r25746  
    3838<link rel="pingback" href="<?php bloginfo( 'pingback_url' ); ?>" />
    3939<?php
    40     /**
     40    /*
    4141     * We add some JavaScript to pages with the comment form
    4242     * to support sites with threaded comments (when in use).
    … …  
    4545        wp_enqueue_script( 'comment-reply' );
    4646
    47     /**
     47    /*
    4848     * Always have wp_head() just before the closing </head>
    4949     * tag of your theme, or you will break many plugins, which
    … …  
    7171                    // Compatibility with versions of WordPress prior to 3.4.
    7272                    if ( function_exists( 'get_custom_header' ) ) {
    73                         /**
     73                        /*
    7474                         * We need to figure out what the minimum width should be for our featured image.
    7575                         * This result would be the suggested width if the theme were to implement flexible widths.

  • trunk/src/wp-content/themes/twentyten/index.php

    r25627 r25746  
    2020
    2121            <?php
    22             /**
     22            /*
    2323             * Run the loop to output the posts.
    2424             * If you want to overload this in a child theme then include a file

  • trunk/src/wp-content/themes/twentyten/loop.php

    r25627 r25746  
    4040
    4141<?php
    42     /**
     42    /*
    4343     * Start the Loop.
    4444     *

  • trunk/src/wp-content/themes/twentyten/onecolumn-page.php

    r25627 r25746  
    1919
    2020            <?php
    21             /**
     21            /*
    2222             * Run the loop to output the page.
    2323             * If you want to overload this in a child theme then include a file

  • trunk/src/wp-content/themes/twentyten/page.php

    r25627 r25746  
    1919
    2020            <?php
    21             /**
     21            /*
    2222             * Run the loop to output the page.
    2323             * If you want to overload this in a child theme then include a file

  • trunk/src/wp-content/themes/twentyten/search.php

    r25627 r25746  
    1616                <h1 class="page-title"><?php printf( __( 'Search Results for: %s', 'twentyten' ), '<span>' . get_search_query() . '</span>' ); ?></h1>
    1717                <?php
    18                 /**
     18                /*
    1919                 * Run the loop for the search to output the results.
    2020                 * If you want to overload this in a child theme then include a file

  • trunk/src/wp-content/themes/twentyten/sidebar-footer.php

    r25627 r25746  
    1010
    1111<?php
    12     /**
     12    /*
    1313     * The footer widget area is triggered if any of the areas
    1414     * have widgets. So let's check that first.

  • trunk/src/wp-content/themes/twentyten/sidebar.php

    r25627 r25746  
    1313
    1414<?php
    15     /**
     15    /*
    1616     * When we call the dynamic_sidebar() function, it'll spit out
    1717     * the widgets for that widget area. If it instead returns false,

  • trunk/src/wp-content/themes/twentyten/single.php

    r25627 r25746  
    1414
    1515            <?php
    16             /**
     16            /*
    1717             * Run the loop to output the post.
    1818             * If you want to overload this in a child theme then include a file

  • trunk/src/wp-content/themes/twentyten/tag.php

    r25627 r25746  
    1818
    1919<?php
    20 /**
     20/*
    2121 * Run the loop for the tag archive to output the posts
    2222 * If you want to overload this in a child theme then include a file

  • trunk/src/wp-content/themes/twentythirteen/author.php

    r25522 r25746  
    1818
    1919            <?php
    20                 /**
     20                /*
    2121                 * Queue the first post, that way we know what author
    2222                 * we're dealing with (if that is the case).
    … …  
    3333
    3434            <?php
    35                 /**
     35                /*
    3636                 * Since we called the_post() above, we need to
    3737                 * rewind the loop back to the beginning that way

  • trunk/src/wp-content/themes/twentythirteen/comments.php

    r25522 r25746  
    1010 */
    1111
    12 /**
     12/*
    1313 * If the current post is protected by a password and the visitor has not yet
    1414 * entered the password we will return early without loading the comments.

  • trunk/src/wp-content/themes/twentythirteen/functions.php

    r25522 r25746  
    2424 */
    2525
    26 /**
     26/*
    2727 * Set up the content width value based on the theme's design.
    2828 *
    … …  
    6161 */
    6262function twentythirteen_setup() {
    63     /**
     63    /*
    6464     * Makes Twenty Thirteen available for translation.
    6565     *
    … …  
    7171    load_theme_textdomain( 'twentythirteen', get_template_directory() . '/languages' );
    7272
    73     /**
     73    /*
    7474     * This theme styles the visual editor to resemble the theme style,
    7575     * specifically font, colors, icons, and column width.
    … …  
    8080    add_theme_support( 'automatic-feed-links' );
    8181
    82     /**
     82    /*
    8383     * Switches default core markup for search form, comment form,
    8484     * and comments to output valid HTML5.
    … …  
    8686    add_theme_support( 'html5', array( 'search-form', 'comment-form', 'comment-list' ) );
    8787
    88     /**
     88    /*
    8989     * This theme supports all available post formats by default.
    9090     * See http://codex.wordpress.org/Post_Formats
    … …  
    9797    register_nav_menu( 'primary', __( 'Navigation Menu', 'twentythirteen' ) );
    9898
    99     /**
     99    /*
    100100     * This theme uses a custom image size for featured images, displayed on
    101101     * "standard" posts and pages.
    … …  
    122122    $fonts_url = '';
    123123
    124     /**
     124    /*
    125125     * Translators: If there are characters in your language that are not
    126126     * supported by Source Sans Pro, translate this to 'off'. Do not translate
    … …  
    129129    $source_sans_pro = _x( 'on', 'Source Sans Pro font: on or off', 'twentythirteen' );
    130130
    131     /**
     131    /*
    132132     * Translators: If there are characters in your language that are not
    133133     * supported by Bitter, translate this to 'off'. Do not translate into your
    … …  
    163163 */
    164164function twentythirteen_scripts_styles() {
    165     /**
     165    /*
    166166     * Adds JavaScript to pages with the comment form to support
    167167     * sites with threaded comments (when in use).
    … …  
    414414    $post                = get_post();
    415415
    416     /**
     416    /*
    417417     * Grab the IDs of all the image attachments in a gallery so we can get the URL
    418418     * of the next adjacent image in a gallery, or the first image (if we're

  • trunk/src/wp-content/themes/twentythirteen/inc/custom-header.php

    r25522 r25746  
    4141    add_theme_support( 'custom-header', $args );
    4242
    43     /**
     43    /*
    4444     * Default custom headers packaged with the theme.
    4545     * %s is a placeholder for the theme template directory URI.

  • trunk/src/wp-content/themes/twentytwelve/comments.php

    r25521 r25746  
    1313 */
    1414
    15 /**
     15/*
    1616 * If the current post is protected by a password and
    1717 * the visitor has not yet entered the password we will

  • trunk/src/wp-content/themes/twentytwelve/functions.php

    r25521 r25746  
    2323 */
    2424
    25 /**
    26  * Set up the content width value based on the theme's design and stylesheet.
    27  */
     25// Set up the content width value based on the theme's design and stylesheet.
    2826if ( ! isset( $content_width ) )
    2927    $content_width = 625;
    … …  
    4543 */
    4644function twentytwelve_setup() {
    47     /**
     45    /*
    4846     * Makes Twenty Twelve available for translation.
    4947     *
    … …  
    6664    register_nav_menu( 'primary', __( 'Primary Menu', 'twentytwelve' ) );
    6765
    68     /**
     66    /*
    6967     * This theme supports custom background color and image,
    7068     * and here we also set up the default background color.
    … …  
    9896    $font_url = '';
    9997
    100     /**
     98    /*
    10199     * translators: If there are characters in your language that are not supported
    102100     * by Open Sans, translate this to 'off'. Do not translate into your own language.
    … …  
    105103        $subsets = 'latin,latin-ext';
    106104
    107         /**
     105        /*
    108106         * translators: To add an additional Open Sans character subset specific to your language,
    109107         * translate this to 'greek', 'cyrillic' or 'vietnamese'. Do not translate into your own language.
    … …  
    139137    global $wp_styles;
    140138
    141     /**
     139    /*
    142140     * Adds JavaScript to pages with the comment form to support
    143141     * sites with threaded comments (when in use).
    … …  
    146144        wp_enqueue_script( 'comment-reply' );
    147145
    148     /**
    149      * Adds JavaScript for handling the navigation menu hide-and-show behavior.
    150      */
     146    // Adds JavaScript for handling the navigation menu hide-and-show behavior.
    151147    wp_enqueue_script( 'twentytwelve-navigation', get_template_directory_uri() . '/js/navigation.js', array(), '1.0', true );
    152148
    … …  
    155151        wp_enqueue_style( 'twentytwelve-fonts', esc_url_raw( $font_url ), array(), null );
    156152
    157     /**
    158      * Loads our main stylesheet.
    159      */
     153    // Loads our main stylesheet.
    160154    wp_enqueue_style( 'twentytwelve-style', get_stylesheet_uri() );
    161155
    162     /**
    163      * Loads the Internet Explorer specific stylesheet.
    164      */
     156    // Loads the Internet Explorer specific stylesheet.
    165157    wp_enqueue_style( 'twentytwelve-ie', get_template_directory_uri() . '/css/ie.css', array( 'twentytwelve-style' ), '20121010' );
    166158    $wp_styles->add_data( 'twentytwelve-ie', 'conditional', 'lt IE 9' );

  • trunk/src/wp-content/themes/twentytwelve/image.php

    r25521 r25746  
    4949                            <div class="attachment">
    5050<?php
    51 /**
     51/*
    5252 * Grab the IDs of all the image attachments in a gallery so we can get the URL of the next adjacent image in a gallery,
    5353 * or the first image (if we're looking at the last image in a gallery), or, in a gallery of one, just the link to that image file

  • trunk/src/wp-content/themes/twentytwelve/sidebar-front.php

    r25521 r25746  
    1010 */
    1111
    12 /**
     12/*
    1313 * The front page widget area is triggered if any of the areas
    1414 * have widgets. So let's check that first.

  • trunk/src/wp-content/themes/twentytwelve/tag.php

    r25521 r25746  
    3030            while ( have_posts() ) : the_post();
    3131
    32                 /**
     32                /*
    3333                 * Include the post format-specific template for the content. If you want to
    3434                 * this in a child theme then include a file called called content-___.php
Note: See TracChangeset for help on using the changeset viewer.