Roll version of gsutil to 4.15.

third_party/gsutil/gslib/addlhelp/wildcards.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 80 matching lines @@
   [char range]
     Match any of the range of characters. For example
     "gs://bucket/[a-m].txt" matches objects that contain letters
     a, b, c, ... or m, and end with .txt.
 
   You can combine wildcards to provide more powerful matches, for example:
 
     gs://bucket/[a-m]??.j*g
 
 
+<B>DIFFERENT BEHAVIOR FOR "DOT" FILES IN LOCAL FILE SYSTEM</B>
+  Per standard Unix behavior, the wildcard "*" only matches files that don't
+  start with a "." character (to avoid confusion with the "." and ".."
+  directories present in all Unix directories). gsutil provides this same
+  behavior when using wildcards over a file system URI, but does not provide
+  this behavior over cloud URIs. For example, the following command will copy
+  all objects from gs://bucket1 to gs://bucket2:
+
+    gsutil cp gs://bucket1/* gs://bucket2
+
+  but the following command will copy only files that don't start with a "."
+  from the directory "dir" to gs://bucket1:
+
+    gsutil cp dir/* gs://bucket1
+
+
 <B>EFFICIENCY CONSIDERATION: USING WILDCARDS OVER MANY OBJECTS</B>
   It is more efficient, faster, and less network traffic-intensive
   to use wildcards that have a non-wildcard object-name prefix, like:
 
     gs://bucket/abc*.txt
 
   than it is to use wildcards as the first part of the object name, like:
 
     gs://bucket/*abc.txt
 
@@ skipping 58 matching lines @@
 
   # Help specification. See help_provider.py for documentation.
   help_spec = HelpProvider.HelpSpec(
       help_name='wildcards',
       help_name_aliases=['wildcard', '*', '**'],
       help_type='additional_help',
       help_one_line_summary='Wildcard Names',
       help_text=_DETAILED_HELP_TEXT,
       subcommand_help_text={},
   )