Improve documentation

[ikosmidis]

• Add descriptions of the arguments in the order they appear and keyword arguments
• Add more examples
• Document show and other internals (e.g. obj_quantities, ef_quantities)