Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Ditch all @since DocBlocks from theme. #182

Merged
merged 1 commit into from
Mar 18, 2013
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion 404.php
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,6 @@
* The template for displaying 404 pages (Not Found).
*
* @package _s
* @since _s 1.0
*/

get_header(); ?>
Expand Down
1 change: 0 additions & 1 deletion archive.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,6 @@
* Learn more: http://codex.wordpress.org/Template_Hierarchy
*
* @package _s
* @since _s 1.0
*/

get_header(); ?>
Expand Down
1 change: 0 additions & 1 deletion comments.php
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,6 @@
* located in the inc/template-tags.php file.
*
* @package _s
* @since _s 1.0
*/
?>

Expand Down
1 change: 0 additions & 1 deletion content-page.php
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,6 @@
* The template used for displaying page content in page.php
*
* @package _s
* @since _s 1.0
*/
?>

Expand Down
1 change: 0 additions & 1 deletion content-single.php
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
<?php
/**
* @package _s
* @since _s 1.0
*/
?>

Expand Down
1 change: 0 additions & 1 deletion content.php
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
<?php
/**
* @package _s
* @since _s 1.0
*/
?>

Expand Down
1 change: 0 additions & 1 deletion footer.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,6 @@
* Contains the closing of the id=main div and all content after
*
* @package _s
* @since _s 1.0
*/
?>

Expand Down
7 changes: 0 additions & 7 deletions functions.php
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,10 @@
* _s functions and definitions
*
* @package _s
* @since _s 1.0
*/

