[tahoe-lafs-trac-stream] [tahoe-lafs] #1534: Some docs in mutable/layout.py are slightly confusing.

[tahoe-lafs]

#1534: Some docs in mutable/layout.py are slightly confusing.
------------------------------+--------------------------------
     Reporter:  zancas        |      Owner:  kevan
         Type:  defect        |     Status:  new
     Priority:  minor         |  Milestone:  undecided
    Component:  code-mutable  |    Version:  1.9.0a1
   Resolution:                |   Keywords:  docs review-needed
Launchpad Bug:                |
------------------------------+--------------------------------
Changes (by zooko):

 * owner:  zooko => kevan


Comment:

 * Let's just avoid the word "character", which could mean something other
 than a byte in certain contexts (e.g. a unicode character), in favor of
 the word "byte", which never means anything else. :-)
 * I don't understand [http://tahoe-lafs.org/trac/tahoe-
 lafs/browser/trunk/src/allmydata/mutable/layout.py?annotate=blame&rev=5246#L38
 this doc]:
 {{{
 The data length of the uploaded file. Modulo padding, this will be
 the same of the data length field. Like the data length field, it is
 an unsigned long long and can be quite large.
 }}}
 Maybe one of those places where it says "data length" it meant to say
 something else?

-- 
Ticket URL: <http://tahoe-lafs.org/trac/tahoe-lafs/ticket/1534#comment:1>
tahoe-lafs <http://tahoe-lafs.org>
secure decentralized storage