[Zope3-checkins] SVN: Zope3/trunk/src/zope/i18nmessageid/ Add some hopefully helpful guidance in choosing message ids for new work.

[Gary Poster]

Log message for revision 30005:
  Add some hopefully helpful guidance in choosing message ids for new work.
  

Changed:
  U   Zope3/trunk/src/zope/i18nmessageid/__init__.py
  U   Zope3/trunk/src/zope/i18nmessageid/messageid.py

-=-
Modified: Zope3/trunk/src/zope/i18nmessageid/__init__.py
===================================================================
--- Zope3/trunk/src/zope/i18nmessageid/__init__.py	2005-04-15 16:17:05 UTC (rev 30004)
+++ Zope3/trunk/src/zope/i18nmessageid/__init__.py	2005-04-15 16:17:58 UTC (rev 30005)
@@ -15,5 +15,9 @@
 
 $Id$
 """
+# this is the old message id implementation; it is on the slate to be
+# deprecated sometime in the future.
 from messageid import MessageID, MessageIDFactory
+# this is the new message id implementation.  It is the one to use if you
+# have a choice.  Please see messages.txt for more details.
 from message import Message, MessageFactory

Modified: Zope3/trunk/src/zope/i18nmessageid/messageid.py
===================================================================
--- Zope3/trunk/src/zope/i18nmessageid/messageid.py	2005-04-15 16:17:05 UTC (rev 30004)
+++ Zope3/trunk/src/zope/i18nmessageid/messageid.py	2005-04-15 16:17:58 UTC (rev 30005)
@@ -16,6 +16,11 @@
 $Id$
 """
 
+# Note that this module is slated for deprecation.  Please see messages.txt
+# in this directory for more information.  The short advice is to use 
+# message.Message instead of messageid.MessageID, and message.MessageFactory
+# instead of messageid.MessageIDFactory.
+
 class MessageID(unicode):
     """Message ID.