Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 52996583 authored by François Degros's avatar François Degros
Browse files

Update some comments in strings.xml 

Enhance some comments by making them more precise and explicit.

Bug: 442944868
Flag: EXEMPT no functional change
Test: atest DocumentsUIGoogleTests:com.android.documentsui.services
Change-Id: I63ff9429381efc1edeb5e50986fa0f73822559a4
parent 610a36c5

res/values/strings.xml

+90 −18
Original line number Diff line number Diff line
@@ -315,55 +315,72 @@ 


    <!-- Title of the copy notification [CHAR LIMIT=24] -->

    <string name="copy_notification_title">Copying files</string>



    <!-- Title of the compress notification [CHAR LIMIT=24] -->

    <string name="compress_notification_title">Compressing files</string>



    <!-- Title of the extract notification [CHAR LIMIT=24] -->

    <string name="extract_notification_title">Extracting files</string>



    <!-- Title of the move notification [CHAR LIMIT=24] -->

    <string name="move_notification_title">Moving files</string>



    <!-- Title of the move notification [CHAR LIMIT=24] -->

    <string name="delete_notification_title">Deleting files</string>



    <!-- Title of the move to trash notification [CHAR LIMIT=24] -->

    <string name="move_to_trash_notification_title">Trashing files</string>



    <!-- Title of the restore from trash notification [CHAR LIMIT=24] -->

    <string name="restore_from_trash_notification_title">Restoring files</string>



    <!-- Text shown on the copy notification to indicate remaining time, in minutes [CHAR LIMIT=24] -->

    <string name="copy_remaining"><xliff:g id="duration" example="3 minutes">%s</xliff:g> left</string>



    <!-- Toast shown when a file copy is kicked off -->

    <plurals name="copy_begin">

        <item quantity="one">Copying <xliff:g id="count" example="1">%1$d</xliff:g> item.</item>

        <item quantity="other">Copying <xliff:g id="count" example="3">%1$d</xliff:g> items.</item>

    </plurals>



    <!-- Toast shown when a file compressing is kicked off -->

    <plurals name="compress_begin">

        <item quantity="one">Compressing <xliff:g id="count" example="1">%1$d</xliff:g> file.</item>

        <item quantity="other">Compressing <xliff:g id="count" example="3">%1$d</xliff:g> files.</item>

    </plurals>



    <!-- Toast shown when a file extracting is kicked off -->

    <plurals name="extract_begin">

        <item quantity="one">Extracting <xliff:g id="count" example="1">%1$d</xliff:g> file.</item>

        <item quantity="other">Extracting <xliff:g id="count" example="3">%1$d</xliff:g> files.</item>

    </plurals>



    <!-- Toast shown when a file move is kicked off -->

    <plurals name="move_begin">

        <item quantity="one">Moving <xliff:g id="count" example="1">%1$d</xliff:g> item.</item>

        <item quantity="other">Moving <xliff:g id="count" example="3">%1$d</xliff:g> items.</item>

    </plurals>



    <!-- Text shown when files are deleted -->

    <plurals name="deleting">

        <item quantity="one">Deleting <xliff:g id="count" example="1">%1$d</xliff:g> item.</item>

        <item quantity="other">Deleting <xliff:g id="count" example="3">%1$d</xliff:g> items.</item>

    </plurals>

    <!-- Text shown when files are trashed -->



    <!-- Progress message shown by the Android File Manager when one or more

         files are being moved to the trash bin.  -->

    <string name="trashing">{count, plural,

        =1 {Trashing <xliff:g id="count" example="1">{count}</xliff:g> item}

        other {Trashing <xliff:g id="count" example="3">{count}</xliff:g> items}

    }</string>

    <!-- Text shown when files are restoring from trash -->



    <!-- Progress message shown by the Android File Manager when one or more

         files are being restored from the trash bin. -->

    <string name="restoring_from_trash">{count, plural,

        =1 {Restoring <xliff:g id="count" example="1">{count}</xliff:g> item}

        other {Restoring <xliff:g id="count" example="3">{count}</xliff:g> items}

    }</string>



    <!-- Text shown for the undo button -->

    <string name="undo">Undo</string>

    <!-- Text shown on the notification while DocumentsUI performs setup in preparation for copying files [CHAR LIMIT=32] -->