/**
* Set the content width based on the theme's design and stylesheet.
*
* @since _s 1.0
*/
if ( ! isset( $content_width ) )
$content_width = 640; /* pixels */
Expand All @@ -26,8 +23,6 @@
* Note that this function is hooked into the after_setup_theme hook, which runs
* before the init hook. The init hook is too late for some features, such as indicating
* support post thumbnails.
*
* @since _s 1.0
*/
function _s_setup() {

Expand Down Expand Up @@ -117,8 +112,6 @@ function _s_register_custom_background() {

/**
* Register widgetized area and update sidebar with default widgets
*
* @since _s 1.0
*/
function _s_widgets_init() {
register_sidebar( array(
Expand Down
1 change: 0 additions & 1 deletion header.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,6 @@
* Displays all of the <head> section and everything up till <div id="main">
*
* @package _s
* @since _s 1.0
*/
?><!DOCTYPE html>
<html <?php language_attributes(); ?>>
Expand Down
1 change: 0 additions & 1 deletion image.php
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,6 @@
* The template for displaying image attachments.
*
* @package _s
* @since _s 1.0
*/

get_header();
Expand Down
8 changes: 0 additions & 8 deletions inc/custom-header.php
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,6 @@

*
* @package _s
* @since _s 1.0
*/

/**
Expand Down Expand Up @@ -72,7 +71,6 @@ function _s_custom_header_setup() {
* @return stdClass All properties represent attributes of the curent header image.
*
* @package _s
* @since _s 1.1
*/

if ( ! function_exists( 'get_custom_header' ) ) {
Expand All @@ -91,8 +89,6 @@ function get_custom_header() {
* Styles the header image and text displayed on the blog
*
* @see _s_custom_header_setup().
*
* @since _s 1.0
*/
function _s_header_style() {

Expand Down Expand Up @@ -132,8 +128,6 @@ function _s_header_style() {
* Styles the header image displayed on the Appearance > Header admin panel.
*
* @see _s_custom_header_setup().
*
* @since _s 1.0
*/
function _s_admin_header_style() {
?>
Expand Down Expand Up @@ -162,8 +156,6 @@ function _s_admin_header_style() {
* Custom header image markup displayed on the Appearance > Header admin panel.
*
* @see _s_custom_header_setup().
*
* @since _s 1.0
*/
function _s_admin_header_image() { ?>
<div id="headimg">
Expand Down
5 changes: 0 additions & 5 deletions inc/customizer.php
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,12 @@
* _s Theme Customizer
*
* @package _s
* @since _s 1.2
*/

/**
* Add postMessage support for site title and description for the Theme Customizer.
*
* @param WP_Customize_Manager $wp_customize Theme Customizer object.
*
* @since _s 1.2
*/
function _s_customize_register( $wp_customize ) {
$wp_customize->get_setting( 'blogname' )->transport = 'postMessage';
Expand All @@ -22,8 +19,6 @@ function _s_customize_register( $wp_customize ) {

/**
* Binds JS handlers to make Theme Customizer preview reload changes asynchronously.
*
* @since _s 1.2
*/
function _s_customize_preview_js() {
wp_enqueue_script( '_s_customizer', get_template_directory_uri() . '/js/customizer.js', array( 'customize-preview' ), '20130304', true );
Expand Down
9 changes: 0 additions & 9 deletions inc/extras.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,13 +5,10 @@
* Eventually, some of the functionality here could be replaced by core features
*
* @package _s
* @since _s 1.0
*/

/**
* Get our wp_nav_menu() fallback, wp_page_menu(), to show a home link.
*
* @since _s 1.0
*/
function _s_page_menu_args( $args ) {
$args['show_home'] = true;
Expand All @@ -21,8 +18,6 @@ function _s_page_menu_args( $args ) {

/**
* Adds custom classes to the array of body classes.
*
* @since _s 1.0
*/
function _s_body_classes( $classes ) {
// Adds a class of group-blog to blogs with more than 1 published author
Expand All @@ -36,8 +31,6 @@ function _s_body_classes( $classes ) {

/**
* Filter in a link to a content ID attribute for the next/previous image links on image attachment pages
*
* @since _s 1.0
*/
function _s_enhanced_image_navigation( $url, $id ) {
if ( ! is_attachment() && ! wp_attachment_is_image( $id ) )
Expand All @@ -53,8 +46,6 @@ function _s_enhanced_image_navigation( $url, $id ) {

/**
* Filters wp_title to print a neat <title> tag based on what is being viewed.
*
* @since _s 1.1
*/
function _s_wp_title( $title, $sep ) {
global $page, $paged;
Expand Down
11 changes: 0 additions & 11 deletions inc/template-tags.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,14 +5,11 @@
* Eventually, some of the functionality here could be replaced by core features
*
* @package _s
* @since _s 1.0
*/

if ( ! function_exists( '_s_content_nav' ) ) :
/**
* Display navigation to next/previous pages when applicable
*
* @since _s 1.0
*/
function _s_content_nav( $nav_id ) {
global $wp_query, $post;
Expand Down Expand Up @@ -63,8 +60,6 @@ function _s_content_nav( $nav_id ) {
* Template for comments and pingbacks.
*
* Used as a callback by wp_list_comments() for displaying the comments.
*
* @since _s 1.0
*/
function _s_comment( $comment, $args, $depth ) {
$GLOBALS['comment'] = $comment;
Expand Down Expand Up @@ -114,8 +109,6 @@ function _s_comment( $comment, $args, $depth ) {
if ( ! function_exists( '_s_posted_on' ) ) :
/**
* Prints HTML with meta information for the current post-date/time and author.
*
* @since _s 1.0
*/
function _s_posted_on() {
printf( __( 'Posted on <a href="%1$s" title="%2$s" rel="bookmark"><time class="entry-date" datetime="%3$s">%4$s</time></a><span class="byline"> by <span class="author vcard"><a class="url fn n" href="%5$s" title="%6$s" rel="author">%7$s</a></span></span>', '_s' ),
Expand All @@ -131,8 +124,6 @@ function _s_posted_on() {
endif;
/**
* Returns true if a blog has more than 1 category
*
* @since _s 1.0
*/
function _s_categorized_blog() {
if ( false === ( $all_the_cool_cats = get_transient( 'all_the_cool_cats' ) ) ) {
Expand All @@ -158,8 +149,6 @@ function _s_categorized_blog() {

/**
* Flush out the transients used in _s_categorized_blog
*
* @since _s 1.0
*/
function _s_category_transient_flusher() {
// Like, beat it. Dig?
Expand Down
2 changes: 0 additions & 2 deletions inc/wpcom.php
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,6 @@
* WordPress.com-specific functions and definitions
*
* @package _s
* @since _s 1.0
*/

global $themecolors;
Expand All @@ -12,7 +11,6 @@
* Set a default theme color array for WP.com.
*
* @global array $themecolors
* @since _s 1.0
*/
$themecolors = array(
'bg' => '',
Expand Down
1 change: 0 additions & 1 deletion index.php
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,6 @@
* Learn more: http://codex.wordpress.org/Template_Hierarchy
*
* @package _s
* @since _s 1.0
*/

get_header(); ?>
Expand Down
1 change: 0 additions & 1 deletion no-results.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,6 @@
* Learn more: http://codex.wordpress.org/Template_Hierarchy
*
* @package _s
* @since _s 1.0
*/
?>

Expand Down
1 change: 0 additions & 1 deletion page.php
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,6 @@
* different template.
*
* @package _s
* @since _s 1.0
*/

get_header(); ?>
Expand Down
1 change: 0 additions & 1 deletion search.php
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,6 @@
* The template for displaying Search Results pages.
*
* @package _s
* @since _s 1.0
*/

get_header(); ?>
Expand Down
1 change: 0 additions & 1 deletion searchform.php
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,6 @@
* The template for displaying search forms in _s
*
* @package _s
* @since _s 1.0
*/
?>
<form method="get" id="searchform" class="searchform" action="<?php echo esc_url( home_url( '/' ) ); ?>" role="search">
Expand Down
1 change: 0 additions & 1 deletion sidebar.php
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,6 @@
* The Sidebar containing the main widget areas.
*
* @package _s
* @since _s 1.0
*/
?>
<div id="secondary" class="widget-area" role="complementary">
Expand Down
1 change: 0 additions & 1 deletion single.php
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,6 @@
* The Template for displaying all single posts.
*
* @package _s
* @since _s 1.0
*/

get_header(); ?>
Expand Down