format of #. reference

[Gabriel R.]

Hello,

This is feedback regarding the documentation at 
http://www.gnu.org/software/gettext/manual/gettext.html#PO-Files

The format of the reference fields mentions that "Comment lines starting with 
#: contain references to the program's source code." However, .PO file are used 
for more than source code strings. I.e. Drupal's internationalization module 
exports POs with content using references in the format _module:id:place_. 
There are hundreds of translators, thousands of sites and millions of users 
benefiting from these POs. 

It would be worth extending this definition to cover these cases.

Thank you.

PS: This is actually an important modification. The best PO editor, and OSS at 
that, is Qt Linguist. The brave guys developing it took your definition and 
examples a strict specification. They went as far as making the editor replace 
the end of the #. lines with :0 to resemble line numbers. This effectively 
corrupts the files, making Linguist useless for Drupal internationalization. I 
reported the bug on their open tracker, but they pointed out the gettext 
documentation as the reason. So, there, please change a word or two to make 
thousands happy.