[tahoe-lafs-trac-stream] [tahoe-lafs] #1372: clarify help for 'tahoe put --mutable'

[tahoe-lafs]

#1372: clarify help for 'tahoe put --mutable'
-------------------------+-------------------------------------------------
     Reporter:           |      Owner:  davidsarah
  davidsarah             |     Status:  assigned
         Type:  defect   |  Milestone:  1.10.0
     Priority:  minor    |    Version:  1.8.2
    Component:  code-    |   Keywords:  tahoe-put mutable usability help
  frontend-cli           |  docs easy
   Resolution:           |
Launchpad Bug:           |
-------------------------+-------------------------------------------------

Old description:

> A user was confused by the fact that {{{tahoe put -m LOCAL_FILE
> REMOTE_FILE}}} will overwrite the contents of REMOTE_FILE if it already
> exists (and therefore will print the same URI on each run):
>
> http://tahoe-lafs.org/pipermail/tahoe-dev/2011-February/006186.html
>
> The help for {{{tahoe put}}} is not sufficiently clear about the
> behaviour in this case.

New description:

 A user was confused by the fact that {{{tahoe put -m LOCAL_FILE
 REMOTE_FILE}}} will overwrite the contents of REMOTE_FILE if it already
 exists (and therefore will print the same URI on each run):

 http://tahoe-lafs.org/pipermail/tahoe-dev/2011-February/006186.html

 The help for {{{tahoe put}}} is not sufficiently clear about the behaviour
 in this case.

--

Comment (by davidsarah):

 Please review: [https://github.com/davidsarah/tahoe-lafs/commit/1372
 -tahoe-put-help].

-- 
Ticket URL: <https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1372#comment:4>
tahoe-lafs <https://tahoe-lafs.org>
secure decentralized storage