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.