Standard python file handle does not fly - update docs

The fact that most functions in libecl cannot work on a standard Python file handle, but needs a `cwrap.open` file handle is severely under communicated. Arguments are named `pyfile` etc. See `EclGrid.save_grdecl` as an example.