diff --git a/flux-commands.md b/flux-commands.md
index b15c12d..a750e7c 100644
--- a/flux-commands.md
+++ b/flux-commands.md
@@ -114,8 +114,9 @@ decode-html
 
 decode-json
 -----------
-- options:	recordid (String), recordcount (int), arraymarker (String), arrayname (String), allowcomments (boolean)
-- signature:	<unknown> -> 
+- description:	Decodes JSON to metadata events. The 'recordPath' option can be used to set a JsonPath to extract a path as JSON - or to split the data into multiple JSON documents.
+- options:	recordid (String), recordcount (int), arraymarker (String), arrayname (String), recordpath (String), allowcomments (boolean)
+- signature:	String -> StreamReceiver
 - java class:	org.metafacture.json.JsonDecoder
 
 decode-mab