TensorFlow: Upstream changes to git.

Changes:
- Docuementation changes.
- Update URL for protobuf submodule.

Base CL: 107345722

Author: keveman

.gitmodules

@@ -1,3 +1,3 @@
 [submodule "google/protobuf"]
 	path = google/protobuf
-	url = https://github.googlesource.com/google/protobuf.git
+	url = https://github.com/google/protobuf.git

tensorflow/g3doc/api_docs/cc/index.md

@@ -26,25 +26,25 @@ write the graph to a file.
 
 ##Classes <a class="md-anchor" id="AUTOGENERATED-classes"></a>
 
-* [tensorflow::Env](ClassEnv.md)
-* [tensorflow::EnvWrapper](ClassEnvWrapper.md)
-* [tensorflow::RandomAccessFile](ClassRandomAccessFile.md)
-* [tensorflow::Session](ClassSession.md)
-* [tensorflow::Status](ClassStatus.md)
-* [tensorflow::Tensor](ClassTensor.md)
-* [tensorflow::TensorBuffer](ClassTensorBuffer.md)
-* [tensorflow::TensorShape](ClassTensorShape.md)
-* [tensorflow::TensorShapeIter](ClassTensorShapeIter.md)
-* [tensorflow::TensorShapeUtils](ClassTensorShapeUtils.md)
-* [tensorflow::Thread](ClassThread.md)
-* [tensorflow::WritableFile](ClassWritableFile.md)
+* [tensorflow::Env](../../api_docs/cc/ClassEnv.md)
+* [tensorflow::EnvWrapper](../../api_docs/cc/ClassEnvWrapper.md)
+* [tensorflow::RandomAccessFile](../../api_docs/cc/ClassRandomAccessFile.md)
+* [tensorflow::Session](../../api_docs/cc/ClassSession.md)
+* [tensorflow::Status](../../api_docs/cc/ClassStatus.md)
+* [tensorflow::Tensor](../../api_docs/cc/ClassTensor.md)
+* [tensorflow::TensorBuffer](../../api_docs/cc/ClassTensorBuffer.md)
+* [tensorflow::TensorShape](../../api_docs/cc/ClassTensorShape.md)
+* [tensorflow::TensorShapeIter](../../api_docs/cc/ClassTensorShapeIter.md)
+* [tensorflow::TensorShapeUtils](../../api_docs/cc/ClassTensorShapeUtils.md)
+* [tensorflow::Thread](../../api_docs/cc/ClassThread.md)
+* [tensorflow::WritableFile](../../api_docs/cc/ClassWritableFile.md)
 
 ##Structs <a class="md-anchor" id="AUTOGENERATED-structs"></a>
 
-* [tensorflow::SessionOptions](StructSessionOptions.md)
-* [tensorflow::Status::State](StructState.md)
-* [tensorflow::TensorShapeDim](StructTensorShapeDim.md)
-* [tensorflow::ThreadOptions](StructThreadOptions.md)
+* [tensorflow::SessionOptions](../../api_docs/cc/StructSessionOptions.md)
+* [tensorflow::Status::State](../../api_docs/cc/StructState.md)
+* [tensorflow::TensorShapeDim](../../api_docs/cc/StructTensorShapeDim.md)
+* [tensorflow::ThreadOptions](../../api_docs/cc/StructThreadOptions.md)
 
 
 <div class='sections-order' style="display: none;">

tensorflow/g3doc/api_docs/python/index.md

@@ -68,8 +68,8 @@ also use MNIST as an example in our technical tutorial where we elaborate on
 TensorFlow features.
 
 ## Recommended Next Steps: <a class="md-anchor" id="AUTOGENERATED-recommended-next-steps-"></a>
-* [Download and Setup](os_setup.md)
-* [Basic Usage](basic_usage.md)
+* [Download and Setup](../get_started/os_setup.md)
+* [Basic Usage](../get_started/basic_usage.md)
 * [TensorFlow Mechanics 101](../tutorials/mnist/tf/index.md)
 
 

tensorflow/g3doc/get_started/index.md

