From e2be10ec2ca15cd9b104a855ce05e0879264b44c Mon Sep 17 00:00:00 2001 From: Drew Jaynes Date: Sat, 19 Dec 2015 08:47:12 +0000 Subject: [PATCH] Docs: Add missing parameter and return notations in the DocBlock for the deprecated `_nc()` function. See #32246. git-svn-id: https://develop.svn.wordpress.org/trunk@36024 602fd350-edb4-49c9-b593-d223f7449a82 --- src/wp-includes/deprecated.php | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/src/wp-includes/deprecated.php b/src/wp-includes/deprecated.php index 2b8e98fb9c..54d9e0ec30 100644 --- a/src/wp-includes/deprecated.php +++ b/src/wp-includes/deprecated.php @@ -1757,12 +1757,20 @@ function translate_with_context( $text, $domain = 'default' ) { } /** - * A version of _n(), which supports contexts. + * Legacy version of _n(), which supports contexts. + * * Strips everything from the translation after the last bar. * * @since 2.7.0 * @deprecated 3.0.0 Use _nx() * @see _nx() + * + * @param string $single The text to be used if the number is singular. + * @param string $plural The text to be used if the number is plural. + * @param int $number The number to compare against to use either the singular or plural form. + * @param string $domain Optional. Text domain. Unique identifier for retrieving translated strings. + * Default 'default'. + * @return string The translated singular or plural form. */ function _nc( $single, $plural, $number, $domain = 'default' ) { _deprecated_function( __FUNCTION__, '2.9', '_nx()' );