From: Stavros Sachtouris <saxtouri@admin.grnet.gr>
Date: Wed, 30 Jan 2013 13:45:12 +0000 (+0200)
Subject: Add new --[dst-]container info to documentation
X-Git-Tag: 0.9rc1~61^2~26
X-Git-Url: https://code.grnet.gr/git/kamaki/commitdiff_plain/c314fc10bb866854a8c1efa4af96b69213bec3cf

Add new --[dst-]container info to documentation
---

diff --git a/docs/commands.rst b/docs/commands.rst
index ed2e44f..22a4d59 100644
--- a/docs/commands.rst
+++ b/docs/commands.rst
@@ -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
diff --git a/kamaki/cli/commands/cyclades_cli.py b/kamaki/cli/commands/cyclades_cli.py
index e0a6139..1158410 100644
--- a/kamaki/cli/commands/cyclades_cli.py
+++ b/kamaki/cli/commands/cyclades_cli.py
@@ -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