@@ -386,75 +403,90 @@ 
    <string name="move_to_trash_progress"><xliff:g id="count" example="3">%1$d</xliff:g> / <xliff:g id="totalCount" example="5">%2$d</xliff:g></string>

    <!-- Text progress shown on the notification while DocumentsUI is restoring files. -->

    <string name="restore_from_trash_progress"><xliff:g id="count" example="3">%1$d</xliff:g> / <xliff:g id="totalCount" example="5">%2$d</xliff:g></string>



    <!-- Title of the copy error notification [CHAR LIMIT=48] -->

    <string name="copy_error_notification_title">{count, plural,

        =1 {Couldn\u2019t copy <xliff:g id="count" example="1">{count}</xliff:g> item}

        other {Couldn\u2019t copy <xliff:g id="count" example="2">{count}</xliff:g> items}

    }</string>



    <!-- Title of the compress error notification [CHAR LIMIT=48] -->

    <string name="compress_error_notification_title">{count, plural,

        =1 {Couldn\u2019t compress <xliff:g id="count" example="1">{count}</xliff:g> item}

        other {Couldn\u2019t compress <xliff:g id="count" example="2">{count}</xliff:g> items}

    }</string>



    <!-- Title of the extract error notification [CHAR LIMIT=48] -->

    <string name="extract_error_notification_title">{count, plural,

        =1 {Couldn\u2019t extract <xliff:g id="count" example="1">{count}</xliff:g> item}

        other {Couldn\u2019t extract <xliff:g id="count" example="2">{count}</xliff:g> items}

    }</string>



    <!-- Title of the move error notification [CHAR LIMIT=48] -->

    <string name="move_error_notification_title">{count, plural,

        =1 {Couldn\u2019t move <xliff:g id="count" example="1">{count}</xliff:g> item}

        other {Couldn\u2019t move <xliff:g id="count" example="2">{count}</xliff:g> items}

    }</string>



    <!-- Title of the delete error notification [CHAR LIMIT=48] -->

    <string name="delete_error_notification_title">{count, plural,

        =1 {Couldn\u2019t delete <xliff:g id="count" example="1">{count}</xliff:g> item}

        other {Couldn\u2019t delete <xliff:g id="count" example="2">{count}</xliff:g> items}

    }</string>



    <!-- Title of the trash file error notification [CHAR LIMIT=48] -->

    <string name="move_to_trash_error_notification_title">{count, plural,

        =1 {Couldn\u2019t trash <xliff:g id="count" example="1">{count}</xliff:g> item}

        other {Couldn\u2019t trash <xliff:g id="count" example="2">{count}</xliff:g> items}

    }</string>



    <!-- Title of the restore from trash error notification [CHAR LIMIT=48] -->

    <string name="restore_from_trash_error_notification_title">{count, plural,

        =1 {Couldn\u2019t restore <xliff:g id="count" example="1">{count}</xliff:g> item}

        other {Couldn\u2019t restore <xliff:g id="count" example="2">{count}</xliff:g> items}

    }</string>



    <!-- Second line for notifications saying that more information will be shown after touching [CHAR LIMIT=48] -->

    <string name="notification_touch_for_details">Tap to view details</string>

    <!-- Label of the close dialog button.[CHAR LIMIT=24] -->

    <string name="close">Close</string>



    <!-- Contents of the copying failure alert dialog. [CHAR LIMIT=48] -->

    <plurals name="copy_failure_alert_content">

        <item quantity="one">This file wasn\u2019t copied: <xliff:g id="list" example="Document.pdf">%1$s</xliff:g></item>

        <item quantity="other">These files weren\u2019t copied: <xliff:g id="list" example="Document.pdf, Photo.jpg, Song.ogg">%1$s</xliff:g></item>

    </plurals>



    <!-- Contents of the compressing failure alert dialog. [CHAR LIMIT=48] -->

    <plurals name="compress_failure_alert_content">

        <item quantity="one">This file wasn\u2019t compressed: <xliff:g id="list" example="Document.pdf">%1$s</xliff:g></item>

        <item quantity="other">These files weren\u2019t compressed: <xliff:g id="list" example="Document.pdf, Photo.jpg, Song.ogg">%1$s</xliff:g></item>

    </plurals>



    <!-- Contents of the extracting failure alert dialog. [CHAR LIMIT=48] -->

    <plurals name="extract_failure_alert_content">

        <item quantity="one">This file wasn\u2019t extracted: <xliff:g id="list" example="Document.pdf">%1$s</xliff:g></item>

        <item quantity="other">These files weren\u2019t extracted: <xliff:g id="list" example="Document.pdf, Photo.jpg, Song.ogg">%1$s</xliff:g></item>

    </plurals>



    <!-- Contents of the moving failure alert dialog. [CHAR LIMIT=48] -->

    <plurals name="move_failure_alert_content">

        <item quantity="one">This file wasn\u2019t moved: <xliff:g id="list" example="Document.pdf">%1$s</xliff:g></item>

        <item quantity="other">These files weren\u2019t moved: <xliff:g id="list" example="Document.pdf, Photo.jpg, Song.ogg">%1$s</xliff:g></item>

    </plurals>



    <!-- Contents of the deleting failure alert dialog. [CHAR LIMIT=48] -->

    <plurals name="delete_failure_alert_content">

        <item quantity="one">This file wasn\u2019t deleted: <xliff:g id="list" example="Document.pdf">%1$s</xliff:g></item>

        <item quantity="other">These files weren\u2019t deleted: <xliff:g id="list" example="Document.pdf, Photo.jpg, Song.ogg">%1$s</xliff:g></item>

    </plurals>



    <!-- Contents of the copying warning dialog due to converted files. [CHAR LIMIT=64] -->

    <plurals name="copy_converted_warning_content">

        <item quantity="one">This file was converted to another format: <xliff:g id="list" example="Document.pdf">%1$s</xliff:g></item>

        <item quantity="other">These files were converted to another format: <xliff:g id="list" example="Document.pdf, Photo.jpg, Song.ogg">%1$s</xliff:g></item>

    </plurals>



    <!-- Toast shown when a user copies files to clipboard. -->

    <plurals name="clipboard_files_clipped">

        <item quantity="one">Copied <xliff:g id="count" example="1">%1$d</xliff:g> item to clipboard.</item>
