Cool tool. I think what would really be the icing on the cake is if it substitued the actual command into the documentation. Removing that one layer of indirection would make it that much easier to understand.

For example:

foo() { bar }

> This defines a function named "foo".

Also that example fails to parse. Even though :() { :|: };: works so it seems like there is a certian amount of special casing.