Adding Java docs for Serialization, and discovered some flaws with the Java API, that have been fixed

akka-docs/scala/code/akka/docs/extension/SerializationDocSpec.scala

@@ -1,31 +0,0 @@
-/**
- * Copyright (C) 2009-2011 Typesafe Inc. <http://www.typesafe.com>
- */
-package akka.docs.extension
-
-import org.scalatest.WordSpec
-import org.scalatest.matchers.MustMatchers
-
-class SerializationDocSpec extends WordSpec with MustMatchers {
-
-  "demonstrate how to use Serialization" in {
-    """
-     serializers {
-      # java = "akka.serialization.JavaSerializer"
-      # proto = "akka.serialization.ProtobufSerializer"
-
-      default = "akka.serialization.JavaSerializer"
-    }
-
-    # serialization-bindings {
-    #   java = ["akka.serialization.SerializeSpec$Address",
-    #           "akka.serialization.MyJavaSerializableActor",
-    #           "akka.serialization.MyStatelessActorWithMessagesInMailbox",
-    #           "akka.serialization.MyActorWithProtobufMessagesInMailbox"]
-    #   proto = ["com.google.protobuf.Message",
-    #            "akka.actor.ProtobufProtocol$MyMessage"]
-    # }
-    """
-  }
-
-}

akka-docs/scala/code/akka/docs/serialization/SerializationDocSpec.scala

@@ -5,17 +5,12 @@ package akka.docs.serialization
 
 import org.scalatest.matchers.MustMatchers
 import akka.testkit._
+//#imports
 import akka.actor.ActorSystem
+import akka.serialization._
 import com.typesafe.config.ConfigFactory
 
 //#imports
-import akka.serialization._
-
-//#imports
-
-object SerializationDocSpec {
-
-}
 
 //#my-own-serializer
 class MyOwnSerializer extends Serializer {
@@ -26,7 +21,7 @@ class MyOwnSerializer extends Serializer {
   // Pick a unique identifier for your Serializer,
   // you've got a couple of billions to choose from,
   // 0 - 16 is reserved by Akka itself
-  def identifier = 1234567: Serializer.Identifier
+  def identifier = 1234567
 
   // "toBinary" serializes the given object to an Array of Bytes
   def toBinary(obj: AnyRef): Array[Byte] = {