Show desired effect in javadoc

Unfortunately, <blink> tags are no longer supported by most browsers.
Fortunately, modern CSS has got our back, in this throwback to the
spooky way the web used to be.

Author: illicitonion

Rakefile

@@ -327,6 +327,7 @@ ie_generate_type_mapping(:name => "ie_result_type_java",
 
 
 task :javadocs => [:'repack-jetty', :common, :firefox, :ie, :remote, :support, :chrome, :selenium] do
+  rm_rf "build/javadoc"
   mkdir_p "build/javadoc"
    sourcepath = ""
    classpath = '.'
@@ -339,6 +340,7 @@ task :javadocs => [:'repack-jetty', :common, :firefox, :ie, :remote, :support, :
    [File.join(%w(java server src))].each do |m|
      sourcepath += File::PATH_SEPARATOR + m
    end
+
    p sourcepath
    cmd = "javadoc -notimestamp -d build/javadoc -sourcepath #{sourcepath} -classpath #{classpath} -subpackages org.openqa.selenium -subpackages com.thoughtworks "
    cmd << " -exclude org.openqa.selenium.internal.selenesedriver:org.openqa.selenium.internal.seleniumemulation:org.openqa.selenium.remote.internal"
@@ -347,6 +349,23 @@ task :javadocs => [:'repack-jetty', :common, :firefox, :ie, :remote, :support, :
      cmd = cmd.gsub(/\//, "\\").gsub(/:/, ";")
    end
    sh cmd
+
+   File.open("build/javadoc/stylesheet.css", "a") { |file| file.write(<<EOF
+
+/* Custom selenium-specific styling */
+.blink {
+  animation: 2s cubic-bezier(0.5, 0, 0.85, 0.85) infinite blink;
+}
+
+@keyframes blink {
+  50% {
+    opacity: 0;
+  }
+}
+
+EOF
+)
+   }
 end
 
 task :py_prep_for_install_release => [

java/client/src/org/openqa/selenium/Beta.java

@@ -28,7 +28,7 @@
  * be relied upon. The update policy for anything marked beta is that it may be
  * deleted in the next Selenium release without warning.
  *
- * In the ideal world, this would cause the method to blink gently in the user's
+ * In the ideal world, this would cause the method to <span class="blink">blink gently</span> in the user's
  * IDE. We don't live in the ideal world. We'll find out the hard way whether
  * reading docs is the same thing.
  */