Fix list in generated doc (#1434)

Author: jderusse

src/DynamoDbClient.php

@@ -203,20 +203,14 @@ public function batchGetItem($input): BatchGetItemOutput
      * If one or more of the following is true, DynamoDB rejects the entire batch write operation:
      *
      * - One or more tables specified in the `BatchWriteItem` request does not exist.
-     * -
      * - Primary key attributes specified on an item in the request do not match those in the corresponding table's primary
      *   key schema.
-     * -
      * - You try to perform multiple operations on the same item in the same `BatchWriteItem` request. For example, you
      *   cannot put and delete the same item in the same `BatchWriteItem` request.
-     * -
      * - Your request contains at least two items with identical hash and range keys (which essentially is two put
      *   operations).
-     * -
      * - There are more than 25 requests in the batch.
-     * -
      * - Any individual item in a batch exceeds 400 KB.
-     * -
      * - The total request size exceeds 16 MB.
      *
      * [^1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.NamingRulesDataTypes.html
@@ -856,17 +850,14 @@ public function tableNotExists($input): TableNotExistsWaiter
      *   item to be written, the name of the table to write it in, an optional condition expression that must be satisfied
      *   for the write to succeed, a list of the item's attributes, and a field indicating whether to retrieve the item's
      *   attributes if the condition is not met.
-     * -
      * - `Update`  —   Initiates an `UpdateItem` operation to update an existing item. This structure specifies the
      *   primary key of the item to be updated, the name of the table where it resides, an optional condition expression
      *   that must be satisfied for the update to succeed, an expression that defines one or more attributes to be updated,
      *   and a field indicating whether to retrieve the item's attributes if the condition is not met.
-     * -
      * - `Delete`  —   Initiates a `DeleteItem` operation to delete an existing item. This structure specifies the
      *   primary key of the item to be deleted, the name of the table where it resides, an optional condition expression
      *   that must be satisfied for the deletion to succeed, and a field indicating whether to retrieve the item's
      *   attributes if the condition is not met.
-     * -
      * - `ConditionCheck`  —   Applies a condition to an item that is not being modified by the transaction. This
      *   structure specifies the primary key of the item to be checked, the name of the table where it resides, a condition
      *   expression that must be satisfied for the transaction to succeed, and a field indicating whether to retrieve the
@@ -875,16 +866,11 @@ public function tableNotExists($input): TableNotExistsWaiter
      * DynamoDB rejects the entire `TransactWriteItems` request if any of the following is true:
      *
      * - A condition in one of the condition expressions is not met.
-     * -
      * - An ongoing operation is in the process of updating the same item.
-     * -
      * - There is insufficient provisioned capacity for the transaction to be completed.
-     * -
      * - An item size becomes too large (bigger than 400 KB), a local secondary index (LSI) becomes too large, or a similar
      *   validation error occurs because of changes made by the transaction.
-     * -
      * - The aggregate size of the items in the transaction exceeds 4 MB.
-     * -
      * - There is a user error, such as an invalid data format.
      *
      * @see https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TransactWriteItems.html
@@ -985,9 +971,7 @@ public function updateItem($input): UpdateItemOutput
      * You can only perform one of the following operations at once:
      *
      * - Modify the provisioned throughput settings of the table.
-     * -
      * - Remove a global secondary index from the table.
-     * -
      * - Create a new global secondary index on the table. After the index begins backfilling, you can use `UpdateTable` to
      *   perform other operations.
      *

src/Enum/ReturnConsumedCapacity.php

@@ -11,9 +11,7 @@
  *
  *   Note that some operations, such as `GetItem` and `BatchGetItem`, do not access any indexes at all. In these cases,
  *   specifying `INDEXES` will only return `ConsumedCapacity` information for table(s).
- * -
  * - `TOTAL` - The response includes only the aggregate `ConsumedCapacity` for the operation.
- * -
  * - `NONE` - No `ConsumedCapacity` details are included in the response.
  */
 final class ReturnConsumedCapacity

src/Exception/TransactionCanceledException.php

@@ -13,28 +13,20 @@
  * DynamoDB cancels a `TransactWriteItems` request under the following circumstances:
  *
  * - A condition in one of the condition expressions is not met.
- * -
  * - A table in the `TransactWriteItems` request is in a different account or region.
- * -
  * - More than one action in the `TransactWriteItems` operation targets the same item.
- * -
  * - There is insufficient provisioned capacity for the transaction to be completed.
- * -
  * - An item size becomes too large (larger than 400 KB), or a local secondary index (LSI) becomes too large, or a
  *   similar validation error occurs because of changes made by the transaction.
- * -
  * - There is a user error, such as an invalid data format.
  *
  * DynamoDB cancels a `TransactGetItems` request under the following circumstances:
  *
  * - There is an ongoing `TransactGetItems` operation that conflicts with a concurrent `PutItem`, `UpdateItem`,
  *   `DeleteItem` or `TransactWriteItems` request. In this case the `TransactGetItems` operation fails with a
  *   `TransactionCanceledException`.
- * -
  * - A table in the `TransactGetItems` request is in a different account or region.
- * -
  * - There is insufficient provisioned capacity for the transaction to be completed.
- * -
  * - There is a user error, such as an invalid data format.
  *
  * > If using Java, DynamoDB lists the cancellation reasons on the `CancellationReasons` property. This property is not
@@ -46,31 +38,26 @@
  * - No Errors:
  *
  *   - Code: `None`
- *   -
  *   - Message: `null`
  *
  * - Conditional Check Failed:
  *
  *   - Code: `ConditionalCheckFailed`
- *   -
  *   - Message: The conditional request failed.
  *
  * - Item Collection Size Limit Exceeded:
  *
  *   - Code: `ItemCollectionSizeLimitExceeded`
- *   -
  *   - Message: Collection size exceeded.
  *
  * - Transaction Conflict:
  *
  *   - Code: `TransactionConflict`
- *   -
  *   - Message: Transaction is ongoing for the item.
  *
  * - Provisioned Throughput Exceeded:
  *
  *   - Code: `ProvisionedThroughputExceeded`
- *   -
  *   - Messages:
  *
  *     - The level of configured provisioned throughput for the table was exceeded. Consider increasing your
@@ -89,7 +76,6 @@
  * - Throttling Error:
  *
  *   - Code: `ThrottlingError`
- *   -
  *   - Messages:
  *
  *     - Throughput exceeds the current capacity of your table or index. DynamoDB is automatically scaling your table or
@@ -110,27 +96,17 @@
  * - Validation Error:
  *
  *   - Code: `ValidationError`
- *   -
  *   - Messages:
  *
  *     - One or more parameter values were invalid.
- *     -
  *     - The update expression attempted to update the secondary index key beyond allowed size limits.
- *     -
  *     - The update expression attempted to update the secondary index key to unsupported type.
- *     -
  *     - An operand in the update expression has an incorrect data type.
- *     -
  *     - Item size to update has exceeded the maximum allowed size.
- *     -
  *     - Number overflow. Attempting to store a number with magnitude larger than supported range.
- *     -
  *     - Type mismatch for attribute to update.
- *     -
  *     - Nesting Levels have exceeded supported limits.
- *     -
  *     - The document path provided in the update expression is invalid for update.
- *     -
  *     - The provided expression refers to an attribute that does not exist in the item.
  */
 final class TransactionCanceledException extends ClientException

src/Exception/TransactionInProgressException.php

@@ -15,31 +15,22 @@
  *
  * - Set `clientExecutionTimeout` to a value that allows at least one retry to be processed after 5 seconds have elapsed
  *   since the first attempt for the `TransactWriteItems` operation.
- * -
  * - Set `socketTimeout` to a value a little lower than the `requestTimeout` setting.
- * -
  * - `requestTimeout` should be set based on the time taken for the individual retries of a single HTTP request for your
  *   use case, but setting it to 1 second or higher should work well to reduce chances of retries and
  *   `TransactionInProgressException` errors.
- * -
  * - Use exponential backoff when retrying and tune backoff if needed.
  *
  * Assuming default retry policy [^1], example timeout settings based on the guidelines above are as follows:
  *
  * Example timeline:
  *
  * - 0-1000 first attempt
- * -
  * - 1000-1500 first sleep/delay (default retry policy uses 500 ms as base delay for 4xx errors)
- * -
  * - 1500-2500 second attempt
- * -
  * - 2500-3500 second sleep/delay (500 * 2, exponential backoff)
- * -
  * - 3500-4500 third attempt
- * -
  * - 4500-6500 third sleep/delay (500 * 2^2)
- * -
  * - 6500-7500 fourth attempt (this can trigger inline recovery since 5 seconds have elapsed since the first attempt
  *   reached TC)
  *

src/Input/BatchGetItemInput.php

@@ -22,14 +22,11 @@ final class BatchGetItemInput extends Input
      *
      * - `ConsistentRead` - If `true`, a strongly consistent read is used; if `false` (the default), an eventually
      *   consistent read is used.
-     * -
      * - `ExpressionAttributeNames` - One or more substitution tokens for attribute names in the `ProjectionExpression`
      *   parameter. The following are some use cases for using `ExpressionAttributeNames`:
      *
      *   - To access an attribute whose name conflicts with a DynamoDB reserved word.
-     *   -
      *   - To create a placeholder for repeating occurrences of an attribute name in an expression.
-     *   -
      *   - To prevent special characters in an attribute name from being misinterpreted in an expression.
      *
      *   Use the **#** character in an expression to dereference an attribute name. For example, consider the following
@@ -52,11 +49,9 @@ final class BatchGetItemInput extends Input
      *
      *   For more information about expression attribute names, see Accessing Item Attributes [^2] in the *Amazon DynamoDB
      *   Developer Guide*.
-     * -
      * - `Keys` - An array of primary key attribute values that define specific items in the table. For each primary key,
      *   you must provide *all* of the key attributes. For example, with a simple primary key, you only need to provide the
      *   partition key value. For a composite key, you must provide *both* the partition key value and the sort key value.
-     * -
      * - `ProjectionExpression` - A string that identifies one or more attributes to retrieve from the table. These
      *   attributes can include scalars, sets, or elements of a JSON document. The attributes in the expression must be
      *   separated by commas.
@@ -65,7 +60,6 @@ final class BatchGetItemInput extends Input
      *   found, they do not appear in the result.
      *
      *   For more information, see Accessing Item Attributes [^3] in the *Amazon DynamoDB Developer Guide*.
-     * -
      * - `AttributesToGet` - This is a legacy parameter. Use `ProjectionExpression` instead. For more information, see
      *   AttributesToGet [^4] in the *Amazon DynamoDB Developer Guide*.
      *

src/Input/CreateTableInput.php

@@ -52,11 +52,9 @@ final class CreateTableInput extends Input
      * Each `KeySchemaElement` in the array is composed of:
      *
      * - `AttributeName` - The name of this key attribute.
-     * -
      * - `KeyType` - The role that the key attribute will assume:
      *
      *   - `HASH` - partition key
-     *   -
      *   - `RANGE` - sort key
      *
      *
@@ -91,21 +89,17 @@ final class CreateTableInput extends Input
      * Each local secondary index in the array includes the following:
      *
      * - `IndexName` - The name of the local secondary index. Must be unique only for this table.
-     * -
      * - `KeySchema` - Specifies the key schema for the local secondary index. The key schema must begin with the same
      *   partition key as the table.
-     * -
      * - `Projection` - Specifies attributes that are copied (projected) from the table into the index. These are in
      *   addition to the primary key attributes and index key attributes, which are automatically projected. Each attribute
      *   specification is composed of:
      *
      *   - `ProjectionType` - One of the following:
      *
      *     - `KEYS_ONLY` - Only the index and primary keys are projected into the index.
-     *     -
      *     - `INCLUDE` - Only the specified table attributes are projected into the index. The list of projected attributes
      *       is in `NonKeyAttributes`.
-     *     -
      *     - `ALL` - All of the table attributes are projected into the index.
      *
      *   - `NonKeyAttributes` - A list of one or more non-key attribute names that are projected into the secondary index.
@@ -122,20 +116,16 @@ final class CreateTableInput extends Input
      * the array includes the following:.
      *
      * - `IndexName` - The name of the global secondary index. Must be unique only for this table.
-     * -
      * - `KeySchema` - Specifies the key schema for the global secondary index.
-     * -
      * - `Projection` - Specifies attributes that are copied (projected) from the table into the index. These are in
      *   addition to the primary key attributes and index key attributes, which are automatically projected. Each attribute
      *   specification is composed of:
      *
      *   - `ProjectionType` - One of the following:
      *
      *     - `KEYS_ONLY` - Only the index and primary keys are projected into the index.
-     *     -
      *     - `INCLUDE` - Only the specified table attributes are projected into the index. The list of projected attributes
      *       is in `NonKeyAttributes`.
-     *     -
      *     - `ALL` - All of the table attributes are projected into the index.
      *
      *   - `NonKeyAttributes` - A list of one or more non-key attribute names that are projected into the secondary index.
@@ -156,7 +146,6 @@ final class CreateTableInput extends Input
      *
      * - `PROVISIONED` - We recommend using `PROVISIONED` for predictable workloads. `PROVISIONED` sets the billing mode to
      *   Provisioned Mode [^1].
-     * -
      * - `PAY_PER_REQUEST` - We recommend using `PAY_PER_REQUEST` for unpredictable workloads. `PAY_PER_REQUEST` sets the
      *   billing mode to On-Demand Mode [^2].
      *
@@ -187,16 +176,12 @@ final class CreateTableInput extends Input
      * The settings for DynamoDB Streams on the table. These settings consist of:.
      *
      * - `StreamEnabled` - Indicates whether DynamoDB Streams is to be enabled (true) or disabled (false).
-     * -
      * - `StreamViewType` - When an item in the table is modified, `StreamViewType` determines what information is written
      *   to the table's stream. Valid values for `StreamViewType` are:
      *
      *   - `KEYS_ONLY` - Only the key attributes of the modified item are written to the stream.
-     *   -
      *   - `NEW_IMAGE` - The entire item, as it appears after it was modified, is written to the stream.
-     *   -
      *   - `OLD_IMAGE` - The entire item, as it appeared before it was modified, is written to the stream.
-     *   -
      *   - `NEW_AND_OLD_IMAGES` - Both the new and the old item images of the item are written to the stream.
      *
      * @var StreamSpecification|null

src/Input/DeleteItemInput.php

@@ -66,7 +66,6 @@ final class DeleteItemInput extends Input
      *
      * - `NONE` - If `ReturnValues` is not specified, or if its value is `NONE`, then nothing is returned. (This setting is
      *   the default for `ReturnValues`.)
-     * -
      * - `ALL_OLD` - The content of the old item is returned.
      *
      * There is no additional cost associated with requesting a return value aside from the small network and processing
@@ -101,9 +100,7 @@ final class DeleteItemInput extends Input
      * - Functions: `attribute_exists | attribute_not_exists | attribute_type | contains | begins_with | size`
      *
      *   These function names are case-sensitive.
-     * -
      * - Comparison operators: `= | <> | < | > | <= | >= | BETWEEN | IN `
-     * -
      * - Logical operators: `AND | OR | NOT`
      *
      * For more information about condition expressions, see Condition Expressions [^1] in the *Amazon DynamoDB Developer
@@ -120,9 +117,7 @@ final class DeleteItemInput extends Input
      * `ExpressionAttributeNames`:.
      *
      * - To access an attribute whose name conflicts with a DynamoDB reserved word.
-     * -
      * - To create a placeholder for repeating occurrences of an attribute name in an expression.
-     * -
      * - To prevent special characters in an attribute name from being misinterpreted in an expression.
      *
      * Use the **#** character in an expression to dereference an attribute name. For example, consider the following

src/Input/GetItemInput.php

@@ -79,9 +79,7 @@ final class GetItemInput extends Input
      * `ExpressionAttributeNames`:.
      *
      * - To access an attribute whose name conflicts with a DynamoDB reserved word.
-     * -
      * - To create a placeholder for repeating occurrences of an attribute name in an expression.
-     * -
      * - To prevent special characters in an attribute name from being misinterpreted in an expression.
      *
      * Use the **#** character in an expression to dereference an attribute name. For example, consider the following

src/Input/PutItemInput.php

@@ -69,7 +69,6 @@ final class PutItemInput extends Input
      *
      * - `NONE` - If `ReturnValues` is not specified, or if its value is `NONE`, then nothing is returned. (This setting is
      *   the default for `ReturnValues`.)
-     * -
      * - `ALL_OLD` - If `PutItem` overwrote an attribute name-value pair, then the content of the old item is returned.
      *
      * The values returned are strongly consistent.
@@ -116,9 +115,7 @@ final class PutItemInput extends Input
      * - Functions: `attribute_exists | attribute_not_exists | attribute_type | contains | begins_with | size`
      *
      *   These function names are case-sensitive.
-     * -
      * - Comparison operators: `= | <> | < | > | <= | >= | BETWEEN | IN `
-     * -
      * - Logical operators: `AND | OR | NOT`
      *
      * For more information on condition expressions, see Condition Expressions [^1] in the *Amazon DynamoDB Developer
@@ -135,9 +132,7 @@ final class PutItemInput extends Input
      * `ExpressionAttributeNames`:.
      *
      * - To access an attribute whose name conflicts with a DynamoDB reserved word.
-     * -
      * - To create a placeholder for repeating occurrences of an attribute name in an expression.
-     * -
      * - To prevent special characters in an attribute name from being misinterpreted in an expression.
      *
      * Use the **#** character in an expression to dereference an attribute name. For example, consider the following