Re-generate all readmes

Author: Jon Wayne Parrott

bigquery/api/README.rst

@@ -26,7 +26,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already

bigquery/cloud-client/README.rst

@@ -26,7 +26,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already

bigquery/dml/README.rst

@@ -27,7 +27,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already

bigquery/rest/README.rst

@@ -26,7 +26,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already

bigtable/hello/README.rst

@@ -26,7 +26,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already

bigtable/hello_happybase/README.rst

@@ -33,7 +33,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already

datastore/cloud-client/README.rst

@@ -26,7 +26,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already

dns/api/README.rst

@@ -26,7 +26,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already

error_reporting/README.rst

@@ -27,7 +27,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already

kms/api-client/README.rst

@@ -26,7 +26,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already

language/api/README.rst

@@ -26,7 +26,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already

language/cloud-client/v1/README.rst

@@ -26,7 +26,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already

language/cloud-client/v1beta2/README.rst

@@ -26,7 +26,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already

language/tutorial/README.rst

@@ -0,0 +1,97 @@
+.. This file is automatically generated. Do not edit this file directly.
+
+Google Cloud Natural Language Tutorial Python Samples
+===============================================================================
+
+This directory contains samples for Google Cloud Natural Language Tutorial. The `Google Cloud Natural Language API`_ provides natural language understanding technologies to developers, including sentiment analysis, entity recognition, and syntax analysis. This API is part of the larger Cloud Machine Learning API.
+
+
+
+
+.. _Google Cloud Natural Language Tutorial: https://cloud.google.com/natural-language/docs/ 
+
+Setup
+-------------------------------------------------------------------------------
+
+
+Authentication
+++++++++++++++
+
+Authentication is typically done through `Application Default Credentials`_,
+which means you do not have to change the code to authenticate as long as
+your environment has credentials. You have a few options for setting up
+authentication:
+
+#. When running locally, use the `Google Cloud SDK`_
+
+    .. code-block:: bash
+
+        gcloud auth application-default login
+
+
+#. When running on App Engine or Compute Engine, credentials are already
+   set-up. However, you may need to configure your Compute Engine instance
+   with `additional scopes`_.
+
+#. You can create a `Service Account key file`_. This file can be used to
+   authenticate to Google Cloud Platform services from any environment. To use
+   the file, set the ``GOOGLE_APPLICATION_CREDENTIALS`` environment variable to
+   the path to the key file, for example:
+
+    .. code-block:: bash
+
+        export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service_account.json
+
+.. _Application Default Credentials: https://cloud.google.com/docs/authentication#getting_credentials_for_server-centric_flow
+.. _additional scopes: https://cloud.google.com/compute/docs/authentication#using
+.. _Service Account key file: https://developers.google.com/identity/protocols/OAuth2ServiceAccount#creatinganaccount
+
+Install Dependencies
+++++++++++++++++++++
+
+#. Install `pip`_ and `virtualenv`_ if you do not already have them.
+
+#. Create a virtualenv. Samples are compatible with Python 2.7 and 3.4+.
+
+    .. code-block:: bash
+
+        $ virtualenv env
+        $ source env/bin/activate
+
+#. Install the dependencies needed to run the samples.
+
+    .. code-block:: bash
+
+        $ pip install -r requirements.txt
+
+.. _pip: https://pip.pypa.io/
+.. _virtualenv: https://virtualenv.pypa.io/
+
+Samples
+-------------------------------------------------------------------------------
+
+Language tutorial
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+
+
+To run this sample:
+
+.. code-block:: bash
+
+    $ python tutorial.py
+
+    usage: tutorial.py [-h] movie_review_filename
+    
+    positional arguments:
+      movie_review_filename
+                            The filename of the movie review you'd like to
+                            analyze.
+    
+    optional arguments:
+      -h, --help            show this help message and exit
+
+
+
+
+.. _Google Cloud SDK: https://cloud.google.com/sdk/

logging/api-client/README.rst

@@ -26,7 +26,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already

logging/cloud-client/README.rst

@@ -26,7 +26,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already

monitoring/api/v2/README.rst

@@ -26,7 +26,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already

monitoring/api/v3/api-client/README.rst

@@ -26,7 +26,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already

monitoring/api/v3/cloud-client/README.rst

@@ -28,7 +28,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already
@@ -95,16 +95,17 @@ To run this sample:
 
     $ python snippets.py
 
-    usage: snippets.py [-h] [--project_id PROJECT_ID]
-                       {create-metric-descriptor,list-metric-descriptors,delete-metric-descriptor,list-resources,get-resource,write-time-series,list-time-series,list-time-series-header,list-time-series-reduce,list-time-series-aggregate}
+    usage: snippets.py [-h]
+                       {create-metric-descriptor,list-metric-descriptors,get-metric-descriptor,delete-metric-descriptor,list-resources,get-resource,write-time-series,list-time-series,list-time-series-header,list-time-series-reduce,list-time-series-aggregate}
                        ...
     
     Demonstrates Monitoring API operations.
     
     positional arguments:
