[tahoe-dev] webapi updates

[zooko]

Folks (especially Brian):

I'm refactoring the webapi doc [1] to discourage users from thinking  
that they know in advance whether an object in a vdrive is a file or  
a directory.  Along the way I noticed this part:

"""
   Note that since tahoe URIs may contain slashes (in particular,  
dirnode URIs
   contain a FURL, which resembles a regular HTTP URL and starts with  
pb://),
   when URIs are used in this form, they must be specially quoted.  
All slashes
   in the URI must be replaced by '!' characters.
"""

What do you think about redefining dirnode URI's to not contain the  
"pb://" characters?  And likewise for other slashes in our URIs, so  
that users of the URIs can treat them as opaque strings that don't  
need to be examined or manipulated.

Regards,

Zooko

[1] http://allmydata.org/trac/tahoe/browser/docs/webapi.txt