Add new --[dst-]container info to documentation
authorStavros Sachtouris <saxtouri@admin.grnet.gr>
Wed, 30 Jan 2013 13:45:12 +0000 (15:45 +0200)
committerStavros Sachtouris <saxtouri@admin.grnet.gr>
Wed, 30 Jan 2013 13:45:12 +0000 (15:45 +0200)
docs/commands.rst
kamaki/cli/commands/cyclades_cli.py

index ed2e44f..22a4d59 100644 (file)
@@ -298,7 +298,7 @@ store (Storage/Pithos+)
     append        :  Append local file to remote
     cat           :  Print a file to console
     copy          :  Copy an object
-    create        :  Create a container or a directory object
+    create        :  Create a container
     delete        :  Delete a container [or an object]
     delgroup      :  Delete a user group on an account
     delmeta       :  Delete an existing metadatum of account [, container [or object]]
@@ -323,6 +323,7 @@ store (Storage/Pithos+)
     setquota      :  Set new quota (in KB) for account [or container]
     setversioning :  Set new versioning (auto, none) for account [or container]
     sharers       :  List the accounts that share objects with default account
+    touch         :  Create an empty object (file)
     truncate      :  Truncate remote file up to a size
     unpublish     :  Unpublish an object
     upload        :  Upload a file
@@ -405,3 +406,7 @@ Showcase: Upload and download a file
     [store]:!diff rndm_local.file rndm_remote.file
 
 .. Note:: In kamaki shell, ! is used to execute OS shell commands (bash in the above)
+
+.. warning:: The container:object/path syntax does not function if the container and / or the object path contain one or more : characters. To use containers and objects with : use the --container and --dst-container arguments, e.g. to copy test.py object from grnet:dev container to grnet:deploy ::
+
+        $ kamaki store copy --container=grnet:dev test.py --dst-container=grnet:deploy
index e0a6139..1158410 100644 (file)
@@ -55,7 +55,7 @@ network_cmds = CommandTree('network',
 _commands = [server_cmds, flavor_cmds, image_cmds, network_cmds]
 
 
-about_authentication = '\n  User Authentication:\
+about_authentication = '\nUser Authentication:\
     \n* to check authentication: /astakos authenticate\
     \n* to set authentication token: /config set token <token>'
 
@@ -84,8 +84,7 @@ class _init_cyclades(_command_init):
 
 @command(server_cmds)
 class server_list(_init_cyclades):
-    """List Virtual Machines accessible by user
-    """
+    """List Virtual Machines accessible by user"""
 
     __doc__ += about_authentication