@@ -482,40 +514,56 @@ 
         during a copy. [CHAR LIMIT=48] -->

    <string name="notification_copy_files_converted_title">Some files were converted</string>



    <!-- Message informing user that files are being copied. -->

    <!-- Progress message shown by the Android File Manager when one or more

         files are being copied.  [CHAR_LIMIT=48] -->

    <string name="copy_in_progress">{count, plural,

        =1 {Copying \u201C<xliff:g id="filename" example="foobar.txt">{filename}</xliff:g>\u201D to \u201C<xliff:g id="directory" example="example folder">{directory}</xliff:g>\u201D}

        other {Copying # files to \u201C<xliff:g id="directory" example="example folder">{directory}</xliff:g>\u201D}

    }</string>

    <!-- Message informing user that files are being extracted from an archive. -->



    <!-- Progress message shown by the Android File Manager when one or more

         files are being extracted from an archive.  [CHAR_LIMIT=48] -->

    <string name="extract_in_progress">{count, plural,

        =1 {Extracting \u201C<xliff:g id="filename" example="foobar.txt">{filename}</xliff:g>\u201D to \u201C<xliff:g id="directory" example="example folder">{directory}</xliff:g>\u201D}

        other {Extracting # archives to \u201C<xliff:g id="directory" example="example folder">{directory}</xliff:g>\u201D}

    }</string>

    <!-- Message informing user that files are being moved. -->



    <!-- Progress message shown by the Android File Manager when one or more

         files are being moved from one folder to another.  [CHAR_LIMIT=48] -->

    <string name="move_in_progress">{count, plural,

        =1 {Moving \u201C<xliff:g id="filename" example="foobar.txt">{filename}</xliff:g>\u201D to \u201C<xliff:g id="directory" example="example folder">{directory}</xliff:g>\u201D}

        other {Moving # files to \u201C<xliff:g id="directory" example="example folder">{directory}</xliff:g>\u201D}

    }</string>

    <!-- Message informing user that files are being deleted. -->



    <!-- Progress message shown by the Android File Manager when one or more

         files are being deleted.  [CHAR_LIMIT=48] -->

    <string name="delete_in_progress">{count, plural,

        =1 {Deleting \u201C<xliff:g id="filename" example="foobar.txt">{filename}</xliff:g>\u201D}

        other {Deleting # files}

    }</string>

    <!-- Message informing user that files are being trashed. -->



    <!-- Progress message shown by the Android File Manager when one or more

         files are being moved to the trash bin.  [CHAR_LIMIT=48] -->

    <string name="trash_in_progress">{count, plural,

        =1 {Trashing <xliff:g id="filename" example="foobar.txt">{filename}</xliff:g>}

        other {Trashing # files}

    }</string>



    <!-- Progress message shown by the Android File Manager when one or more

         files are being restored from the trash bin.  [CHAR_LIMIT=48] -->

    <string name="restore_in_progress">{count, plural,

        =1 {Restoring <xliff:g id="filename" example="foobar.txt">{filename}</xliff:g>}

        other {Restoring # files}

    }</string>

    <!-- Message informing user that files are being compressed into an archive. -->



    <!-- Progress message shown by the Android File Manager when one or more

         files are being zipped, i.e. bundled together and compressed into a

         ZIP archive.  [CHAR_LIMIT=48] -->

    <string name="compress_in_progress">{count, plural,

        =1 {Zipping \u201C<xliff:g id="filename" example="foobar.txt">{filename}</xliff:g>\u201D}

        other {Zipping # files}

    }</string>



    <!-- Accessibility label for an icon button which shows the progress of file operations when clicked. -->

    <string name="job_progress_icon_label">Show file progress</string>

    <!-- Title for a pop-up window showing the progress of file operations. -->
@@ -530,25 +578,49 @@ 
    <string name="job_progress_item_byte_progress">

        <xliff:g id="currentBytes" example="2.4 MB">%1$s</xliff:g> of <xliff:g id="totalBytes" example="50 MB">%2$s</xliff:g>

    </string>

    <!-- Status message shown when a copy is completed. -->



    <!-- Success message shown by the Android File Manager when the operation

         copying one or more files finished successfully.  [CHAR_LIMIT=24] -->

    <string name="copy_completed">Copied</string>

    <!-- Status message shown when a move is completed. -->



    <!-- Success message shown by the Android File Manager when the operation

         moving one or more files from one folder to another finished

         successfully.  [CHAR_LIMIT=24] -->

    <string name="move_completed">Moved</string>

    <!-- Status message shown when a delete is completed. -->



    <!-- Success message shown by the Android File Manager when the operation

         deleting one or more files finished successfully.  [CHAR_LIMIT=24] -->

    <string name="delete_completed">Deleted</string>

    <!-- Status message shown when a compress file operation is completed. -->



    <!-- Success message shown by the Android File Manager when the operation

         zipping (i.e. bundling together and compressing) one or more files

         finished successfully.  [CHAR_LIMIT=24] -->

    <string name="compress_completed">Zipped</string>

    <!-- Status message shown when an extract file operation is completed. -->



    <!-- Success message shown by the Android File Manager when the operation

         extracting one or more files from an archive finished successfully.

         [CHAR_LIMIT=24] -->

    <string name="extract_completed">Extracted</string>

    <!-- Status message shown when a copy fails. -->



    <!-- Error message shown by the Android File Manager when one or more files

         failed to be copied.  [CHAR_LIMIT=24] -->

    <string name="copy_failed">Couldn\u2019t copy</string>

    <!-- Status message shown when a move fails. -->



    <!-- Error message shown by the Android File Manager when one or more files

         failed to be moved from one folder to another.  [CHAR_LIMIT=24] -->

    <string name="move_failed">Couldn\u2019t move</string>

    <!-- Status message shown when a delete fails. -->



    <!-- Error message shown by the Android File Manager when one or more files

         failed to be deleted.  [CHAR_LIMIT=24] -->

    <string name="delete_failed">Couldn\u2019t delete</string>

    <!-- Status message shown when a compress file operation fails. -->



    <!-- Error message shown by the Android File Manager when one or more files

         failed to be zipped (i.e. bundled and compressed into a ZIP archive).

         [CHAR_LIMIT=24] -->

    <string name="compress_failed">Couldn\u2019t zip</string>

    <!-- Status message shown when an extract file operation fails. -->



    <!-- Error message shown by the Android File Manager when one or more files

         failed to be extracted from an archive.  [CHAR_LIMIT=24] -->

    <string name="extract_failed">Couldn\u2019t extract</string>



    <!-- Accessibility label for a button to expand a notification. -->