Add some comments to clarify string usage for translators

git-svn-id: https://connectbot.googlecode.com/svn/trunk/connectbot@380 df292f66-193f-0410-a5fc-6d59da041ff2

2 files changed, 8 insertions, 3 deletions

diff --git a/AndroidManifest.xml b/AndroidManifest.xml
index 1e761ea..a3fdc41 100644
--- a/AndroidManifest.xml
+++ b/AndroidManifest.xml
@@ -2,7 +2,7 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
 	package="org.connectbot"
 	android:versionName="1.6-dev"
-	android:versionCode="180">
+	android:versionCode="181">
 	
 	<application
 		android:icon="@drawable/icon"
diff --git a/res/values/strings.xml b/res/values/strings.xml
index 1dd7441..227885f 100644
--- a/res/values/strings.xml
+++ b/res/values/strings.xml
@@ -17,6 +17,7 @@
 	<string name="title_colors">Colors</string>
 
 	<string name="resolve_connect">Connect</string>
+	<!-- Menu selection where user must move finger randomly over an area to gather entropy (collect random bits) -->
 	<string name="resolve_entropy">Gather Entropy</string>
 
 	<string name="menu_insert">Add Host</string>
@@ -30,12 +31,14 @@
 	<string name="pubkey_generate">Generate</string>
 	<string name="pubkey_import">Import</string>
 	<string name="pubkey_delete">Delete key</string>
+	<!-- Dialog title when user must move finger randomly over an area to gather entropy (collect random bits) -->
 	<string name="pubkey_gather_entropy">Gathering Entropy</string>
 	<string name="pubkey_touch_prompt">Touch this box to gather randomness: %1$d%% done</string>
 	<string name="pubkey_touch_hint">In order to assure randomness during the key generation, move your finger randomly over the box below.</string>
 	<string name="pubkey_generating">Generating key pair...</string>
 	<string name="pubkey_copy_private">Copy private key</string>
 	<string name="pubkey_copy_public">Copy public key</string>
+	<!-- Note that the '\n' just splits lines, so it's actually "create or import" -->
 	<string name="pubkey_list_empty">Tap "Menu" to create\nor import key pairs.</string>
 	<string name="pubkey_unknown_format">Unknown format</string>
 	<string name="pubkey_change_password">Change password</string>
@@ -49,6 +52,7 @@
 	<!-- Pubkey preference asking user whether the key use should be confirmed via prompt before it can be used for authentication -->
 	<string name="pubkey_confirm_use">Confirm before use</string>
 
+	<!-- Note that the '\n' splits lines, so it's actually "create port forwards" -->
 	<string name="portforward_list_empty">Tap "Menu" to create\nport forwards.</string>
 	<string name="portforward_edit">Edit port forward</string>
 	<string name="portforward_delete">Delete port forward</string>
@@ -73,7 +77,7 @@
 	<!-- Prompt for the password to unlock a certain pubkey. -->
 	<string name="prompt_pubkey_password">Password for key '%1$s'</string>
 
-	<!-- Prompt for whether to allow SSH Authentication Agent to use the specified key -->
+	<!-- Prompt for whether to allow SSH Authentication Agent to use the specified key. Note that the '\n' means split the line so it's actually "host to use key" -->
 	<string name="prompt_allow_agent_to_use_key">Allow remote host to\nuse key '%1$s'?</string>
 
 	<!-- The header of the warning a user gets when the host key has changed. Note that this can be a very serious attack, so we try to be as "loud" to the user as possible. -->
@@ -277,7 +281,7 @@
 
 	<!-- 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. -->
+	<!-- 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 close the disconnected terminal window. -->
@@ -331,6 +335,7 @@
 	<string name="list_host_edit">Edit host</string>
 	<string name="list_host_portforwards">Edit port forwards</string>
 	<string name="list_host_delete">Delete host</string>
+	<!-- Note that the '\n' splits the lines so it's actually "quick-connect box below to connect" -->
 	<string name="list_host_empty">Use the quick-connect box\nbelow to connect to a host.</string>
 
 	<!-- Default screen rotation preference selection -->