SPARK-884 added javadoc to OTR Plugin

git-svn-id: http://svn.igniterealtime.org/svn/repos/spark/trunk@12481 b35dd754-fafc-0310-a699-88a17e54d16e

src/plugins/otr/src/java/org/jivesoftware/spark/otrplug/OTRManager.java

@@ -1,7 +1,5 @@
 package org.jivesoftware.spark.otrplug;
 
-
-
 import java.io.IOException;
 
 import java.util.HashMap;
@@ -25,8 +23,13 @@ import org.jivesoftware.spark.ui.ContactItem;
 import org.jivesoftware.spark.ui.ContactItemHandler;
 import org.jivesoftware.spark.ui.rooms.ChatRoomImpl;
 
-
+/**
-
+ * OTRManager controls the whole OTR process. It checks if a new chat window is
+ * opened and creates an OTR session if there is no available.
+ * 
+ * @author Bergunde Holger
+ * 
+ */
 
 public class OTRManager extends ChatRoomListenerAdapter implements ContactItemHandler {
 
@@ -36,14 +39,11 @@ public class OTRManager  extends ChatRoomListenerAdapter implements ContactItemH
     final ChatManager chatManager = SparkManager.getChatManager();
     private static MyOtrKeyManager _keyManager;
 
-
+    private OTRManager() {
-    private OTRManager()
-    {
         chatManager.addChatRoomListener(this);
         chatManager.addContactItemHandler(this);
     }
 
-    
     @Override
     public void chatRoomOpened(ChatRoom room) {
         super.chatRoomOpened(room);
@@ -67,7 +67,11 @@ public class OTRManager  extends ChatRoomListenerAdapter implements ContactItemH
         }
     }
 
-    
+    /**
+     * OTRManager is a sigleton. Use this method to get the instance.
+     * 
+     * @return
+     */
     public static OTRManager getInstance() {
         // Synchronize on LOCK to ensure that we don't end up creating
         // two singletons.
@@ -77,10 +81,10 @@ public class OTRManager  extends ChatRoomListenerAdapter implements ContactItemH
                 singleton = controller;
                 try {
                     _keyManager = new MyOtrKeyManager(SparkManager.getUserDirectory().getPath() + "/otrkey.priv");
-                    //we should generate a local keyprint if there is no avaiable
+                    // we should generate a local keyprint if there is no
+                    // avaiable
                     String key = _keyManager.getLocalFingerprint(new SessionID(SparkManager.getConnection().getUser(), "none", "Scytale"));
-                    if (key == null)
+                    if (key == null) {
-                    {
                         _keyManager.generateLocalKeyPair(new SessionID(SparkManager.getConnection().getUser(), "none", "Scytale"));
                     }
 
@@ -94,67 +98,65 @@ public class OTRManager  extends ChatRoomListenerAdapter implements ContactItemH
         return singleton;
     }
 
-    public void startOtrWithUser(String jid)
+    /**
-    {
+     * Starts the OTR session with specified JID.
-        if (_activeSessions.containsKey(jid))
+     * 
-        {
+     * @param jid
+     *            participant
+     */
+    public void startOtrWithUser(String jid) {
+        if (_activeSessions.containsKey(jid)) {
             _activeSessions.get(jid).startSession();
         }
     }
 
-    private void createOTRSession(ChatRoomImpl chatroom, String jid)
+    private void createOTRSession(ChatRoomImpl chatroom, String jid) {
-    {
+        if (!_activeSessions.containsKey(jid)) {
-        if (!_activeSessions.containsKey(jid))
-        {
             _activeSessions.put(jid, startOTRSession(chatroom, jid));
         } else {
             _activeSessions.get(jid).updateChatRoom(chatroom);
         }
     }
 
-    public MyOtrKeyManager getKeyManager()
+    /**
-    {
+     * Returns the OtrKeyManager to store and load keys
+     * 
+     * @return
+     */
+    public MyOtrKeyManager getKeyManager() {
         return _keyManager;
     }
 
-    private OTRSession startOTRSession(ChatRoomImpl chatroom, String jid)
+    private OTRSession startOTRSession(ChatRoomImpl chatroom, String jid) {
-    {
         return new OTRSession(chatroom, SparkManager.getConnection().getUser(), jid);
     }
 
-
     @Override
     public boolean handlePresence(ContactItem item, Presence presence) {
-        if (OTRProperties.getInstance().getOTRCloseOnDisc())
+        if (OTRProperties.getInstance().getOTRCloseOnDisc()) {
-        {
+            if (!presence.isAvailable() && _activeSessions.containsKey(item.getJID())) {
-            if (!presence.isAvailable() && _activeSessions.containsKey(item.getJID()))
-            {
                 _activeSessions.get(item.getJID()).stopSession();
             }
         }
         return false;
     }
 
-
     @Override
     public Icon getIcon(String jid) {
         // TODO Auto-generated method stub
         return null;
     }
 
-
     @Override
     public Icon getTabIcon(Presence presence) {
         // TODO Auto-generated method stub
         return null;
     }
 
-
     @Override
     public boolean handleDoubleClick(ContactItem item) {
         // TODO Auto-generated method stub
         return false;
     }
 
-
 }

src/plugins/otr/src/java/org/jivesoftware/spark/otrplug/OTRPlugin.java

@@ -5,7 +5,11 @@ import org.jivesoftware.spark.otrplug.pref.OTRPreferences;
 import org.jivesoftware.spark.plugin.Plugin;
 import org.jivesoftware.spark.preference.Preference;
 
-
+/**
+ * OTR Plugin
+ * 
+ * @author Bergunde Holger
+ */
 
 public class OTRPlugin implements Plugin {
 

src/plugins/otr/src/java/org/jivesoftware/spark/otrplug/impl/MyOtrKeyManager.java

@@ -30,14 +30,34 @@ import net.java.otr4j.crypto.OtrCryptoEngineImpl;
 import net.java.otr4j.crypto.OtrCryptoException;
 import net.java.otr4j.session.SessionID;
 
+/**
+ * An implementation of the OtrKeyManager provided by otr4j. It stores the local
+ * key chain
+ * 
+ * @author Bergunde Holger
+ * 
+ */
 public class MyOtrKeyManager implements OtrKeyManager {
 
     private OtrKeyManagerStore store;
 
+    /**
+     * Use this consturctor if you want to use your own implementation for key
+     * storage
+     * 
+     * @param store
+     *            Imlementation of OtrKeyManagerStore
+     */
     public MyOtrKeyManager(OtrKeyManagerStore store) {
         this.store = store;
     }
 
+    /**
+     * Inner class, own implemented key sotrage
+     * 
+     * @author Bergunde Holger
+     * 
+     */
     class DefaultPropertiesStore implements OtrKeyManagerStore {
         private final Properties properties = new Properties();
         private String filepath;
@@ -112,12 +132,23 @@ public class MyOtrKeyManager implements OtrKeyManager {
         }
     }
 
+    /**
+     * Use this consturctor if key manager should use his own implementation of
+     * key storage
+     * 
+     * @param filepath
+     *            file where the keys should be stored
+     * @throws IOException
+     */
     public MyOtrKeyManager(String filepath) throws IOException {
         this.store = new DefaultPropertiesStore(filepath);
     }
 
     private List<OtrKeyManagerListener> listeners = new Vector<OtrKeyManagerListener>();
 
+    /**
+     * Adds listener to key manager
+     */
     public void addListener(OtrKeyManagerListener l) {
         synchronized (listeners) {
             if (!listeners.contains(l))
@@ -125,12 +156,22 @@ public class MyOtrKeyManager implements OtrKeyManager {
         }
     }
 
+    /**
+     * Remove listener from key manager
+     */
     public void removeListener(OtrKeyManagerListener l) {
         synchronized (listeners) {
             listeners.remove(l);
         }
     }
 
+    /**
+     * Generate a local key pair. Be careful. If there is already an key pair,
+     * it will override it
+     * 
+     * @param sessionID
+     *            the sessionID that is identified with the local machine
+     */
     public void generateLocalKeyPair(SessionID sessionID) {
         if (sessionID == null)
             return;
@@ -157,6 +198,13 @@ public class MyOtrKeyManager implements OtrKeyManager {
         this.store.setProperty(accountID + ".privateKey", pkcs8EncodedKeySpec.getEncoded());
     }
 
+    /**
+     * 
+     * Returns the local finger print for specified session. If there is no
+     * finger print you might generate one.
+     * 
+     * @return the local finger print for this sessionID
+     */
     public String getLocalFingerprint(SessionID sessionID) {
         KeyPair keyPair = loadLocalKeyPair(sessionID);
 
@@ -173,6 +221,11 @@ public class MyOtrKeyManager implements OtrKeyManager {
         }
     }
 
+    /**
+     * Return remote finger print for specified sessionID.
+     * 
+     * @return finger print for remote contact
+     */
     public String getRemoteFingerprint(SessionID sessionID) {
         PublicKey remotePublicKey = loadRemotePublicKey(sessionID);
         if (remotePublicKey == null)
@@ -185,6 +238,10 @@ public class MyOtrKeyManager implements OtrKeyManager {
         }
     }
 
+    /**
+     * check if the specified sessionID is verified for this machine
+     * 
+     */
     public boolean isVerified(SessionID sessionID) {
         if (sessionID == null)
             return false;
@@ -192,6 +249,12 @@ public class MyOtrKeyManager implements OtrKeyManager {
         return this.store.getPropertyBoolean(sessionID.getUserID() + ".publicKey.verified", false);
     }
 
+    /**
+     * Returns the key pair (private and public key) for the local machine
+     * 
+     * @param sessionID
+     *            sessionID for currect machine
+     */
     public KeyPair loadLocalKeyPair(SessionID sessionID) {
         if (sessionID == null)
             return null;
@@ -231,6 +294,10 @@ public class MyOtrKeyManager implements OtrKeyManager {
         return new KeyPair(publicKey, privateKey);
     }
 
+    /**
+     * Loads the public key for the specified sessionID. If there is no key
+     * stored, you will get 'null'
+     */
     public PublicKey loadRemotePublicKey(SessionID sessionID) {
         if (sessionID == null)
             return null;
@@ -257,6 +324,14 @@ public class MyOtrKeyManager implements OtrKeyManager {
         }
     }
 
+    /**
+     * Stores the public key for a specified user from sessionID
+     * 
+     * @param sessionID
+     *            sessionID to identifiy the owner of the key
+     * @param pubKey
+     *            the key which should be stored
+     */
     public void savePublicKey(SessionID sessionID, PublicKey pubKey) {
         if (sessionID == null)
             return;
@@ -269,6 +344,9 @@ public class MyOtrKeyManager implements OtrKeyManager {
         this.store.removeProperty(userID + ".publicKey.verified");
     }
 
+    /**
+     * Removes the verification for the specified sessionID
+     */
     public void unverify(SessionID sessionID) {
         if (sessionID == null)
             return;
@@ -282,6 +360,9 @@ public class MyOtrKeyManager implements OtrKeyManager {
 
     }
 
+    /**
+     * Verify the specified sessionID
+     */
     public void verify(SessionID sessionID) {
         if (sessionID == null)
             return;

src/plugins/otr/src/java/org/jivesoftware/spark/otrplug/impl/OTREngineHost.java

@@ -3,7 +3,6 @@ package org.jivesoftware.spark.otrplug.impl;
 import java.awt.Color;
 import java.security.KeyPair;
 
-
 import org.jivesoftware.smack.packet.Message;
 import org.jivesoftware.smack.util.StringUtils;
 import org.jivesoftware.spark.SparkManager;
@@ -14,12 +13,19 @@ import net.java.otr4j.OtrEngineHost;
 import net.java.otr4j.OtrPolicy;
 import net.java.otr4j.session.SessionID;
 
+/**
+ * 
+ * Implementation of OtrEngineHost provided from otr4j. It handles the message
+ * injection to specified chat window and handles key pair.
+ * 
+ * @author Bergunde Holger
+ */
 public class OTREngineHost implements OtrEngineHost {
 
     private ChatRoomImpl _chatRoom;
     private OtrPolicy _policy;
-    public OTREngineHost(OtrPolicy policy, ChatRoomImpl chatroom)
+
-    {
+    public OTREngineHost(OtrPolicy policy, ChatRoomImpl chatroom) {
         _policy = policy;
         _chatRoom = chatroom;
     }

src/plugins/otr/src/java/org/jivesoftware/spark/otrplug/impl/OTRSession.java

@@ -26,6 +26,12 @@ import net.java.otr4j.OtrPolicyImpl;
 import net.java.otr4j.session.SessionID;
 import net.java.otr4j.session.SessionStatus;
 
+/**
+ * OTRSession are unique for every conversation. It handles the otrEngine for
+ * the chat and controls if the chat is encrypted or not.
+ * 
+ * @author Bergunde Holger
+ */
 public class OTRSession {
 
     private ChatRoomImpl _chatRoom;
@@ -41,6 +47,16 @@ public class OTRSession {
     private boolean _OtrEnabled = false;
     private OtrEngineListener _otrListener;
 
+    /**
+     * OTRSession Constructor
+     * 
+     * @param chatroom
+     *            chat room related to this OTR session
+     * @param myJID
+     *            my own JID
+     * @param remoteJID
+     *            the JID of the participant
+     */
     public OTRSession(ChatRoomImpl chatroom, String myJID, String remoteJID) {
         _chatRoom = chatroom;
         _myJID = myJID;
@@ -50,16 +66,12 @@ public class OTRSession {
 
         _engine = new OtrEngineImpl(_otrEngineHost);
 
-        
-        
-        
         setUpMessageListener();
 
         createButton();
 
         // Only initialize the actionListener once
-        _otrButton.addActionListener(
+        _otrButton.addActionListener(new ActionListener() {
-                new ActionListener() {
 
             @Override
             public void actionPerformed(ActionEvent e) {
@@ -77,6 +89,13 @@ public class OTRSession {
         _OtrEnabled = OTRProperties.getInstance().getIsOTREnabled();
     }
 
+    /**
+     * Maybe you want to update the chat room because it was reopend but the OTR
+     * session is still alive.
+     * 
+     * @param chatroom
+     *            the chat room related to this OTR session
+     */
     public void updateChatRoom(ChatRoomImpl chatroom) {
         _OtrEnabled = OTRProperties.getInstance().getIsOTREnabled();
         _chatRoom = chatroom;
@@ -117,8 +136,7 @@ public class OTRSession {
                         }
                         message.setBody(old);
                     }
-                } else if (!_OtrEnabled)
+                } else if (!_OtrEnabled) {
-                {
                     String old = message.getBody();
                     message.setBody(null);
                     if (old.length() > 3 && old.substring(0, 4).equals("?OTR")) {
@@ -141,14 +159,13 @@ public class OTRSession {
             ImageIcon otricon = null;
             if (_engine.getSessionStatus(_mySession).equals(SessionStatus.ENCRYPTED)) {
                 otricon = new ImageIcon(cl.getResource("otr_on.png"));
-                _conPanel.sucessfullyCon();
+                _conPanel.successfullyCon();
             } else {
                 otricon = new ImageIcon(cl.getResource("otr_off.png"));
             }
 
             _otrButton.setIcon(otricon);
 
-          
             _engine.removeOtrEngineListener(_otrListener);
             _chatRoom.getToolBar().addChatRoomButton(_otrButton);
             _otrListener = new OtrEngineListener() {
@@ -156,7 +173,7 @@ public class OTRSession {
                 @Override
                 public void sessionStatusChanged(SessionID arg0) {
                     if (_engine.getSessionStatus(_mySession).equals(SessionStatus.ENCRYPTED)) {
-                        _conPanel.sucessfullyCon();
+                        _conPanel.successfullyCon();
 
                         String otrkey = _manager.getKeyManager().getRemoteFingerprint(_mySession);
                         if (otrkey == null) {
@@ -191,11 +208,17 @@ public class OTRSession {
         }
     }
 
+    /**
+     * Start the OTR session manually from outside
+     */
     public void startSession() {
         _conPanel.tryToStart();
         _engine.startSession(_mySession);
     }
 
+    /**
+     * Stop the OTR session manually from outside
+     */
     public void stopSession() {
         _conPanel.connectionClosed();
         if (_engine.getSessionStatus(_mySession).equals(SessionStatus.ENCRYPTED)) {

src/plugins/otr/src/java/org/jivesoftware/spark/otrplug/pref/OTRKeyTable.java

@@ -4,8 +4,6 @@ import java.awt.BorderLayout;
 
 import java.util.Vector;
 
-
-
 import javax.swing.JPanel;
 import javax.swing.JScrollPane;
 import javax.swing.JTable;
@@ -15,7 +13,12 @@ import javax.swing.table.DefaultTableModel;
 
 import org.jivesoftware.spark.otrplug.util.OTRResources;
 
-
+/**
+ * OTRKeyTable displays a key table. You can add keys using the addEntry()
+ * mathod
+ * 
+ * @author Bergunde Holger
+ */
 public class OTRKeyTable extends JPanel {
 
     /**
@@ -70,6 +73,13 @@ public class OTRKeyTable extends JPanel {
         _tableModel.addTableModelListener(listener);
     }
 
+    /**
+     * Adds a key to the table
+     * 
+     * @param jid
+     * @param hash
+     * @param verified
+     */
     public void addEntry(String jid, String hash, boolean verified) {
         Vector<Object> data = new Vector<Object>(3);
 
@@ -80,6 +90,12 @@ public class OTRKeyTable extends JPanel {
         _tableModel.addRow(data);
     }
 
+    /**
+     * Returns a specified row
+     * 
+     * @param row
+     * @param col
+     */
     public Object getValueAt(int row, int col) {
         return _tableModel.getValueAt(row, col);
     }

src/plugins/otr/src/java/org/jivesoftware/spark/otrplug/pref/OTRPrefPanel.java

@@ -27,11 +27,15 @@ import org.jivesoftware.spark.otrplug.impl.MyOtrKeyManager;
 import org.jivesoftware.spark.otrplug.util.OTRProperties;
 import org.jivesoftware.spark.otrplug.util.OTRResources;
 
-public class OTRPrefPanel extends JPanel {
-
 /**
+ * 
+ * OTR preference panel for Spark Preferences
+ * 
+ * @author Bergund Holger
  * 
  */
+public class OTRPrefPanel extends JPanel {
+
     private static final long serialVersionUID = -7125162190413040003L;
     private OTRManager _manager;
     private JCheckBox _enableOTR;
@@ -56,8 +60,7 @@ public class OTRPrefPanel extends JPanel {
     }
 
     private void OtrEnableSwitch() {
-        if (!_enableOTR.isSelected())
+        if (!_enableOTR.isSelected()) {
-        {
             _closeSessionOff.setEnabled(false);
             _closeSessionOnWindowClose.setEnabled(false);
             _renewPrivateKey.setEnabled(false);
@@ -115,12 +118,8 @@ public class OTRPrefPanel extends JPanel {
 
         loadRemoteKeys();
 
-        
-
     }
 
-
-
     private void loadRemoteKeys() {
 
         for (RosterEntry entry : SparkManager.getConnection().getRoster().getEntries()) {
@@ -145,8 +144,7 @@ public class OTRPrefPanel extends JPanel {
                     SessionID curSelectedSession = new SessionID(SparkManager.getConnection().getUser(), JID, "Scytale");
                     if (!selection) {
                         _keyManager.verify(curSelectedSession);
-                    } else
+                    } else {
-                    {
                         _keyManager.unverify(curSelectedSession);
                     }
                 }
@@ -159,14 +157,14 @@ public class OTRPrefPanel extends JPanel {
         this.setBorder(BorderFactory.createTitledBorder(OTRResources.getString("otr.settings")));
         this.add(_enableOTR, new GridBagConstraints(0, 0, 1, 1, 1.0, 0.0, GridBagConstraints.NORTHWEST, GridBagConstraints.HORIZONTAL, new Insets(0, 0, 0, 0), 0, 0));
         this.add(_closeSessionOff, new GridBagConstraints(0, 1, 1, 1, 1.0, 0.0, GridBagConstraints.NORTHWEST, GridBagConstraints.HORIZONTAL, new Insets(10, 0, 0, 0), 0, 0));
-        this.add(_closeSessionOnWindowClose, new GridBagConstraints(0, 2, 1, 1, 1.0, 0.0, GridBagConstraints.NORTHWEST, GridBagConstraints.HORIZONTAL, new Insets(0, 0, 0, 0), 0, 0));
+        this.add(_closeSessionOnWindowClose,
+                new GridBagConstraints(0, 2, 1, 1, 1.0, 0.0, GridBagConstraints.NORTHWEST, GridBagConstraints.HORIZONTAL, new Insets(0, 0, 0, 0), 0, 0));
         this.add(_currentKeyLabel, new GridBagConstraints(0, 3, 1, 1, 0.0, 0.0, GridBagConstraints.NORTHWEST, GridBagConstraints.NONE, new Insets(10, 5, 0, 0), 0, 0));
         this.add(_privateKey, new GridBagConstraints(1, 3, 1, 1, 1.0, 0.0, GridBagConstraints.NORTHWEST, GridBagConstraints.HORIZONTAL, new Insets(10, 0, 0, 5), 0, 0));
         this.add(_renewPrivateKey, new GridBagConstraints(1, 4, 1, 1, 0.0, 0.0, GridBagConstraints.NORTHEAST, GridBagConstraints.NONE, new Insets(0, 0, 0, 5), 0, 0));
         this.add(_keytable, new GridBagConstraints(0, 5, 2, 1, 1.0, 1.0, GridBagConstraints.NORTHWEST, GridBagConstraints.BOTH, new Insets(20, 5, 10, 5), 0, 0));
     }
 
-    
     private String getCurrentLocalKey() {
         SessionID mySession = new SessionID(SparkManager.getConnection().getUser(), "no one", "Scytale");
         String myKey = _keyManager.getLocalFingerprint(mySession);
@@ -179,20 +177,16 @@ public class OTRPrefPanel extends JPanel {
         return this;
     }
 
-
+    public boolean isOTREnabled() {
-    public boolean isOTREnabled()
-    {
         return _enableOTR.isSelected();
     }
 
-    public boolean isCloseOnDisc()
+    public boolean isCloseOnDisc() {
-    {
         return _closeSessionOff.isSelected();
     }
-    public boolean isCloseOnChatClose()
+
-    {
+    public boolean isCloseOnChatClose() {
         return _closeSessionOnWindowClose.isSelected();
     }
 
-    
 }

src/plugins/otr/src/java/org/jivesoftware/spark/otrplug/pref/OTRPreferences.java

@@ -3,11 +3,15 @@ package org.jivesoftware.spark.otrplug.pref;
 import javax.swing.Icon;
 import javax.swing.JComponent;
 
-
 import org.jivesoftware.spark.otrplug.util.OTRProperties;
 import org.jivesoftware.spark.otrplug.util.OTRResources;
 import org.jivesoftware.spark.preference.Preference;
 
+/**
+ * Implementation of Preference interface provided by Spark
+ * 
+ * @author Bergunde Holger
+ */
 public class OTRPreferences implements Preference {
 
     private OTRPrefPanel pref = new OTRPrefPanel();
@@ -24,8 +28,7 @@ public class OTRPreferences implements Preference {
 
     @Override
     public String getTooltip() {
-        // TODO Auto-generated method stub
+        return OTRResources.getString("otr.title");
-        return null;
     }
 
     @Override

src/plugins/otr/src/java/org/jivesoftware/spark/otrplug/ui/OTRConnectionPanel.java

@@ -23,6 +23,12 @@ import org.jivesoftware.spark.otrplug.util.OTRResources;
 import org.jivesoftware.spark.ui.TranscriptWindow;
 import org.jivesoftware.spark.ui.rooms.ChatRoomImpl;
 
+/**
+ * Shows StyledDocuments in transcript window for info if the session
+ * established successfully or not
+ * 
+ * @author Bergunde Holger
+ */
 public class OTRConnectionPanel {
 
     private ChatRoomImpl _chatRoom;
@@ -52,15 +58,19 @@ public class OTRConnectionPanel {
 
         _retry.setVisible(false);
 
-
     }
 
+    /**
+     * Indicates that OTR is trying to establish an OTR session. This will
+     * inject a styledDocument. You have 10 seconds to approve that the
+     * connection was successful using method successfullyCon()
+     * 
+     */
     public void tryToStart() {
         if (!_succesfull && !_waiting) {
             renewPanel();
             _icon.setImage(SparkRes.getImageIcon(SparkRes.BUSY_IMAGE).getImage());
 
-            
             _conPanel.setVisible(true);
 
             _i = 10;
@@ -113,6 +123,9 @@ public class OTRConnectionPanel {
         }
     }
 
+    /**
+     * Indicates in the transcript window, that the OTR session has been closed
+     */
     public void connectionClosed() {
         if (_succesfull) {
             renewPanel();
@@ -127,12 +140,11 @@ public class OTRConnectionPanel {
         --_i;
     }
 
-    public void  setConnected(boolean con)
+    /**
-    {
+     * Should be called after you called tryToStart(). It will indicate that the
-        _succesfull = con;
+     * session is now encrypted
-    }
+     */
-
+    public void successfullyCon() {
-    public void sucessfullyCon() {
         if (!_succesfull) {
             if (!_waiting)
                 renewPanel();

src/plugins/otr/src/java/org/jivesoftware/spark/otrplug/util/OTRProperties.java

@@ -1,4 +1,3 @@
-
 package org.jivesoftware.spark.otrplug.util;
 
 import java.io.File;
@@ -23,6 +22,7 @@ public class OTRProperties {
 
     /**
      * returns the Instance of this Properties file
+     * 
      * @return
      */
     public static OTRProperties getInstance() {
@@ -54,40 +54,33 @@ public class OTRProperties {
 
     public void save() {
         try {
-            props.store(new FileOutputStream(getConfigFile()),
+            props.store(new FileOutputStream(getConfigFile()), "Storing OTRPlugin properties");
-                    "Storing OTRPlugin properties");
         } catch (Exception e) {
             e.printStackTrace();
         }
     }
 
-    public boolean getIsOTREnabled()
+    public boolean getIsOTREnabled() {
-    {
         return getBoolean("isOTREnabeld", true);
     }
 
-    public void setIsOTREnabled(boolean enabled)
+    public void setIsOTREnabled(boolean enabled) {
-    {
         setBoolean("isOTREnabeld", enabled);
     }
 
-    public boolean getOTRCloseOnDisc()
+    public boolean getOTRCloseOnDisc() {
-    {
         return getBoolean("OTRCloseOnDisc", true);
     }
 
-    public void setOTRCloseOnDisc(boolean enabled)
+    public void setOTRCloseOnDisc(boolean enabled) {
-    {
         setBoolean("OTRCloseOnDisc", enabled);
     }
 
-    public boolean getOTRCloseOnChatClose()
+    public boolean getOTRCloseOnChatClose() {
-    {
         return getBoolean("OTRCloseOnChatClose", false);
     }
 
-    public void setOTRCloseOnChatClose(boolean enabled)
+    public void setOTRCloseOnChatClose(boolean enabled) {
-    {
         setBoolean("OTRCloseOnChatClose", enabled);
     }
 
@@ -95,8 +88,7 @@ public class OTRProperties {
     // ===============================================================================
     // ===============================================================================
     private boolean getBoolean(String property, boolean defaultValue) {
-        return Boolean.parseBoolean(props.getProperty(property,
+        return Boolean.parseBoolean(props.getProperty(property, Boolean.toString(defaultValue)));
-                Boolean.toString(defaultValue)));
     }
 
     private void setBoolean(String property, boolean value) {

src/plugins/otr/src/java/org/jivesoftware/spark/otrplug/util/OTRResources.java

@@ -1,5 +1,10 @@
 package org.jivesoftware.spark.otrplug.util;
 
+/**
+ * OTRResources needed to load icons and language files into OTR plugin
+ * 
+ * @author Bergunde Holger
+ */
 import java.text.MessageFormat;
 import java.util.PropertyResourceBundle;
 import java.util.ResourceBundle;
@@ -18,6 +23,12 @@ public class OTRResources {
         prb = (PropertyResourceBundle) ResourceBundle.getBundle("i18n/otrplugin_i18n");
     }
 
+    /**
+     * Returns a string from the language file
+     * 
+     * @param propertyName
+     * @return
+     */
     public static final String getString(String propertyName) {
         try {
             return prb.getString(propertyName);
@@ -27,22 +38,30 @@ public class OTRResources {
         }
     }
 
-    
+    /**
-    public static ImageIcon getIcon(String fileName)
+     * Returns an ImageIcon from OTR resources folder
-    {
+     * 
+     * @param fileName
+     * @return
+     */
+    public static ImageIcon getIcon(String fileName) {
         final ClassLoader cl = OTRResources.class.getClassLoader();
         ImageIcon icon = new ImageIcon(cl.getResource(fileName));
         return icon;
     }
 
-
+    /**
+     * Returns a string with wildcards
+     * 
+     * @param propertyName
+     * @param obj
+     */
     public static String getString(String propertyName, Object... obj) {
         String str = prb.getString(propertyName);
         if (str == null) {
             return propertyName;
         }
 
-
         return MessageFormat.format(str, obj);
     }