Unclear documentation about obsolete entries

[Rodrigo Tobar]

Hi,

While running msgcat on some .po files that had been recently updated, 
we received errors about diplicate msgid entries. These stemmed from two 
msgids entries, one valid and the other obsolete. We removed the 
obsolete entry and the error went away.

Questions:
 * Is this a bug or a feature? It seems a bit weird that an obsolete, 
commented entry conflicts with a valid one, but maybe this is intended 
behaviour.
 * I'm only superficially familiar with po files and their syntax, but 
from the documentation both at [1] and [2] I couldn't find any reference 
at the "#~ ..." syntax for obsolete entries. Only going through the 
source code at [3] I could find out what was going on. Before that, I 
thought I had hit a bug in gettext. Could the documentation be improved 
in this regard?

Thanks for the attention,

Rodrigo

[1] https://www.gnu.org/software/gettext/manual/html_node/PO-Files.html
[2] 
https://www.gnu.org/software/gettext/manual/html_node/Obsolete-Entries.html
[3] 
https://git.savannah.gnu.org/gitweb/?p=gettext.git;a=blob;f=gettext-tools/src/read-po-lex.c;h=b1ed37923d291b714f960a3a221295babfa1a365;hb=HEAD#l1092