Roll version of gsutil to 4.15.

third_party/gsutil/gslib/addlhelp/versions.py

 # -*- coding: utf-8 -*-
 # Copyright 2012 Google Inc. All Rights Reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
 #     http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
@@ skipping 125 matching lines @@
 
   Note that there is no limit to the number of older versions of an object you
   will create if you continue to upload to the same object in a versioning-
   enabled bucket. It is your responsibility to delete versions beyond the ones
   you want to retain.
 
 
 <B>COPYING VERSIONED BUCKETS</B>
   You can copy data between two versioned buckets, using a command like:
 
-    gsutil cp -r gs://bucket1/* gs://bucket2
+    gsutil cp -r -A gs://bucket1/* gs://bucket2
 
   When run using versioned buckets, this command will cause every object version
   to be copied. The copies made in gs://bucket2 will have different generation
   numbers (since a new generation is assigned when the object copy is made),
   but the object sort order will remain consistent. For example, gs://bucket1
   might contain:
 
     % gsutil ls -la gs://bucket1 10  2013-06-06T02:33:11Z
     53  2013-02-02T22:30:57Z  gs://bucket1/file#1359844257574000  metageneration=1
     12  2013-02-02T22:30:57Z  gs://bucket1/file#1359844257615000  metageneration=1
     97  2013-02-02T22:30:57Z  gs://bucket1/file#1359844257665000  metageneration=1
 
   and after the copy, gs://bucket2 might contain:
 
     % gsutil ls -la gs://bucket2
     53  2013-06-06T02:33:11Z  gs://bucket2/file#1370485991580000  metageneration=1
     12  2013-06-06T02:33:14Z  gs://bucket2/file#1370485994328000  metageneration=1
     97  2013-06-06T02:33:17Z  gs://bucket2/file#1370485997376000  metageneration=1
 
   Note that the object versions are in the same order (as can be seen by the
   same sequence of sizes in both listings), but the generation numbers (and
   timestamps) are newer in gs://bucket2.
 
-  WARNING: If you use the gsutil -m option when copying the objects (to parallel
-  copy the data), object version ordering will NOT be preserved. All object
-  versions will be copied, but (for example) the latest/live version in the
-  destination bucket might be from one of the earlier versions in the source
-  bucket (and similarly, other versions may be out of order). When copying
-  versioned data it is advisable not to use the gsutil -m option.
 
 
 <B>CONCURRENCY CONTROL</B>
   If you are building an application using Google Cloud Storage, you may need to
   be careful about concurrency control. Normally gsutil itself isn't used for
   this purpose, but it's possible to write scripts around gsutil that perform
   concurrency control.
 
   For example, suppose you want to implement a "rolling update" system using
   gsutil, where a periodic job computes some data and uploads it to the cloud.
@@ skipping 78 matching lines @@
 
   # Help specification. See help_provider.py for documentation.
   help_spec = HelpProvider.HelpSpec(
       help_name='versions',
       help_name_aliases=['concurrency', 'concurrency control'],
       help_type='additional_help',
       help_one_line_summary='Object Versioning and Concurrency Control',
       help_text=_DETAILED_HELP_TEXT,
       subcommand_help_text={},
   )