[tahoe-lafs-trac-stream] [Tahoe-LAFS] #2461: IReadable.read should document out-of-range errors

[Tahoe-LAFS]

#2461: IReadable.read should document out-of-range errors
-------------------------------+-----------------------------
     Reporter:  daira          |      Owner:  daira
         Type:  defect         |     Status:  new
     Priority:  normal         |  Milestone:  1.10.2
    Component:  documentation  |    Version:  1.10.1
   Resolution:                 |   Keywords:  interfaces docs
Launchpad Bug:                 |
-------------------------------+-----------------------------

Comment (by zooko):

 I think the behavior ought to be to return a short result, i.e. return as
 many bytes as *do* exist and fall within the requested range, and return
 the 0-length string if none do. That way clients can issue range read
 requests without knowing for sure whether the request will start past the
 end or cross the end, which can allow them to do fewer round trips, maybe,
 in some cases.

--
Ticket URL: <https://tahoe-lafs.org/trac/tahoe-lafs/ticket/2461#comment:2>
Tahoe-LAFS <https://Tahoe-LAFS.org>
secure decentralized storage