Skip to content

Commit 3f1a964

Browse files
Google APIscopybara-github
Google APIs
authored and
copybara-github
committed
docs: Minor formatting
PiperOrigin-RevId: 551578436
1 parent 2397c3a commit 3f1a964

2 files changed

Lines changed: 23 additions & 23 deletions

File tree

‎google/cloud/translate/v3/translation_service.proto‎

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
// Copyright 2022 Google LLC
1+
// Copyright 2023 Google LLC
22
//
33
// Licensed under the Apache License, Version 2.0 (the "License");
44
// you may not use this file except in compliance with the License.
@@ -637,17 +637,17 @@ message DocumentOutputConfig {
637637
//
638638
// For a DocumentInputConfig.gcs_uri provided document, the output file will
639639
// have a name according to its URI. For example: an input file with URI:
640-
// "gs://a/b/c.[extension]" stored in a gcs_destination bucket with name
640+
// `gs://a/b/c.[extension]` stored in a gcs_destination bucket with name
641641
// "my_bucket" will have an output URI:
642-
// "gs://my_bucket/a_b_c_[trg]_translations.[ext]", where
642+
// `gs://my_bucket/a_b_c_[trg]_translations.[ext]`, where
643643
// - [trg] corresponds to the translated file's language code,
644644
// - [ext] corresponds to the translated file's extension according to its
645645
// mime type.
646646
//
647647
//
648648
// If the document was directly provided through the request, then the
649649
// output document will have the format:
650-
// "gs://my_bucket/translated_document_[trg]_translations.[ext], where
650+
// `gs://my_bucket/translated_document_[trg]_translations.[ext]`, where
651651
// - [trg] corresponds to the translated file's language code,
652652
// - [ext] corresponds to the translated file's extension according to its
653653
// mime type.
@@ -656,7 +656,7 @@ message DocumentOutputConfig {
656656
// translation will be equal to the default output URI but have
657657
// `glossary_translations` instead of `translations`. For the previous
658658
// example, its glossary URI would be:
659-
// "gs://my_bucket/a_b_c_[trg]_glossary_translations.[ext]".
659+
// `gs://my_bucket/a_b_c_[trg]_glossary_translations.[ext]`.
660660
//
661661
// Thus the max number of output files will be 2 (Translated document,
662662
// Glossary translated document).
@@ -1362,15 +1362,15 @@ message BatchDocumentOutputConfig {
13621362
//
13631363
// The naming format of translation output files follows (for target
13641364
// language code [trg]): `translation_output`:
1365-
// gs://translation_output/a_b_c_[trg]_translation.[extension]
1365+
// `gs://translation_output/a_b_c_[trg]_translation.[extension]`
13661366
// `glossary_translation_output`:
1367-
// gs://translation_test/a_b_c_[trg]_glossary_translation.[extension] The
1367+
// `gs://translation_test/a_b_c_[trg]_glossary_translation.[extension]`. The
13681368
// output document will maintain the same file format as the input document.
13691369
//
13701370
// The naming format of error output files follows (for target language code
1371-
// [trg]): `error_output`: gs://translation_test/a_b_c_[trg]_errors.txt
1371+
// [trg]): `error_output`: `gs://translation_test/a_b_c_[trg]_errors.txt`
13721372
// `glossary_error_output`:
1373-
// gs://translation_test/a_b_c_[trg]_glossary_translation.txt The error
1373+
// `gs://translation_test/a_b_c_[trg]_glossary_translation.txt`. The error
13741374
// output is a txt file containing error details.
13751375
GcsDestination gcs_destination = 1;
13761376
}

‎google/cloud/translate/v3beta1/translation_service.proto‎

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
// Copyright 2021 Google LLC
1+
// Copyright 2023 Google LLC
22
//
33
// Licensed under the Apache License, Version 2.0 (the "License");
44
// you may not use this file except in compliance with the License.
@@ -552,10 +552,10 @@ message OutputConfig {
552552
// If input file extension is a txt or html, the translation is directly
553553
// written to the output file. If glossary is requested, a separate
554554
// glossary_translations_file has format of
555-
// gs://translation_test/a_b_c_'trg'_glossary_translations.[extension]
555+
// `gs://translation_test/a_b_c_'trg'_glossary_translations.[extension]`
556556
//
557557
// The format of errors file (for target language code 'trg') is:
558-
// gs://translation_test/a_b_c_'trg'_errors.[extension]
558+
// `gs://translation_test/a_b_c_'trg'_errors.[extension]`
559559
//
560560
// If the input file extension is tsv, errors_file contains the following:
561561
// Column 1: ID of the request provided in the input, if it's not
@@ -567,7 +567,7 @@ message OutputConfig {
567567
//
568568
// If the input file extension is txt or html, glossary_error_file will be
569569
// generated that contains error details. glossary_error_file has format of
570-
// gs://translation_test/a_b_c_'trg'_glossary_errors.[extension]
570+
// `gs://translation_test/a_b_c_'trg'_glossary_errors.[extension]`
571571
GcsDestination gcs_destination = 1;
572572
}
573573
}
@@ -628,17 +628,17 @@ message DocumentOutputConfig {
628628
//
629629
// For a DocumentInputConfig.gcs_uri provided document, the output file will
630630
// have a name according to its URI. For example: an input file with URI:
631-
// "gs://a/b/c.[extension]" stored in a gcs_destination bucket with name
631+
// `gs://a/b/c.[extension]` stored in a gcs_destination bucket with name
632632
// "my_bucket" will have an output URI:
633-
// "gs://my_bucket/a_b_c_[trg]_translations.[ext]", where
633+
// `gs://my_bucket/a_b_c_[trg]_translations.[ext]`, where
634634
// - [trg] corresponds to the translated file's language code,
635635
// - [ext] corresponds to the translated file's extension according to its
636636
// mime type.
637637
//
638638
//
639639
// If the document was directly provided through the request, then the
640640
// output document will have the format:
641-
// "gs://my_bucket/translated_document_[trg]_translations.[ext], where
641+
// `gs://my_bucket/translated_document_[trg]_translations.[ext]`, where
642642
// - [trg] corresponds to the translated file's language code,
643643
// - [ext] corresponds to the translated file's extension according to its
644644
// mime type.
@@ -647,7 +647,7 @@ message DocumentOutputConfig {
647647
// translation will be equal to the default output URI but have
648648
// `glossary_translations` instead of `translations`. For the previous
649649
// example, its glossary URI would be:
650-
// "gs://my_bucket/a_b_c_[trg]_glossary_translations.[ext]".
650+
// `gs://my_bucket/a_b_c_[trg]_glossary_translations.[ext]`.
651651
//
652652
// Thus the max number of output files will be 2 (Translated document,
653653
// Glossary translated document).
@@ -1202,7 +1202,7 @@ message BatchTranslateDocumentRequest {
12021202

12031203
// Required. The BCP-47 language code of the input document if known, for
12041204
// example, "en-US" or "sr-Latn". Supported language codes are listed in
1205-
// Language Support (https://cloud.google.com/translate/docs/languages).
1205+
// [Language Support](https://cloud.google.com/translate/docs/languages).
12061206
string source_language_code = 2 [(google.api.field_behavior) = REQUIRED];
12071207

12081208
// Required. The BCP-47 language code to use for translation of the input
@@ -1321,19 +1321,19 @@ message BatchDocumentOutputConfig {
13211321
// Since index.csv will be keeping updated during the process, please make
13221322
// sure there is no custom retention policy applied on the output bucket
13231323
// that may avoid file updating.
1324-
// (https://cloud.google.com/storage/docs/bucket-lock?hl=en#retention-policy)
1324+
// (https://cloud.google.com/storage/docs/bucket-lock#retention-policy)
13251325
//
13261326
// The naming format of translation output files follows (for target
13271327
// language code [trg]): `translation_output`:
1328-
// gs://translation_output/a_b_c_[trg]_translation.[extension]
1328+
// `gs://translation_output/a_b_c_[trg]_translation.[extension]`
13291329
// `glossary_translation_output`:
1330-
// gs://translation_test/a_b_c_[trg]_glossary_translation.[extension] The
1330+
// `gs://translation_test/a_b_c_[trg]_glossary_translation.[extension]`. The
13311331
// output document will maintain the same file format as the input document.
13321332
//
13331333
// The naming format of error output files follows (for target language code
1334-
// [trg]): `error_output`: gs://translation_test/a_b_c_[trg]_errors.txt
1334+
// [trg]): `error_output`: `gs://translation_test/a_b_c_[trg]_errors.txt`
13351335
// `glossary_error_output`:
1336-
// gs://translation_test/a_b_c_[trg]_glossary_translation.txt The error
1336+
// `gs://translation_test/a_b_c_[trg]_glossary_translation.txt` The error
13371337
// output is a txt file containing error details.
13381338
GcsDestination gcs_destination = 1;
13391339
}

0 commit comments

Comments
 (0)