further extend documentation and improve final_show

final_show will now show no window if there haven't been any prior
calls.