From 4a9be9af8881450bb350e2e2b1707fed3d6c9403 Mon Sep 17 00:00:00 2001
From: Kenny Root <kenny@the-b.org>
Date: Tue, 7 Apr 2009 05:15:05 +0000
Subject: Add comments for strings to aid in translations.

---
 res/values/strings.xml | 80 +++++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 72 insertions(+), 8 deletions(-)

diff --git a/res/values/strings.xml b/res/values/strings.xml
index ebb19d5..dbdab92 100644
--- a/res/values/strings.xml
+++ b/res/values/strings.xml
@@ -3,10 +3,15 @@
 	<string name="app_name">ConnectBot</string>
 	<string name="app_desc">Simple, powerful, open-source SSH client.</string>
 
+	<!-- Window title for the Host List -->
 	<string name="title_hosts_list">Hosts</string>
+	<!-- Window title for the Pubkeys List -->
 	<string name="title_pubkey_list">Pubkeys</string>
+	<!-- Window title for the Port Forwards List -->
 	<string name="title_port_forwards_list">Port forwards</string>
+	<!-- Window title when editing host details -->
 	<string name="title_host_editor">Edit Host</string>
+	<!-- Window title for Help index -->
 	<string name="title_help">Help</string>
 
 	<string name="title_password">Input Password</string>
@@ -42,7 +47,7 @@
 	<string name="pubkey_import_parse_problem">Problem parsing imported private key
 	</string>
 	<string name="pubkey_unlock">Unlock key</string>
-	<string name="pubkey_failed_add">Bad password for key '%s'. Authentication failed.</string>
+	<string name="pubkey_failed_add">Bad password for key '%1$s'. Authentication failed.</string>
 	<string name="pubkey_memory_load">Load into memory</string>
 	<string name="pubkey_memory_unload">Unload from memory</string>
 	<string name="pubkey_load_on_start">Load key on start</string>
@@ -52,11 +57,15 @@
 	<string name="portforward_delete">Delete port forward</string>
 
 	<string name="prompt_nickname">Nickname:</string>
+	<!-- The source TCP port for port forwards. -->
 	<string name="prompt_source_port">Source port:</string>
+	<!-- The "host:port" combination used for port forward destinations. -->
 	<string name="prompt_destination">Destination:</string>
 	<string name="prompt_old_password">Old password:</string>
 	<string name="prompt_password">Password:</string>
+	<!-- Added after a "Password:" prompt to indicate user needs to confirm entry. -->
 	<string name="prompt_again">(again)</string>
+	<!-- Label for the user to select port forward type. -->
 	<string name="prompt_type">Type:</string>
 
 	<string name="alert_passwords_do_not_match_msg">Passwords do not match!</string>
@@ -64,9 +73,13 @@
 	<string name="alert_key_corrupted_msg">Private key appears corrupt!</string>
 	<string name="alert_sdcard_absent">SD card is not inserted!</string>
 
+	<!-- Add a new item (e.g., host or pubkey) to the list. -->
 	<string name="button_add">Add</string>
+	<!-- Change an existing item's (e.g., host or pubkey) details. -->
 	<string name="button_change">Change</string>
+	<!-- Button that begins the generation of a public key pair. -->
 	<string name="button_generate">Generate Key</string>
+	<!-- Button that resizes the screen to the user-specified dimensions. -->
 	<string name="button_resize">Resize</string>
 
 	<string name="alert_disconnect_msg">Connection Lost</string>
@@ -75,51 +88,88 @@
 
 	<!-- DO NOT MANUALLY UPDATE VERSION!!!
 	  Updating is update by the ant task "update-version" in build.xml
+	  Do not translate.
 	-->
 	<string name="msg_version">ConnectBot (working copy)</string>
 
+	<!-- Do not translate -->
 	<string name="pref_emulation">emulation</string>
+	<!-- Do not translate -->
 	<string name="pref_scrollback">scrollback</string>
+	<!-- Do not translate -->
 	<string name="pref_keepalive">keepalive</string>