-      {create-metric-descriptor,list-metric-descriptors,delete-metric-descriptor,list-resources,get-resource,write-time-series,list-time-series,list-time-series-header,list-time-series-reduce,list-time-series-aggregate}
+      {create-metric-descriptor,list-metric-descriptors,get-metric-descriptor,delete-metric-descriptor,list-resources,get-resource,write-time-series,list-time-series,list-time-series-header,list-time-series-reduce,list-time-series-aggregate}
         create-metric-descriptor
         list-metric-descriptors
+        get-metric-descriptor
         delete-metric-descriptor
         list-resources
         get-resource
@@ -116,8 +117,6 @@ To run this sample:
     
     optional arguments:
       -h, --help            show this help message and exit
-      --project_id PROJECT_ID
-                            Your cloud project ID.
 
 
 

pubsub/cloud-client/README.rst

@@ -26,7 +26,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already

spanner/cloud-client/README.rst

@@ -26,7 +26,7 @@ authentication:
 
     .. code-block:: bash
 
-        gcloud beta auth application-default login
+        gcloud auth application-default login
 
 
 #. When running on App Engine or Compute Engine, credentials are already
@@ -81,9 +81,9 @@ To run this sample:
 
     $ python snippets.py
 
-    usage: snippets.py [-h] [--database-name DATABASE_NAME]
-                       instance_name
-                       {insert_data,query_data,read_data,update_data,read_write_transaction,query_data_with_index,read_data_with_index,read_data_with_storing_index}
+    usage: snippets.py [-h] [--database-id DATABASE_ID]
+                       instance_id
+                       {create_database,insert_data,query_data,read_data,add_column,update_data,query_data_with_new_column,read_write_transaction,read_only_transaction,add_index,query_data_with_index,read_data_with_index,add_storing_index,read_data_with_storing_index}
                        ...
     
     This application demonstrates how to do basic operations using Cloud
@@ -92,26 +92,42 @@ To run this sample:
     For more information, see the README.rst under /spanner.
     
     positional arguments:
-      instance_name         Your Cloud Spanner instance name.
-      {insert_data,query_data,read_data,update_data,read_write_transaction,query_data_with_index,read_data_with_index,read_data_with_storing_index}
+      instance_id           Your Cloud Spanner instance ID.
+      {create_database,insert_data,query_data,read_data,add_column,update_data,query_data_with_new_column,read_write_transaction,read_only_transaction,add_index,query_data_with_index,read_data_with_index,add_storing_index,read_data_with_storing_index}
+        create_database     Creates a database and tables for sample data.
         insert_data         Inserts sample data into the given database. The
                             database and table must already exist and can be
                             created using `create_database`.
         query_data          Queries sample data from the database using SQL.
         read_data           Reads sample data from the database.
+        add_column          Adds a new column to the Albums table in the example
+                            database.
         update_data         Updates sample data in the database. This updates the
                             `MarketingBudget` column which must be created before
-                            running this sample. Run the following query on your
-                            database to create the column: ALTER TABLE Albums ADD
-                            COLUMN MarketingBudget INT64
+                            running this sample. You can add the column by running
+                            the `add_column` sample or by running this DDL
+                            statement against your database: ALTER TABLE Albums
+                            ADD COLUMN MarketingBudget INT64
+        query_data_with_new_column
+                            Queries sample data from the database using SQL. This
+                            sample uses the `MarketingBudget` column. You can add
+                            the column by running the `add_column` sample or by
+                            running this DDL statement against your database:
+                            ALTER TABLE Albums ADD COLUMN MarketingBudget INT64
         read_write_transaction
                             Performs a read-write transaction to update two sample
                             records in the database. This will transfer 200,000
-                            from the `MarketingBudget` field for the first Album
-                            to the second Album. If the `MarketingBudget` is too
+                            from the `MarketingBudget` field for the second Album
+                            to the first Album. If the `MarketingBudget` is too
                             low, it will raise an exception. Before running this
                             sample, you will need to run the `update_data` sample
                             to populate the fields.
+        read_only_transaction
+                            Reads data inside of a read-only transaction. Within
+                            the read-only transaction, or "snapshot", the
+                            application sees consistent view of the database at a
+                            particular timestamp.
+        add_index           Adds a simple index to the example database.
         query_data_with_index
                             Inserts sample data into the given database. The
                             database and table must already exist and can be
@@ -120,15 +136,16 @@ To run this sample:
                             Inserts sample data into the given database. The
                             database and table must already exist and can be
                             created using `create_database`.
+        add_storing_index   Adds an storing index to the example database.
         read_data_with_storing_index
                             Inserts sample data into the given database. The
                             database and table must already exist and can be
                             created using `create_database`.
     
     optional arguments:
       -h, --help            show this help message and exit
-      --database-name DATABASE_NAME
-                            Your Cloud Spanner database name.
+      --database-id DATABASE_ID
+                            Your Cloud Spanner database ID.