fixup the documentation of the Picture module
rename current_terminal to output_for_current_terminal etc. plus doc fixups