+	<!-- Do not translate -->
 	<string name="pref_keymode">keymode</string>
+	<!-- Do not translate -->
 	<string name="pref_memkeys">memkeys</string>
+	<!-- Do not translate -->
 	<string name="pref_rotation">rotation</string>
+	<!-- Do not translate -->
 	<string name="pref_camera">camera</string>
+	<!-- Do not translate -->
 	<string name="pref_update">update</string>
+	<!-- Do not translate -->
 	<string name="pref_lastchecked">lastchecked</string>
+	<!-- Do not translate -->
 	<string name="pref_fullscreen">fullscreen</string>
+	<!-- Do not translate -->
 	<string name="pref_wifilock">wifilock</string>
+	<!-- Do not translate -->
 	<string name="pref_bumpyarrows">bumpyarrows</string>
 
+	<!-- Preference selection to indicate use of right side of keyboard for special shortcuts. -->
 	<string name="list_keymode_right">Use right-side keys</string>
+	<!-- Preference selection to indicate use of left side of keyboard for special shortcuts. -->
 	<string name="list_keymode_left">Use left-side keys</string>
+	<!-- Preference selection to indicate never to use special shortcut keys. -->
 	<string name="list_keymode_none">Disable</string>
 
+	<!-- Preference to not use pubkeys to authenticate to this host. -->
 	<string name="list_pubkeyids_none">Do not use keys</string>
+	<!-- Preference to use any pubkey to authenticate to this host. -->
 	<string name="list_pubkeyids_any">Use any unlocked key</string>
 
+	<!-- Frequency for which to check for program updates. -->
 	<string name="list_update_daily">Daily</string>
+	<!-- Frequency for which to check for program updates. -->
 	<string name="list_update_weekly">Weekly</string>
+	<!-- Frequency for which to check for program updates. -->
 	<string name="list_update_never">Never</string>
 
-	<string name="bind_minutes">%s minutes ago</string>
-	<string name="bind_hours">%s hours ago</string>
-	<string name="bind_days">%s days ago</string>
+	<!-- The time that has elapsed since a host was connected to when it has been less than an hour. -->
+	<string name="bind_minutes">%1$s minutes ago</string>
+	<!-- The time that has elapsed since a host was connected to when it has been less than a day. -->
+	<string name="bind_hours">%1$s hours ago</string>
+	<!-- The time that has elapsed since a host was connected to when it has been a day or more. -->
+	<string name="bind_days">%1$s days ago</string>
 
-	<string name="console_copy_done">Copied %d bytes to clipboard</string>
+	<!-- Message given when user copies from the terminal. -->
+	<string name="console_copy_done">Copied %1$d bytes to clipboard</string>
+	<!-- Instructions for how to copy from the terminal. The \n entries are to split lines to improve readability and prevent wrapping off the screen. -->
 	<string name="console_copy_start">Touch and drag\nor use directional pad\nto select area to copy</string>
 
+	<!-- Button to disconnect from the current host in a terminal. -->
 	<string name="console_menu_disconnect">Disconnect</string>
+	<!-- Button to close the disconnected terminal window. -->
 	<string name="console_menu_close">Close</string>
+	<!-- Button to begin copying from the terminal to the clipboard. -->
 	<string name="console_menu_copy">Copy</string>
+	<!-- Button to paste from the clipboard to the terminal. -->
 	<string name="console_menu_paste">Paste</string>
+	<!-- Button that brings user to the Port Forwards List. -->
 	<string name="console_menu_portforwards">Port Forwards</string>
+	<!-- Button that brings user to the terminal resizing dialog where they can force a size. -->
 	<string name="console_menu_resize">Force Size</string>
 
+	<!-- Selection for a "local" port forward. E.g., connections to a port listening locally is forwarded to the remote end's listening port. -->
 	<string name="portforward_local">Local</string>
+	<!-- Selection for a "remote" port forward. E.g., connections to a port listening remotely is forwarded to the local end's listening port. -->
 	<string name="portforward_remote">Remote</string>
