[wp-trac] [WordPress Trac] #34127: Update docblocks for l10n.php (was: Update docblocks for i10n.php)

[WordPress Trac]

#34127: Update docblocks for l10n.php
----------------------------+-------------------
 Reporter:  johnbillion     |       Owner:
     Type:  task (blessed)  |      Status:  new
 Priority:  normal          |   Milestone:  4.4
Component:  I18N            |     Version:
 Severity:  normal          |  Resolution:
 Keywords:                  |     Focuses:  docs
----------------------------+-------------------

Comment (by johnbillion):

 [attachment:34127.diff] addresses several issues with the docblocks for
 our l10n functions.

  * Corrects phrasing used in the descriptions for and filters in `_n()`
 and `_nx()`, particularly with regard to the use of 'singular' instead of
 'single' or '1', and 'plural' instead of 'not 1'.
  * Adds example usage to `_n()`, `_nx()`, `_nx_noop()`, and
 `translate_nooped_plural()`.
  * Adds hash notation `@return` doc for `_n_noop()` and `_nx_noop()`.
  * Adds missing default values for the `$domain` parameter.

--
Ticket URL: <https://core.trac.wordpress.org/ticket/34127#comment:1>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform