Cleaned up blob inspector doc (#3284)

docs/source/blob-inspector.rst

@@ -14,8 +14,12 @@ To run simply pass in the file or URL as the first parameter:
 
 Use the ``--help`` flag for a full list of command line options.
 
-``SerializedBytes`
-~~~~~~~~~~~~~~~~~~
+When inspecting your custom data structures, there's no need to include the jars containing the class definitions for them
+in the classpath. The blob inspector (or rather the serialization framework) is able to synthesis any classes found in the
+blob that aren't on the classpath.
+
+SerializedBytes
+~~~~~~~~~~~~~~~
 
 One thing to note is that the binary blob may contain embedded ``SerializedBytes`` objects. Rather than printing these
 out as a Base64 string, the blob inspector will first materialise them into Java objects and then output those. You will
@@ -23,9 +27,9 @@ see this when dealing with classes such as ``SignedData`` or other structures th
 ``nodeInfo-*`` files or the ``network-parameters`` file in the node's directory. For example, the output of a node-info
 file may look like:
 
-.. container:: codeset
 
-    .. sourcecode:: yaml
+**-\\-format=YAML**
+::
 
     net.corda.nodeapi.internal.SignedNodeInfo
     ---
@@ -33,30 +37,30 @@ file may look like:
       class: "net.corda.core.node.NodeInfo"
       deserialized:
         addresses:
-            - "localhost:10011"
+        - "localhost:10005"
         legalIdentitiesAndCerts:
-            - "O=BankOfCorda, L=New York, C=US"
+        - "O=BankOfCorda, L=London, C=GB"
         platformVersion: 4
-            serial: 1527074180971
+        serial: 1527851068715
     signatures:
-        - !!binary |
-          dmoAnnzcv0MzRN+3ZSCDcCJIAbXnoYy5mFWB3Nijndzu/dzIoYdIawINXbNSY/5z2XloDK01vZRV
-          TreFZCbZAg==
+    - !!binary |-
+      VFRy4frbgRDbCpK1Vo88PyUoj01vbRnMR3ROR2abTFk7yJ14901aeScX/CiEP+CDGiMRsdw01cXt\nhKSobAY7Dw==
 
-    .. sourcecode:: json
+**-\\-format=JSON**
+::
 
     net.corda.nodeapi.internal.SignedNodeInfo
     {
       "raw" : {
         "class" : "net.corda.core.node.NodeInfo",
         "deserialized" : {
-              "addresses" : [ "localhost:10011" ],
-              "legalIdentitiesAndCerts" : [ "O=BankOfCorda, L=New York, C=US" ],
+          "addresses" : [ "localhost:10005" ],
+          "legalIdentitiesAndCerts" : [ "O=BankOfCorda, L=London, C=GB" ],
           "platformVersion" : 4,
-              "serial" : 1527074180971
+          "serial" : 1527851068715
         }
       },
-          "signatures" : [ "dmoAnnzcv0MzRN+3ZSCDcCJIAbXnoYy5mFWB3Nijndzu/dzIoYdIawINXbNSY/5z2XloDK01vZRVTreFZCbZAg==" ]
+      "signatures" : [ "VFRy4frbgRDbCpK1Vo88PyUoj01vbRnMR3ROR2abTFk7yJ14901aeScX/CiEP+CDGiMRsdw01cXthKSobAY7Dw==" ]
     }
 
 Notice the file is actually a serialised ``SignedNodeInfo`` object, which has a ``raw`` property of type ``SerializedBytes<NodeInfo>``.