doc: add description of legacy buf.write() format

The buf.write() method also supports undocumented legacy style
invocation.  As the example of buf.length property uses this form,
a reader can be confused with it.  Add description of these styles
at the end.