please update the documents

[farhad-b]

it seems the documents are way out of date.
I must try every command to see what is the output and it usually doesn't match the documents and there are important differences.
sometimes it leads to losing money in order to get the right output format (because I need to place some buy/sell orders to check various outputs types on various commands)
please fix this