message: Add clarifications about the `inputs` argument in the `call` method of Keras layers.
diff: @@ -485,9 +485,35 @@ class Layer(module.Module, version_utils.LayerVersionSelector):
  method to support masking.
  Args:
  - inputs: Input tensor, or list/tuple of input tensors.
  - *args: Additional positional arguments. Currently unused.
  - **kwargs: Additional keyword arguments. Currently unused.
  + inputs: Input tensor, or dict/list/tuple of input tensors.
  + The first positional `inputs` argument is subject to special rules:
  + - `inputs` must be explicitly passed. A layer cannot have zero
  + arguments, and inputs cannot have been provided via the default value
  + of a keyword argument.
  + - NumPy array or Python scalar values in `inputs` get cast as tensors.
  + - Keras mask metadata is only collected from `inputs`.
  + - Layers are built (`build(input_shape)` method)
  + using shape info from `inputs` only.
  + - `input_spec` compatibility is only checked against `inputs`.
  + - Mixed precision input casting is only applied to `inputs`.
  + If a layer has tensor arguments in `*args` or `**kwargs`, their
  + casting behavior in mixed precision should be handled manually.
  + - The SavedModel input specification is generated using `inputs` only.
  + - Integration with various ecosystem packages like TFMOT, TFLite,
  + TF.js, etc is only supported for `inputs` and not for tensors in
  + positional and keyword arguments.
  + *args: Additional positional arguments. May contain tensors, although
  + this is not recommended, for the reasons above.
  + **kwargs: Additional keyword arguments. May contain tensors, although
  + this is not recommended, for the reasons above.
  + The following optional keyword arguments are reserved:
  + - `training`: Boolean scalar tensor of Python boolean indicating
  + whether the `call` is meant for training or inference.
  + - `mask`: Boolean input mask. If the layer's `call()` method takes a
  + `mask` argument, its default value will be set to the mask generated
  + for `inputs` by the previous layer (if `input` did come from a layer
  + that generated a corresponding mask, i.e. if it came from a Keras
  + layer with masking support).
  Returns:
  A tensor or list/tuple of tensors.
  