[tahoe-dev] [tahoe-lafs] #776: users are confused by "tahoe rm"

[tahoe-lafs]

#776: users are confused by "tahoe rm"
------------------------------------------+---------------------------------
 Reporter:  zooko                         |           Owner:  davidsarah
     Type:  defect                        |          Status:  new       
 Priority:  major                         |       Milestone:  1.7.0     
Component:  code-frontend-cli             |         Version:  1.4.1     
 Keywords:  docs usability tahoe-rm easy  |   Launchpad_bug:            
------------------------------------------+---------------------------------

Comment(by kevan):

 It'd also be nice if this:

 {{{
 nicolas at ubuntu /tmp/tahoe-c$ ~/src/allmydata-tahoe-1.4.1/bin/tahoe rm
 URI:CHK:2nxmn6eew3y5e5y7ejzwfr2jiq:6mi2hcbpuvkfcttuezi4x3fxwrnmwidql2rtwwtczpccxgz3ez2q:3:10:310946
       Traceback (most recent call last):
         File "/home/nicolas/src/allmydata-tahoe-1.4.1/support/bin/tahoe",
 line 8, in <module>
           load_entry_point('allmydata-tahoe==1.4.1', 'console_scripts',
 'tahoe')()
         File "/home/nicolas/src/allmydata-
 tahoe-1.4.1/src/allmydata/scripts/runner.py", line 91, in run
           rc = runner(sys.argv[1:])
         File "/home/nicolas/src/allmydata-
 tahoe-1.4.1/src/allmydata/scripts/runner.py", line 78, in runner
           rc = cli.dispatch[command](so)
         File "/home/nicolas/src/allmydata-
 tahoe-1.4.1/src/allmydata/scripts/cli.py", line 409, in rm
           rc = tahoe_rm.rm(options)
         File "/home/nicolas/src/allmydata-
 tahoe-1.4.1/src/allmydata/scripts/tahoe_rm.py", line 25, in rm
           assert path
       AssertionError
 }}}

 said something like this:

 {{{
 nicolas at ubuntu /tmp/tahoe-c$ ~/src/allmydata-tahoe-1.4.1/bin/tahoe rm
 URI:CHK:2nxmn6eew3y5e5y7ejzwfr2jiq:6mi2hcbpuvkfcttuezi4x3fxwrnmwidql2rtwwtczpccxgz3ez2q:3:10:310946
 error: 'tahoe rm' can only be used to unlink a file within a directory.
 Please specify the file that you wish to unlink as alias:path/to/file.
 }}}

 or something similar. Users are rightly confused if our CLI tools output
 stack traces instead of meaningful error messages; see
 http://allmydata.org/pipermail/tahoe-dev/2010-February/003950.html for a
 recent example.

 (the first exception message should have been fixed in #939; the second in
 #771)

-- 
Ticket URL: <http://allmydata.org/trac/tahoe/ticket/776#comment:9>
tahoe-lafs <http://allmydata.org>
secure decentralized file storage grid