update api-guides to v1.10

Author: leviding

api_guides/cc/guide.md

@@ -7,6 +7,12 @@ You should, as a result, be sure you are following the
 [`master` version of this doc](https://www.tensorflow.org/versions/master/api_guides/cc/guide),
 in case there have been any changes.
 
+Note: The C++ API is only designed to work with TensorFlow `bazel build`.
+If you need a stand-alone option use the [C-api](../../install/lang_c.md).
+See [these instructions](https://docs.bazel.build/versions/master/external.html)
+for details on how to include TensorFlow as a subproject (instead of building
+your project from inside TensorFlow, as in this example).
+
 [TOC]
 
 TensorFlow's C++ API provides mechanisms for constructing and executing a data
@@ -92,7 +98,7 @@ We will delve into the details of each below.
 
 ### Scope
 
-@{tensorflow::Scope} is the main data structure that holds the current state
+`tensorflow::Scope` is the main data structure that holds the current state
 of graph construction. A `Scope` acts as a handle to the graph being
 constructed, as well as storing TensorFlow operation properties. The `Scope`
 object is the first argument to operation constructors, and operations that use
@@ -102,7 +108,7 @@ explained further below.
 
 Create a new `Scope` object by calling `Scope::NewRootScope`. This creates
 some resources such as a graph to which operations are added. It also creates a
-@{tensorflow::Status} object which will be used to indicate errors encountered
+`tensorflow::Status` object which will be used to indicate errors encountered
 when constructing operations. The `Scope` class has value semantics, thus, a
 `Scope` object can be freely copied and passed around.
 
@@ -121,7 +127,7 @@ Here are some of the properties controlled by a `Scope` object:
 * Device placement for an operation
 * Kernel attribute for an operation
 
-Please refer to @{tensorflow::Scope} for the complete list of member functions
+Please refer to `tensorflow::Scope` for the complete list of member functions
 that let you create child scopes with new properties.
 
 ### Operation Constructors
@@ -213,7 +219,7 @@ auto c = Concat(scope, s, 0);
 
 You may pass many different types of C++ values directly to tensor
 constants. You may explicitly create a tensor constant by calling the
-@{tensorflow::ops::Const} function from various kinds of C++ values. For
+`tensorflow::ops::Const` function from various kinds of C++ values. For
 example:
 
 * Scalars
@@ -257,14 +263,14 @@ auto y = Add(scope, {1, 2, 3, 4}, 10);
 ## Graph Execution
 
 When executing a graph, you will need a session. The C++ API provides a
-@{tensorflow::ClientSession} class that will execute ops created by the
+`tensorflow::ClientSession` class that will execute ops created by the
 operation constructors. TensorFlow will automatically determine which parts of
 the graph need to be executed, and what values need feeding. For example:
 
 ```c++
 Scope root = Scope::NewRootScope();
 auto c = Const(root, { {1, 1} });
-auto m = MatMul(root, c, { {42}, {1} });
+auto m = MatMul(root, c, { {41}, {1} });
 
 ClientSession session(root);
 std::vector<Tensor> outputs;
@@ -291,5 +297,5 @@ session.Run({ {a, { {1, 2}, {3, 4} } } }, {c}, &outputs);
 // outputs[0] == [4 5; 6 7]
 ```
 
-Please see the @{tensorflow::Tensor} documentation for more information on how
+Please see the `tensorflow::Tensor` documentation for more information on how
 to use the execution output.

api_guides/python/array_ops.md

@@ -1,7 +1,7 @@
 # Tensor Transformations
 
 Note: Functions taking `Tensor` arguments can also take anything accepted by
-@{tf.convert_to_tensor}.
+`tf.convert_to_tensor`.
 
 [TOC]
 
@@ -10,78 +10,78 @@ Note: Functions taking `Tensor` arguments can also take anything accepted by
 TensorFlow provides several operations that you can use to cast tensor data
 types in your graph.
 
-*   @{tf.string_to_number}
-*   @{tf.to_double}
-*   @{tf.to_float}
-*   @{tf.to_bfloat16}
-*   @{tf.to_int32}
-*   @{tf.to_int64}
-*   @{tf.cast}
-*   @{tf.bitcast}
-*   @{tf.saturate_cast}
+*   `tf.string_to_number`
+*   `tf.to_double`
+*   `tf.to_float`
+*   `tf.to_bfloat16`
+*   `tf.to_int32`
+*   `tf.to_int64`
+*   `tf.cast`
+*   `tf.bitcast`
+*   `tf.saturate_cast`
 
 ## Shapes and Shaping
 
 TensorFlow provides several operations that you can use to determine the shape
 of a tensor and change the shape of a tensor.
 
-*   @{tf.broadcast_dynamic_shape}
-*   @{tf.broadcast_static_shape}
-*   @{tf.shape}
-*   @{tf.shape_n}
-*   @{tf.size}
-*   @{tf.rank}
-*   @{tf.reshape}
-*   @{tf.squeeze}
-*   @{tf.expand_dims}
-*   @{tf.meshgrid}
+*   `tf.broadcast_dynamic_shape`
+*   `tf.broadcast_static_shape`
+*   `tf.shape`
+*   `tf.shape_n`
+*   `tf.size`
+*   `tf.rank`
+*   `tf.reshape`
+*   `tf.squeeze`
+*   `tf.expand_dims`
+*   `tf.meshgrid`
 
 ## Slicing and Joining
 
 TensorFlow provides several operations to slice or extract parts of a tensor,
 or join multiple tensors together.
 
-*   @{tf.slice}
-*   @{tf.strided_slice}
-*   @{tf.split}
-*   @{tf.tile}
-*   @{tf.pad}
-*   @{tf.concat}
-*   @{tf.stack}
-*   @{tf.parallel_stack}
-*   @{tf.unstack}
-*   @{tf.reverse_sequence}
-*   @{tf.reverse}
-*   @{tf.reverse_v2}
-*   @{tf.transpose}
-*   @{tf.extract_image_patches}
-*   @{tf.space_to_batch_nd}
-*   @{tf.space_to_batch}
-*   @{tf.required_space_to_batch_paddings}
-*   @{tf.batch_to_space_nd}
-*   @{tf.batch_to_space}
-*   @{tf.space_to_depth}
-*   @{tf.depth_to_space}
-*   @{tf.gather}
-*   @{tf.gather_nd}
-*   @{tf.unique_with_counts}
-*   @{tf.scatter_nd}
-*   @{tf.dynamic_partition}
-*   @{tf.dynamic_stitch}
-*   @{tf.boolean_mask}
-*   @{tf.one_hot}
-*   @{tf.sequence_mask}
-*   @{tf.dequantize}
-*   @{tf.quantize_v2}
-*   @{tf.quantized_concat}
-*   @{tf.setdiff1d}
+*   `tf.slice`
+*   `tf.strided_slice`
+*   `tf.split`
+*   `tf.tile`
+*   `tf.pad`
+*   `tf.concat`
+*   `tf.stack`
+*   `tf.parallel_stack`
+*   `tf.unstack`
+*   `tf.reverse_sequence`
+*   `tf.reverse`
+*   `tf.reverse_v2`
+*   `tf.transpose`
+*   `tf.extract_image_patches`
+*   `tf.space_to_batch_nd`
+*   `tf.space_to_batch`
+*   `tf.required_space_to_batch_paddings`
+*   `tf.batch_to_space_nd`
+*   `tf.batch_to_space`
+*   `tf.space_to_depth`
+*   `tf.depth_to_space`
+*   `tf.gather`
+*   `tf.gather_nd`
+*   `tf.unique_with_counts`
+*   `tf.scatter_nd`
+*   `tf.dynamic_partition`
+*   `tf.dynamic_stitch`
+*   `tf.boolean_mask`
+*   `tf.one_hot`
+*   `tf.sequence_mask`
+*   `tf.dequantize`
+*   `tf.quantize_v2`
+*   `tf.quantized_concat`
+*   `tf.setdiff1d`
 
 ## Fake quantization
 Operations used to help train for better quantization accuracy.
 
-*   @{tf.fake_quant_with_min_max_args}
-*   @{tf.fake_quant_with_min_max_args_gradient}
-*   @{tf.fake_quant_with_min_max_vars}
-*   @{tf.fake_quant_with_min_max_vars_gradient}
-*   @{tf.fake_quant_with_min_max_vars_per_channel}
-*   @{tf.fake_quant_with_min_max_vars_per_channel_gradient}
+*   `tf.fake_quant_with_min_max_args`
+*   `tf.fake_quant_with_min_max_args_gradient`
+*   `tf.fake_quant_with_min_max_vars`
+*   `tf.fake_quant_with_min_max_vars_gradient`
+*   `tf.fake_quant_with_min_max_vars_per_channel`
+*   `tf.fake_quant_with_min_max_vars_per_channel_gradient`

api_guides/python/check_ops.md

@@ -1,19 +1,19 @@
 # Asserts and boolean checks
 
-*   @{tf.assert_negative}
-*   @{tf.assert_positive}
-*   @{tf.assert_proper_iterable}
-*   @{tf.assert_non_negative}
-*   @{tf.assert_non_positive}
-*   @{tf.assert_equal}
-*   @{tf.assert_integer}
-*   @{tf.assert_less}
-*   @{tf.assert_less_equal}
-*   @{tf.assert_greater}
-*   @{tf.assert_greater_equal}
-*   @{tf.assert_rank}
-*   @{tf.assert_rank_at_least}
-*   @{tf.assert_type}
-*   @{tf.is_non_decreasing}
-*   @{tf.is_numeric_tensor}
-*   @{tf.is_strictly_increasing}
+*   `tf.assert_negative`
+*   `tf.assert_positive`
+*   `tf.assert_proper_iterable`
+*   `tf.assert_non_negative`
+*   `tf.assert_non_positive`
+*   `tf.assert_equal`
+*   `tf.assert_integer`
+*   `tf.assert_less`
+*   `tf.assert_less_equal`
+*   `tf.assert_greater`
+*   `tf.assert_greater_equal`
+*   `tf.assert_rank`
+*   `tf.assert_rank_at_least`
+*   `tf.assert_type`
+*   `tf.is_non_decreasing`
+*   `tf.is_numeric_tensor`
+*   `tf.is_strictly_increasing`

api_guides/python/client.md

@@ -3,34 +3,34 @@
 
 This library contains classes for launching graphs and executing operations.
 
-@{$programmers_guide/low_level_intro$This guide} has examples of how a graph
-is launched in a @{tf.Session}.
+[This guide](../../guide/low_level_intro.md) has examples of how a graph
+is launched in a `tf.Session`.
 
 ## Session management
 
-*   @{tf.Session}
-*   @{tf.InteractiveSession}
-*   @{tf.get_default_session}
+*   `tf.Session`
+*   `tf.InteractiveSession`
+*   `tf.get_default_session`
 
 ## Error classes and convenience functions
 
-*   @{tf.OpError}
-*   @{tf.errors.CancelledError}
-*   @{tf.errors.UnknownError}
-*   @{tf.errors.InvalidArgumentError}
-*   @{tf.errors.DeadlineExceededError}
-*   @{tf.errors.NotFoundError}
-*   @{tf.errors.AlreadyExistsError}
-*   @{tf.errors.PermissionDeniedError}
-*   @{tf.errors.UnauthenticatedError}
-*   @{tf.errors.ResourceExhaustedError}
-*   @{tf.errors.FailedPreconditionError}
-*   @{tf.errors.AbortedError}
-*   @{tf.errors.OutOfRangeError}
-*   @{tf.errors.UnimplementedError}
-*   @{tf.errors.InternalError}
-*   @{tf.errors.UnavailableError}
-*   @{tf.errors.DataLossError}
-*   @{tf.errors.exception_type_from_error_code}
-*   @{tf.errors.error_code_from_exception_type}
-*   @{tf.errors.raise_exception_on_not_ok_status}
+*   `tf.OpError`
+*   `tf.errors.CancelledError`
+*   `tf.errors.UnknownError`
+*   `tf.errors.InvalidArgumentError`
+*   `tf.errors.DeadlineExceededError`
+*   `tf.errors.NotFoundError`
+*   `tf.errors.AlreadyExistsError`
+*   `tf.errors.PermissionDeniedError`
+*   `tf.errors.UnauthenticatedError`
+*   `tf.errors.ResourceExhaustedError`
+*   `tf.errors.FailedPreconditionError`
+*   `tf.errors.AbortedError`
+*   `tf.errors.OutOfRangeError`
+*   `tf.errors.UnimplementedError`
+*   `tf.errors.InternalError`
+*   `tf.errors.UnavailableError`
+*   `tf.errors.DataLossError`
+*   `tf.errors.exception_type_from_error_code`
+*   `tf.errors.error_code_from_exception_type`
+*   `tf.errors.raise_exception_on_not_ok_status`

api_guides/python/constant_op.md

@@ -1,25 +1,25 @@
 # Constants, Sequences, and Random Values
 
 Note: Functions taking `Tensor` arguments can also take anything accepted by
-@{tf.convert_to_tensor}.
+`tf.convert_to_tensor`.
 
 [TOC]
 
 ## Constant Value Tensors
 
 TensorFlow provides several operations that you can use to generate constants.
 
-*   @{tf.zeros}
-*   @{tf.zeros_like}
-*   @{tf.ones}
-*   @{tf.ones_like}
-*   @{tf.fill}
-*   @{tf.constant}
+*   `tf.zeros`
+*   `tf.zeros_like`
+*   `tf.ones`
+*   `tf.ones_like`
+*   `tf.fill`
+*   `tf.constant`
 
 ## Sequences
 
-*   @{tf.linspace}
-*   @{tf.range}
+*   `tf.linspace`
+*   `tf.range`
 
 ## Random Tensors
 
@@ -29,11 +29,11 @@ time they are evaluated.
 
 The `seed` keyword argument in these functions acts in conjunction with
 the graph-level random seed. Changing either the graph-level seed using
-@{tf.set_random_seed} or the
+`tf.set_random_seed` or the
 op-level seed will change the underlying seed of these operations. Setting
 neither graph-level nor op-level seed, results in a random seed for all
 operations.
-See @{tf.set_random_seed}
+See `tf.set_random_seed`
 for details on the interaction between operation-level and graph-level random
 seeds.
 
@@ -64,7 +64,7 @@ print(sess.run(norm))
 ```
 
 Another common use of random values is the initialization of variables. Also see
-the @{$variables$Variables How To}.
+the [Variables How To](../../guide/variables.md).
 
 ```python
 # Use random uniform values in [0, 1) as the initializer for a variable of shape
@@ -77,11 +77,11 @@ sess.run(init)
 print(sess.run(var))
 ```
 
-*   @{tf.random_normal}
-*   @{tf.truncated_normal}
-*   @{tf.random_uniform}
-*   @{tf.random_shuffle}
-*   @{tf.random_crop}
-*   @{tf.multinomial}
-*   @{tf.random_gamma}
-*   @{tf.set_random_seed}
+*   `tf.random_normal`
+*   `tf.truncated_normal`
+*   `tf.random_uniform`
+*   `tf.random_shuffle`
+*   `tf.random_crop`
+*   `tf.multinomial`
+*   `tf.random_gamma`
+*   `tf.set_random_seed`