[wp-trac] [WordPress Trac] #7089: Inline comments in POT should be in msgctxt instead

[WordPress Trac]

#7089: Inline comments in POT should be in msgctxt instead
--------------------+-------------------------------------------------------
 Reporter:  leuce   |       Owner:  anonymous                                                          
     Type:  defect  |      Status:  new                                                                
 Priority:  normal  |   Milestone:  2.7                                                                
Component:  i18n    |     Version:                                                                     
 Severity:  normal  |    Keywords:  comment, translation, l10n, POT, PO, gettext, msgctxt, inline, pipe
--------------------+-------------------------------------------------------
 Some of the msgid messages in the wordpress.pot file contains inline
 comments for the translator.  These comments should ideally form part of
 the commented section of each message.  Leaving the comments inline might
 cause translators to translate the comment if they use a tool that doesn't
 know to hide these comments from the user.

 In the wordpress.pot file, these comments are separated from the
 translatable text using a pipe character.

 Examples of what currently is and what should ideally be:

 ==


 {{{
 #: wp-admin/edit-comments.php:99
 msgid "Approved|plural"
 msgstr ""

 #: wp-admin/edit-comments.php:99
 msgctxt "plural"
 msgid "Approved"
 msgstr ""
 }}}


 ==


 {{{
 #: wp-admin/edit-pages.php:42 wp-admin/includes/post.php:481
 msgid "Drafts|manage posts header"
 msgstr ""

 #: wp-admin/edit-pages.php:42 wp-admin/includes/post.php:481
 msgctxt "manage posts header"
 msgid "Drafts"
 msgstr ""
 }}}


 ==


 {{{
 #: wp-admin/edit-pages.php:74
 #, php-format
 msgid ""
 "%1$s%2$s%3$s|You can reorder these: 1: Pages, 2: by {s}, 3: matching {s}"
 msgstr ""

 #: wp-admin/edit-pages.php:74
 #, php-format
 msgctxt ""
 "You can reorder these: 1: Pages, 2: by {s}, 3: matching {s}"
 msgid "%1$s%2$s%3$s"
 msgstr ""
 }}}


 ==

 You can easily find these in the wordpress.pot file by searching for a
 pipe (|) character, but I've extracted all of them from wordpress.pot, to
 illustrate which of them need the change.  Some of them might use
 comprehensive rewriting, such as this one:


 {{{
 #: wp-includes/locale.php:186
 msgid ""
 "number_format_decimal_point|$dec_point argument for http://php.net/"
 "number_format, default is ."
 msgstr ""
 }}}


 ...which is probably rather meanless to a poor translator.  I'll be
 willing to write suggested changes for these, but I'm not skilled to edit
 the actual sources from which the POT file is generated.

 Thanks

-- 
Ticket URL: <http://trac.wordpress.org/ticket/7089>
WordPress Trac <http://trac.wordpress.org/>
WordPress blogging software