@@ -35,7 +35,7 @@ to:
 * [Verify it works](#AUTOGENERATED-verify-it-works)
 * [Validation](#Validation)
 * [Op registration](#AUTOGENERATED-op-registration)
-  * [Attrs](#AUTOGENERATED-attrs)
+  * [Attrs](#Attrs)
   * [Attr types](#AUTOGENERATED-attr-types)
   * [Polymorphism](#Polymorphism)
   * [Inputs and Outputs](#AUTOGENERATED-inputs-and-outputs)
@@ -51,8 +51,8 @@ to:
 
 You define the interface of an Op by registering it with the TensorFlow system.
 In the registration, you specify the name of your Op, its inputs (types and
-names) and outputs (types and names), as well as [docstrings](#docstrings) and
-any [attrs](#attrs) the Op might require.
+names) and outputs (types and names), as well as docstrings and
+any [attrs](#Attrs) the Op might require.
 
 To see how this works, suppose you'd like to create an Op that takes a tensor of
 `int32`s and outputs a copy of the tensor, with all but the first element set to
@@ -249,7 +249,7 @@ function on error.
 
 ## Op registration <a class="md-anchor" id="AUTOGENERATED-op-registration"></a>
 
-### Attrs <a class="md-anchor" id="AUTOGENERATED-attrs"></a>
+### Attrs <a class="md-anchor" id="Attrs"></a>
 
 Ops can have attrs, whose values are set when the Op is added to a graph. These
 are used to configure the Op, and their values can be accessed both within the

tensorflow/g3doc/how_tos/adding_an_op/index.md

@@ -5,7 +5,7 @@ TensorFlow computation graphs are powerful but complicated. The graph visualizat
 ![Visualization of a TensorFlow graph](./graph_vis_animation.gif "Visualization of a TensorFlow graph")
 *Visualization of a TensorFlow graph.*
 
-To see your own graph, run TensorBoard pointing it to the log directory of the job, click on the graph tab on the top pane and select the appropriate run using the menu at the upper left corner. For in depth information on how to run TensorBoard and make sure you are logging all the necessary information, see [Summaries and TensorBoard](../summaries_and_tensorboard/index.md).
+To see your own graph, run TensorBoard pointing it to the log directory of the job, click on the graph tab on the top pane and select the appropriate run using the menu at the upper left corner. For in depth information on how to run TensorBoard and make sure you are logging all the necessary information, see [Summaries and TensorBoard](../../how_tos/summaries_and_tensorboard/index.md).
 
 ## Name scoping and nodes <a class="md-anchor" id="AUTOGENERATED-name-scoping-and-nodes"></a>
 

tensorflow/g3doc/how_tos/graph_viz/index.md

@@ -6,7 +6,7 @@
 TensorFlow Variables are in-memory buffers containing tensors.  Learn how to
 use them to hold and update model parameters during training.
 
-[View Tutorial](variables/index.md)
+[View Tutorial](../how_tos/variables/index.md)
 
 
 ## TensorFlow Mechanics 101 <a class="md-anchor" id="AUTOGENERATED-tensorflow-mechanics-101"></a>
@@ -25,54 +25,54 @@ your model(s).  This tutorial describes how to build and run TensorBoard as well
 as how to add Summary ops to automatically output data to the Events files that
 TensorBoard uses for display.
 
-[View Tutorial](summaries_and_tensorboard/index.md)
+[View Tutorial](../how_tos/summaries_and_tensorboard/index.md)
 
 
 ## TensorBoard: Graph Visualization <a class="md-anchor" id="AUTOGENERATED-tensorboard--graph-visualization"></a>
 
 This tutorial describes how to use the graph visualizer in TensorBoard to help
 you understand the dataflow graph and debug it.
 
-[View Tutorial](graph_viz/index.md)
+[View Tutorial](../how_tos/graph_viz/index.md)
 
 
 ## Reading Data <a class="md-anchor" id="AUTOGENERATED-reading-data"></a>
 
 This tutorial describes the three main methods of getting data into your
 TensorFlow program: Feeding, Reading and Preloading.
 
-[View Tutorial](reading_data/index.md)
+[View Tutorial](../how_tos/reading_data/index.md)
 
 
 ## Threading and Queues <a class="md-anchor" id="AUTOGENERATED-threading-and-queues"></a>
 
 This tutorial describes the various constructs implemented by TensorFlow
 to facilitate asynchronous and concurrent training.
 
-[View Tutorial](threading_and_queues/index.md)
+[View Tutorial](../how_tos/threading_and_queues/index.md)
 
 
 ## Adding a New Op <a class="md-anchor" id="AUTOGENERATED-adding-a-new-op"></a>
 
 TensorFlow already has a large suite of node operations from which you can
 compose in your graph, but here are the details of how to add you own custom Op.
 
-[View Tutorial](adding_an_op/index.md)
+[View Tutorial](../how_tos/adding_an_op/index.md)
 
 
 ## Custom Data Readers <a class="md-anchor" id="AUTOGENERATED-custom-data-readers"></a>
 
 If you have a sizable custom data set, you may want to consider extending
 TensorFlow to read your data directly in it's native format.  Here's how.
 
-[View Tutorial](new_data_formats/index.md)
+[View Tutorial](../how_tos/new_data_formats/index.md)
 
 
 ## Using GPUs <a class="md-anchor" id="AUTOGENERATED-using-gpus"></a>
 
 This tutorial describes how to construct and execute models on GPU(s).
 
-[View Tutorial](using_gpu/index.md)
+[View Tutorial](../how_tos/using_gpu/index.md)
 
 
 ## Sharing Variables <a class="md-anchor" id="AUTOGENERATED-sharing-variables"></a>
@@ -83,7 +83,7 @@ different locations in the model construction code.
 
 The "Variable Scope" mechanism is designed to facilitate that.
 
-[View Tutorial](variable_scope/index.md)
+[View Tutorial](../how_tos/variable_scope/index.md)
 
 <div class='sections-order' style="display: none;">
 <!--

tensorflow/g3doc/how_tos/index.md

@@ -94,7 +94,7 @@ helper functions from
 without modifying any arguments.
 
 Next you will create the actual Reader op.  It will help if you are familiar
-with [the adding an op how-to](../adding_an_op/index.md).  The main steps
+with [the adding an op how-to](../../how_tos/adding_an_op/index.md).  The main steps
 are:
 
 *   Registering the op.
@@ -122,7 +122,7 @@ REGISTER_OP("TextLineReader")
 A Reader that outputs the lines of a file delimited by '\n'.
 )doc");
 ```
-    
+
 To define an `OpKernel`, Readers can use the shortcut of descending from
 `ReaderOpKernel`, defined in
 [tensorflow/core/framework/reader_op_kernel.h](https://tensorflow.googlesource.com/tensorflow/+/master/tensorflow/core/framework/reader_op_kernel.h),
@@ -199,7 +199,7 @@ You can see some examples in
 ## Writing an Op for a record format <a class="md-anchor" id="AUTOGENERATED-writing-an-op-for-a-record-format"></a>
 
 Generally this is an ordinary op that takes a scalar string record as input, and
-so follow [the instructions to add an Op](../adding_an_op/index.md).  You may
+so follow [the instructions to add an Op](../../how_tos/adding_an_op/index.md).  You may
 optionally take a scalar string key as input, and include that in error messages
 reporting improperly formatted data.  That way users can more easily track down
 where the bad data came from.

tensorflow/g3doc/how_tos/new_data_formats/index.md

@@ -266,7 +266,7 @@ This can be important:
 How many threads do you need? the `tf.train.shuffle_batch*` functions add a
 summary to the graph that indicates how full the example queue is. If you have
 enough reading threads, that summary will stay above zero.  You can
-[view your summaries as training progresses using TensorBoard](../summaries_and_tensorboard/index.md).
+[view your summaries as training progresses using TensorBoard](../../how_tos/summaries_and_tensorboard/index.md).
 
 ### Creating threads to prefetch using `QueueRunner` objects <a class="md-anchor" id="QueueRunner"></a>
 
@@ -355,7 +355,7 @@ threads got an error when running some operation (or an ordinary Python
 exception).
 
 For more about threading, queues, QueueRunners, and Coordinators
-[see here](../threading_and_queues/index.md).
+[see here](../../how_tos/threading_and_queues/index.md).
 
 #### Aside: How clean shut-down when limiting epochs works <a class="md-anchor" id="AUTOGENERATED-aside--how-clean-shut-down-when-limiting-epochs-works"></a>
 
@@ -493,4 +493,4 @@ This is what is done in
 
 You can have the train and eval in the same graph in the same process, and share
 their trained variables.  See
-[the shared variables tutorial](../variable_scope/index.md).
+[the shared variables tutorial](../../how_tos/variable_scope/index.md).

tensorflow/g3doc/how_tos/reading_data/index.md

@@ -105,4 +105,4 @@ not contain any data relevant to that tab, a message will be displayed
 indicating how to serialize data that is applicable to that tab.
 
 For in depth information on how to use the *graph* tab to visualize your graph,
-see [TensorBoard: Visualizing your graph](../graph_viz/index.md).
+see [TensorBoard: Visualizing your graph](../../how_tos/graph_viz/index.md).