Returned values in documentation

[paylord]

If I have missed this somewhere then please just point me in the right direction.

It would be great to include what is returned by each command as part of the documentation. If you are using it interactively then it is not really a big issue, but if using commands as part of a longer script then commands are often returned to a variable and we then need to know what is in that variable so it can be used elsewhere in the script.

At the moment I tend to run a command interactively so I can see what is returned but this is obviously not very efficient.

Would others find this useful?

Thanks

Dave