+	<!-- Selection for a "dynamic" port forward. E.g., connections to a port listening locally is forwarded based on the SOCKS protocol to an arbitrary remote host and port. -->
 	<string name="portforward_dynamic">Dynamic (SOCKS)</string>
+	<!-- Button that commits the port forward to be made from the Port Forward Creation dialog. -->
 	<string name="portforward_pos">Create port forward</string>
+	<!-- Button that cancels the creation of a port forward from the Port Forward Creation dialog. -->
 	<string name="portforward_neg">Cancel</string>
 
 	<string name="portforward_done">Successfully created port forward</string>
@@ -130,7 +180,9 @@
 	<string name="list_format_error">Use the format 'username@hostname:port'</string>
 
 	<string name="list_menu_pubkeys">Manage Pubkeys</string>
+	<!-- Selection choice to sort hosts by color. -->
 	<string name="list_menu_sortcolor">Sort by color</string>
+	<!-- Selection choice to sort hosts by nickname. -->
 	<string name="list_menu_sortname">Sort by name</string>
 	<string name="list_menu_settings">Settings</string>
 	<string name="list_menu_help">Help</string>
@@ -143,24 +195,33 @@
 
 	<string name="list_rotation_land">Force landscape</string>
 	<string name="list_rotation_port">Force portrait</string>
+	<!-- Selection to indicate the rotation should be selected automatically based on the tilt sensor. -->
 	<string name="list_rotation_auto">Automatic</string>
 
+	<!-- Selection to indicate pressing the Camera button should send "Ctrl+A then Space". -->
 	<string name="list_camera_ctrlaspace">Ctrl+A then Space</string>
+	<!-- Selection to indicate pressing the Camera button should send "Ctrl+A". -->
 	<string name="list_camera_ctrla">Ctrl+A</string>
+	<!-- Selection to indicate pressing the Camera button should send the "Esc" key. -->
 	<string name="list_camera_esc">Esc</string>
+	<!-- Selection to indicate pressing the Camera button should send nothing at all. -->
 	<string name="list_camera_none">None</string>
 
-	<string name="delete_message">Are you sure you want to delete '%s'?</string>
+	<string name="delete_message">Are you sure you want to delete '%1$s'?</string>
 	<string name="delete_pos">Yes, delete</string>
 	<string name="delete_neg">Cancel</string>
 
+	<!-- Button to agree to license terms. -->
 	<string name="wizard_agree">Agree</string>
+	<!-- Button to cancel out of (i.e., not accept) the license terms. -->
 	<string name="wizard_cancel">Cancel</string>
+	<!-- Button to go to the next page in the first time start-up wizard. -->
 	<string name="wizard_next">Next</string>
+	<!-- Button to go to the next page in the first time start-up wizard. -->
 	<string name="wizard_back">Back</string>
 
-	<string name="terminal_hostkey_warn">The authenticity of host '%s' can't be established.</string>
-	<string name="terminal_hostkey">RSA key fingerprint is %s</string>
+	<string name="terminal_hostkey_warn">The authenticity of host '%1$s' can't be established.</string>
+	<string name="terminal_hostkey">RSA key fingerprint is %1$s</string>
 	<string name="terminal_hostkey_prompt">Are you sure you want\nto continue connecting?</string>
 
 	<string name="terminal_failed">Host key verification failed.</string>
@@ -176,7 +237,10 @@
 
 	<string name="terminal_auth_fail">[Your host doesn't support 'password' or 'keyboard-interactive' authentication.]</string>
 
+	<!-- Dialog title when a new version of ConnectBot is detected. -->
 	<string name="upgrade">New version</string>
+	<!-- Button selection to upgrade to the latest ConnectBot when one is available. -->
 	<string name="upgrade_pos">Yes, upgrade</string>
+	<!-- Button selection to skip upgrading to the latest ConnectBot when one is available. -->
 	<string name="upgrade_neg">Not right now</string>
 </resources>
-- 
cgit v1.2.3