NOTES

IF YOU HAVE							AND YOU CALL				YOU WILL GET						WITH THE FOLLOWING KNOWN GOTCHAS

s.Iterator							asJava							j.u.Iterator						Optional operations will throw exceptions (remove).
												asJavaEnumeration		j.u.Enumeration					None.

s.Iterable							asJava							j.l.Iterable						On iterator, optional operations will throw
																																		exceptions (remove).

s.Collection						asJava							j.u.Collection					Optional operations will throw exceptions (add,
																																		addAll, clear, remove, removeAll, retainAll).
																																		On iterator, optional operations will throw 
																																		exceptions (remove).

s.Seq										asJava							j.u.List								Optional operations will throw exceptions (add, 
																																		addAll, clear, remove, removeAll, retainAll, set). 
																																		On iterators, optional operations will throw  
																																		exceptions (remove, set).

s.RAS.Mutable						asJava							j.u.List								Of the optional operations, only one (set) is
																																		supported, all others (add, addAll, clear, remove,
																																		removeAll, retainAll) will throw exceptions.
																																		On iterators, optional operations will throw  
																																		exceptions (remove, set).

s.c.Map									asJava							j.u.Map									Optional operations will throw exceptions (clear,
																																		put, putAll, remove).
																																		On entries, optional operations will throw
																																		exceptions (setValue).
												asJavaDictionary    j.u.Dictionary					Mutating operations will throw exceptions (put,
																																		remove).

s.c.Set									asJava							j.u.Set									Optional operations will throw exceptions (add,
																																		addAll, clear, remove, removeAll, retainAll).
																																		On iterator, optional operations will throw
																																		exceptions (remove).

s.c.m.Map								asJava							j.u.Map									See source of JMutableMapWrapper for potentially
																																		unsafe casts.
																																		On entries, optional operations will throw
																																		exception (setValue). TODO: Unimplemented.
         								asJavaDictionary	  j.u.Dictionary					See source of JMutableDictionaryMapper for
																																		potentially unsafe casts.

s.c.m.Set								asJava							j.u.Set									On iterators, optional operations will throw
																																		exceptions (remove, set). TODO: Unimplemented

s.c.m.Buffer						asJava							j.u.List								On iterators, optional operations will throw
																																		exceptions (remove, set). TODO: Unimplemented
												asJavaQueue					j.u.{List with Queue}		See source of JBufferDequeWrapper for
																																		potentially unsafe casts.
																																		On iterators, optional operations will throw
																																		exceptions (remove, set). TODO: Unimplemented
												asJavaDeque					j.u.{List with Deque}		See source of JBufferDequeWrapper for
																																		potentially unsafe casts.
																																		On iterators, optional operations will throw
																																		exceptions (remove, set). TODO: Unimplemented

IF YOU HAVE							AND YOU CALL				YOU WILL GET						WITH THE FOLLOWING KNOWN GOTCHAS

j.u.Enumeration					asScala							s.Iterator							None.
j.u.Iterator						asScala							s.Iterator							None.
j.u.Iterable						asScala							s.Iterable							None.
j.u.Collection					asScala							s.Collection						None.
j.u.Dictionary					asScala							s.c.Map									None.
												asScalaMutable			s.c.m.Map								None.
j.u.Map									asScala							s.c.Map									None.
												asScalaMutable			s.c.m.Map								None.
j.u.Set									asScala							s.c.Set									None.
												asScalaMutable			s.c.m.Set								None.
j.u.List								asScala							s.Seq										None.
												asScalaMutable			s.RAS.Mutable						None.
j.u.{List with Deque}		asScalaMutable			s.c.m.Buffer						None.