connector comments transformer issues

so, looking thru the cq gw source I see this formatter

com\ibm\rational\connector\cq\teamapi\common\internal\CQNoteEntry.java

that documents the text (toString) format of the cq note as

user==usertext!FIELD!text==textstring!NOTE_ENTRY!

so, formatting my incoming text comment string that way and selecting the comment transformer, I get java.lang.RuntimeException: The value "usertext" for property "Comments" is invalid, because it cannot be interpreted as item identifiers (UUIDs)

I found this page on the setup of the user synch of comment entries http://publib.boulder.ibm.com/infocenter/rtc/v2r0m0/index.jsp?topic=/com.ibm.team.connector.cq.doc/topics/t_mapping_comments.html

and that config for contributor I have, and it works to my remote manager.

when I use that as the sync rule on the comment transformer config, I get
Incoming at 10/12/10 8:44:32 AM CDT
Error occurred:
java.lang.RuntimeException: The value "user==usertext!FIELD!text==this%20is%20a%20test%20update%20of%20a%20work%20item!NOTE_ENTRY!" for property "Comments" is invalid, because it cannot be interpreted as external references (URIs)

So, I am back to confused again..

can someone document the rules for the comment transformer, for NON-CQ incoming/outgoing comments.

or tell me that I have to write my own transformer..(in which case the generic transformer should be renamed to CQ specific name)

altho I have comment set as in/out, and I can manually add them to workitems created thru my itemconnector, I don't see the data on the outgoing synchronizations..

Sam