Deprecate Chat API, introduce new Chat API

Also add (From|To)TypeFilter and update/fix the documentation in a few places.

smack-im/src/main/java/org/jivesoftware/smack/chat/Chat.java

@@ -36,7 +36,9 @@ import java.util.concurrent.CopyOnWriteArraySet;
  * sender.
  * 
  * @author Matt Tucker
+ * @deprecated use <code>org.jivesoftware.smack.chat2.Chat</code> from <code>smack-extensions</code> instead.
  */
+@Deprecated
 public class Chat {
 
     private ChatManager chatManager;

smack-im/src/main/java/org/jivesoftware/smack/chat/ChatManager.java

@@ -52,7 +52,9 @@ import org.jxmpp.jid.EntityJid;
  * made aware of new chats, register a listener by calling {@link #addChatListener(ChatManagerListener)}.
  *
  * @author Alexander Wenckus
+ * @deprecated use <code>org.jivesoftware.smack.chat2.ChatManager</code> from <code>smack-extensions</code> instead.
  */
+@Deprecated
 public final class ChatManager extends Manager{
 
     private static final Logger LOGGER = Logger.getLogger(ChatManager.class.getName());

smack-im/src/main/java/org/jivesoftware/smack/chat/ChatManagerListener.java

@@ -30,5 +30,6 @@ public interface ChatManagerListener {
      * @param chat the chat that was created.
      * @param createdLocally true if the chat was created by the local user and false if it wasn't.
      */
+    @SuppressWarnings("deprecation")
     void chatCreated(Chat chat, boolean createdLocally);
 }

smack-im/src/main/java/org/jivesoftware/smack/chat/ChatMessageListener.java

@@ -20,5 +20,6 @@ package org.jivesoftware.smack.chat;
 import org.jivesoftware.smack.packet.Message;
 
 public interface ChatMessageListener {
+    @SuppressWarnings("deprecation")
     void processMessage(Chat chat, Message message);
 }