Skip to content

Commit

Permalink
Reintroduce word wrapping of comments without configuration (#2648)
Browse files Browse the repository at this point in the history 
* Update code

* Minor fix

* Don't use system newline

* Regenerate code

* Update the client sdk parent POM copy

* Use Eclipse to do line wrapping in comments

* Configuration change for better JSON formatting

* Further shrink diff
  • Loading branch information
@alzimmermsft
alzimmermsft authored Mar 28, 2024
1 parent 6a4fe1c commit bdcd1fd
Show file tree
Hide file tree
Showing 1,706 changed files with 25,983 additions and 13,560 deletions.
38 changes: 29 additions & 9 deletions ...main/java/com/azure/ai/formrecognizer/documentanalysis/dpg/FormRecognizerAsyncClient.java
View file
Original file line number Diff line number Diff line change
Expand Up @@ -44,20 +44,25 @@ public final class FormRecognizerAsyncClient {
* Analyzes document with document model.
* <p><strong>Query Parameters</strong></p>
* <table border="1">
* <caption>Query Parameters</caption>
* <tr><th>Name</th><th>Type</th><th>Required</th><th>Description</th></tr>
* <tr><td>pages</td><td>String</td><td>No</td><td>List of 1-based page numbers to analyze. Ex. "1-3,5,7-9"</td></tr>
* <tr><td>locale</td><td>String</td><td>No</td><td>Locale hint for text recognition and document analysis. Value may contain only the language code (ex. "en", "fr") or BCP 47 language tag (ex. "en-US").</td></tr>
* <tr><td>stringIndexType</td><td>String</td><td>No</td><td>Method used to compute string offset and length. Allowed values: "textElements", "unicodeCodePoint", "utf16CodeUnit".</td></tr>
* <caption>Query Parameters</caption>
* <tr><th>Name</th><th>Type</th><th>Required</th><th>Description</th></tr>
* <tr><td>pages</td><td>String</td><td>No</td><td>List of 1-based page numbers to analyze. Ex.
* "1-3,5,7-9"</td></tr>
* <tr><td>locale</td><td>String</td><td>No</td><td>Locale hint for text recognition and document analysis. Value
* may contain only the language code (ex. "en", "fr") or BCP 47 language tag (ex. "en-US").</td></tr>
* <tr><td>stringIndexType</td><td>String</td><td>No</td><td>Method used to compute string offset and length.
* Allowed values: "textElements", "unicodeCodePoint", "utf16CodeUnit".</td></tr>
* </table>
* You can add these to a request with {@link RequestOptions#addQueryParam}
* <p><strong>Request Body Schema</strong></p>
*
* <pre>{@code
* BinaryData
* }</pre>
*
* @param modelId Unique document model name.
* @param contentType Upload file type. Allowed values: "application/octet-stream", "application/pdf", "image/bmp", "image/heif", "image/jpeg", "image/png", "image/tiff".
* @param contentType Upload file type. Allowed values: "application/octet-stream", "application/pdf", "image/bmp",
* "image/heif", "image/jpeg", "image/png", "image/tiff".
* @param requestOptions The options to configure the HTTP request before HTTP client sends it.
* @throws HttpResponseException thrown if the request is rejected by server.
* @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
Expand All @@ -77,6 +82,7 @@ public PollerFlux<BinaryData, BinaryData> beginAnalyzeDocument(String modelId, S
*
* Gets the result of document analysis.
* <p><strong>Response Body Schema</strong></p>
*
* <pre>{@code
* {
* status: String(notStarted/running/failed/succeeded) (Required)
Expand Down Expand Up @@ -303,6 +309,7 @@ public Mono<Response<BinaryData>> getAnalyzeDocumentResultWithResponse(String mo
*
* Builds a custom document analysis model.
* <p><strong>Request Body Schema</strong></p>
*
* <pre>{@code
* {
* modelId: String (Required)
Expand Down Expand Up @@ -338,6 +345,7 @@ public PollerFlux<BinaryData, BinaryData> beginBuildDocumentModel(BinaryData bui
*
* Creates a new document model from document types of existing document models.
* <p><strong>Request Body Schema</strong></p>
*
* <pre>{@code
* {
* modelId: String (Required)
Expand Down Expand Up @@ -371,8 +379,10 @@ public PollerFlux<BinaryData, BinaryData> beginComposeDocumentModel(BinaryData c
/**
* Generate copy authorization
*
* Generates authorization to copy a document model to this location with specified modelId and optional description.
* Generates authorization to copy a document model to this location with specified modelId and optional
* description.
* <p><strong>Request Body Schema</strong></p>
*
* <pre>{@code
* {
* modelId: String (Required)
Expand All @@ -382,7 +392,9 @@ public PollerFlux<BinaryData, BinaryData> beginComposeDocumentModel(BinaryData c
* }
* }
* }</pre>
*
* <p><strong>Response Body Schema</strong></p>
*
* <pre>{@code
* {
* targetResourceId: String (Required)
Expand All @@ -400,7 +412,8 @@ public PollerFlux<BinaryData, BinaryData> beginComposeDocumentModel(BinaryData c
* @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
* @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
* @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
* @return authorization to copy a document model to the specified target resource and modelId along with {@link Response} on successful completion of {@link Mono}.
* @return authorization to copy a document model to the specified target resource and modelId along with
* {@link Response} on successful completion of {@link Mono}.
*/
@Generated
@ServiceMethod(returns = ReturnType.SINGLE)
Expand All @@ -414,6 +427,7 @@ public Mono<Response<BinaryData>> authorizeCopyDocumentModelWithResponse(BinaryD
*
* Copies document model to the target resource, region, and modelId.
* <p><strong>Request Body Schema</strong></p>
*
* <pre>{@code
* {
* targetResourceId: String (Required)
Expand Down Expand Up @@ -446,6 +460,7 @@ public PollerFlux<BinaryData, BinaryData> beginCopyDocumentModelTo(String modelI
*
* Lists all operations.
* <p><strong>Response Body Schema</strong></p>
*
* <pre>{@code
* {
* operationId: String (Required)
Expand Down Expand Up @@ -480,6 +495,7 @@ public PagedFlux<BinaryData> getOperations(RequestOptions requestOptions) {
*
* Gets operation info.
* <p><strong>Response Body Schema</strong></p>
*
* <pre>{@code
* {
* kind: String (Required)
Expand Down Expand Up @@ -528,6 +544,7 @@ public Mono<Response<BinaryData>> getOperationWithResponse(String operationId, R
*
* List all document models.
* <p><strong>Response Body Schema</strong></p>
*
* <pre>{@code
* {
* modelId: String (Required)
Expand Down Expand Up @@ -558,6 +575,7 @@ public PagedFlux<BinaryData> getDocumentModels(RequestOptions requestOptions) {
*
* Gets detailed document model information.
* <p><strong>Response Body Schema</strong></p>
*
* <pre>{@code
* {
* modelId: String (Required)
Expand Down Expand Up @@ -628,6 +646,7 @@ public Mono<Response<Void>> deleteDocumentModelWithResponse(String modelId, Requ
*
* Return information about the current resource.
* <p><strong>Response Body Schema</strong></p>
*
* <pre>{@code
* {
* customDocumentModels (Required): {
Expand All @@ -642,7 +661,8 @@ public Mono<Response<Void>> deleteDocumentModelWithResponse(String modelId, Requ
* @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
* @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
* @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
* @return general information regarding the current resource along with {@link Response} on successful completion of {@link Mono}.
* @return general information regarding the current resource along with {@link Response} on successful completion
* of {@link Mono}.
*/
@Generated
@ServiceMethod(returns = ReturnType.SINGLE)
Expand Down
35 changes: 27 additions & 8 deletions .../src/main/java/com/azure/ai/formrecognizer/documentanalysis/dpg/FormRecognizerClient.java
View file
Original file line number Diff line number Diff line change
Expand Up @@ -43,20 +43,25 @@ public final class FormRecognizerClient {
* Analyzes document with document model.
* <p><strong>Query Parameters</strong></p>
* <table border="1">
* <caption>Query Parameters</caption>
* <tr><th>Name</th><th>Type</th><th>Required</th><th>Description</th></tr>
* <tr><td>pages</td><td>String</td><td>No</td><td>List of 1-based page numbers to analyze. Ex. "1-3,5,7-9"</td></tr>
* <tr><td>locale</td><td>String</td><td>No</td><td>Locale hint for text recognition and document analysis. Value may contain only the language code (ex. "en", "fr") or BCP 47 language tag (ex. "en-US").</td></tr>
* <tr><td>stringIndexType</td><td>String</td><td>No</td><td>Method used to compute string offset and length. Allowed values: "textElements", "unicodeCodePoint", "utf16CodeUnit".</td></tr>
* <caption>Query Parameters</caption>
* <tr><th>Name</th><th>Type</th><th>Required</th><th>Description</th></tr>
* <tr><td>pages</td><td>String</td><td>No</td><td>List of 1-based page numbers to analyze. Ex.
* "1-3,5,7-9"</td></tr>
* <tr><td>locale</td><td>String</td><td>No</td><td>Locale hint for text recognition and document analysis. Value
* may contain only the language code (ex. "en", "fr") or BCP 47 language tag (ex. "en-US").</td></tr>
* <tr><td>stringIndexType</td><td>String</td><td>No</td><td>Method used to compute string offset and length.
* Allowed values: "textElements", "unicodeCodePoint", "utf16CodeUnit".</td></tr>
* </table>
* You can add these to a request with {@link RequestOptions#addQueryParam}
* <p><strong>Request Body Schema</strong></p>
*
* <pre>{@code
* BinaryData
* }</pre>
*
* @param modelId Unique document model name.
* @param contentType Upload file type. Allowed values: "application/octet-stream", "application/pdf", "image/bmp", "image/heif", "image/jpeg", "image/png", "image/tiff".
* @param contentType Upload file type. Allowed values: "application/octet-stream", "application/pdf", "image/bmp",
* "image/heif", "image/jpeg", "image/png", "image/tiff".
* @param requestOptions The options to configure the HTTP request before HTTP client sends it.
* @throws HttpResponseException thrown if the request is rejected by server.
* @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
Expand All @@ -76,6 +81,7 @@ public SyncPoller<BinaryData, BinaryData> beginAnalyzeDocument(String modelId, S
*
* Gets the result of document analysis.
* <p><strong>Response Body Schema</strong></p>
*
* <pre>{@code
* {
* status: String(notStarted/running/failed/succeeded) (Required)
Expand Down Expand Up @@ -302,6 +308,7 @@ public Response<BinaryData> getAnalyzeDocumentResultWithResponse(String modelId,
*
* Builds a custom document analysis model.
* <p><strong>Request Body Schema</strong></p>
*
* <pre>{@code
* {
* modelId: String (Required)
Expand Down Expand Up @@ -337,6 +344,7 @@ public SyncPoller<BinaryData, BinaryData> beginBuildDocumentModel(BinaryData bui
*
* Creates a new document model from document types of existing document models.
* <p><strong>Request Body Schema</strong></p>
*
* <pre>{@code
* {
* modelId: String (Required)
Expand Down Expand Up @@ -370,8 +378,10 @@ public SyncPoller<BinaryData, BinaryData> beginComposeDocumentModel(BinaryData c
/**
* Generate copy authorization
*
* Generates authorization to copy a document model to this location with specified modelId and optional description.
* Generates authorization to copy a document model to this location with specified modelId and optional
* description.
* <p><strong>Request Body Schema</strong></p>
*
* <pre>{@code
* {
* modelId: String (Required)
Expand All @@ -381,7 +391,9 @@ public SyncPoller<BinaryData, BinaryData> beginComposeDocumentModel(BinaryData c
* }
* }
* }</pre>
*
* <p><strong>Response Body Schema</strong></p>
*
* <pre>{@code
* {
* targetResourceId: String (Required)
Expand All @@ -399,7 +411,8 @@ public SyncPoller<BinaryData, BinaryData> beginComposeDocumentModel(BinaryData c
* @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
* @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
* @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
* @return authorization to copy a document model to the specified target resource and modelId along with {@link Response}.
* @return authorization to copy a document model to the specified target resource and modelId along with
* {@link Response}.
*/
@Generated
@ServiceMethod(returns = ReturnType.SINGLE)
Expand All @@ -413,6 +426,7 @@ public Response<BinaryData> authorizeCopyDocumentModelWithResponse(BinaryData au
*
* Copies document model to the target resource, region, and modelId.
* <p><strong>Request Body Schema</strong></p>
*
* <pre>{@code
* {
* targetResourceId: String (Required)
Expand Down Expand Up @@ -445,6 +459,7 @@ public SyncPoller<BinaryData, BinaryData> beginCopyDocumentModelTo(String modelI
*
* Lists all operations.
* <p><strong>Response Body Schema</strong></p>
*
* <pre>{@code
* {
* operationId: String (Required)
Expand Down Expand Up @@ -479,6 +494,7 @@ public PagedIterable<BinaryData> getOperations(RequestOptions requestOptions) {
*
* Gets operation info.
* <p><strong>Response Body Schema</strong></p>
*
* <pre>{@code
* {
* kind: String (Required)
Expand Down Expand Up @@ -527,6 +543,7 @@ public Response<BinaryData> getOperationWithResponse(String operationId, Request
*
* List all document models.
* <p><strong>Response Body Schema</strong></p>
*
* <pre>{@code
* {
* modelId: String (Required)
Expand Down Expand Up @@ -557,6 +574,7 @@ public PagedIterable<BinaryData> getDocumentModels(RequestOptions requestOptions
*
* Gets detailed document model information.
* <p><strong>Response Body Schema</strong></p>
*
* <pre>{@code
* {
* modelId: String (Required)
Expand Down Expand Up @@ -627,6 +645,7 @@ public Response<Void> deleteDocumentModelWithResponse(String modelId, RequestOpt
*
* Return information about the current resource.
* <p><strong>Response Body Schema</strong></p>
*
* <pre>{@code
* {
* customDocumentModels (Required): {
Expand Down
Loading

0 comments on commit bdcd1fd

Please sign in to comment.