Javadoc to describe plugin naming conventions

syncany-lib/src/main/java/org/syncany/plugins/transfer/TransferPlugin.java

@@ -30,10 +30,19 @@
  * to the remote storage. Implementations must provide implementations for
  * {@link TransferPlugin} (this class), {@link TransferSettings} (connection
  * details) and {@link TransferManager} (transfer methods).<br/><br/>
+ * *
+ *<i>Plugins have to follow a naming convention</i>
+ * <ul>
+ *   <li>Package names have to be lower snaked cased</li>
+ *   <li>Class names have to be camel cased</li>
+ *   <li>Package names will be converted to class names by replacing underscores ('_') and uppercasing the
+ *      subsequent character.</li>
+ * </ul>
  *
- * <p>Links between the classes can be created by annotating this class with
- * {@link org.syncany.plugins.transfer.PluginSettings} and {@link org.syncany.plugins.transfer.PluginManager},
- * respectively.
+ * Example:
+ * A plugin is called DummyPlugin, hence <i>org.syncany.plugins.dummy_plugin.DummyPluginTransferPlugin</i> is the
+ * plugin's {@link TransferPlugin} class and <i>org.syncany.plugins.dummy_plugin.DummyPluginTransferSettings</i> is the
+ * corresponding {@link TransferSettings} implementation.
  *
  * @author Philipp C. Heckel <philipp.heckel@gmail.com>
  * @author Christian Roth <christian.roth@port17.de>

syncany-lib/src/main/java/org/syncany/plugins/transfer/TransferPluginUtil.java

@@ -28,9 +28,7 @@
 /**
  * Helper class for {@link TransferPlugin}s, using to retrieve
  * the required transfer plugin classes -- namely {@link TransferSettings},
- * {@link TransferManager} and {@link TransferPlugin}. <br/>
- * <br/>
- * <i>Plugins have to follow convention</i>
+ * {@link TransferManager} and {@link TransferPlugin}.
  *
  * @author Christian Roth <christian.roth@port17.de>
  */
@@ -111,20 +109,20 @@ public static Class<? extends TransferPlugin> getTransferPluginClass(Class<? ext
 			}
 		}
 	}
-	
+
 	/**
 	 * Determines the {@link OAuthGenerator} class for the given class
 	 * if an {@link OAuth} annotation is present.
 	 */
 	public static Class<? extends OAuthGenerator> getOAuthGeneratorClass(Class<? extends TransferSettings> clazz) {
 		OAuth oauthAnnotation = clazz.getAnnotation(OAuth.class);
-		
+
 		if (oauthAnnotation != null) {
 			return oauthAnnotation.value();
 		}
 		else {
 			return null;
-		}		
+		}
 	}
 
 	private static String getPluginPackageName(Class<?> clazz) {