Clear up FirefoxDriver constructors

This was one of the first drivers written, and it's been one of
easiest to hack on. Consequently, it grew somewhat organically
without much careful design and planning, and this is most clear
in the wealth of constructors this thing has.

Mark almost all the constructors as deprecated, so that we can
remove them in a later release. I suspect that this will cause
less chaos than might be imagined since most of the constructors
seem highly specialised.

Author: shs96c

java/client/src/org/openqa/selenium/firefox/FirefoxDriver.java

@@ -259,14 +259,32 @@ private static FirefoxBinary getBinary(Capabilities capabilities) {
     return new FirefoxBinary();
   }
 
+  /**
+   * @deprecated Use {@link FirefoxDriver(Capabilities, Capabilities)} setting the binary and
+   * profile using {@link FirefoxOptions} set as the capability {@link
+   * FirefoxOptions#FIREFOX_OPTIONS}
+   */
+  @Deprecated
   public FirefoxDriver(FirefoxBinary binary, FirefoxProfile profile) {
     this(binary, profile, DesiredCapabilities.firefox());
   }
 
+  /**
+   * @deprecated Use {@link FirefoxDriver(Capabilities, Capabilities)} setting the binary and
+   * profile using {@link FirefoxOptions} set as the capability {@link
+   * FirefoxOptions#FIREFOX_OPTIONS}
+   */
+  @Deprecated
   public FirefoxDriver(FirefoxBinary binary, FirefoxProfile profile, Capabilities capabilities) {
     this(binary, profile, capabilities, null);
   }
 
+  /**
+   * @deprecated Use {@link FirefoxDriver(Capabilities, Capabilities)} setting the binary and
+   * profile using {@link FirefoxOptions} set as the capability {@link
+   * FirefoxOptions#FIREFOX_OPTIONS}
+   */
+  @Deprecated
   public FirefoxDriver(FirefoxBinary binary, FirefoxProfile profile,
       Capabilities desiredCapabilities, Capabilities requiredCapabilities) {
     this(createCommandExecutor(desiredCapabilities, requiredCapabilities, binary, profile),
@@ -275,19 +293,35 @@ public FirefoxDriver(FirefoxBinary binary, FirefoxProfile profile,
     this.binary = binary;
   }
 
+  /**
+   * @deprecated No replacement.
+   */
+  @Deprecated
   public FirefoxDriver(GeckoDriverService driverService) {
     this(new DriverCommandExecutor(driverService), null, null);
   }
 
+  /**
+   * @deprecated No replacement.
+   */
+  @Deprecated
   public FirefoxDriver(GeckoDriverService driverService, Capabilities desiredCapabilities) {
     this(new DriverCommandExecutor(driverService), desiredCapabilities, null);
   }
 
+  /**
+   * @deprecated No replacement.
+   */
+  @Deprecated
   public FirefoxDriver(GeckoDriverService driverService, Capabilities desiredCapabilities,
       Capabilities requiredCapabilities) {
     this(new DriverCommandExecutor(driverService), desiredCapabilities, requiredCapabilities);
   }
 
+  /**
+   * @deprecated No replacement.
+   */
+  @Deprecated
   private FirefoxDriver(CommandExecutor executor, Capabilities desiredCapabilities,
       Capabilities requiredCapabilities) {
     super(executor,