Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Update in-program help files

Add new virtual keyboard help topic and use that file in the wizard.

git-svn-id: https://connectbot.googlecode.com/svn/trunk/connectbot@400 df292f66-193f-0410-a5fc-6d59da041ff2
  • Loading branch information...
commit 4964305192e660147248006978a2bdbe2ed72143 1 parent b899cd8
@kruton kruton authored
View
2  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="194">
+ android:versionCode="195">
<application
android:icon="@drawable/icon"
View
39 assets/help/Keyboard.html
@@ -1,39 +0,0 @@
-<html>
-<body style="background-color: #000; color: #fff">
-
-<h2>Keyboard magic</h2>
-<img src="i/keyboard.jpg" width="100%" />
-<table style="width: 100%">
- <tr>
- <th>Volume&nbsp;key</th>
- <td>Tap up/down to change font size in console</td>
- </tr>
-
- <tr>
- <th>Right&nbsp;alt</th>
- <td>Tap for '/'</td>
- </tr>
-
- <tr>
- <th>Right&nbsp;shift</th>
- <td>Tap for 'TAB' key</td>
- </tr>
-
- <tr>
- <th>Trackball</th>
- <td>Tap once to toggle CTRL on, twice to send Esc</td>
- </tr>
-
- <tr>
- <th>Left shift</th>
- <td>Hold left shift and tap number for F1, F2, etc</td>
- </tr>
-
- <tr>
- <th>Picture&nbsp;key</th>
- <td>Tap to send Ctrl+A Space (for 'screen' users)</td>
- </tr>
-</table>
-
-</body>
-</html>
View
62 assets/help/PhysicalKeyboard.html
@@ -0,0 +1,62 @@
+<html>
+<body style="background-color: #000; color: #fff">
+
+<p><img
+ src="http://connectbot.googlecode.com/svn/trunk/www/keyboard.jpg" /></p>
+<p>Here are some keyboard shortcuts available when a <strong>hardware
+keyboard</strong> is present. If you&#x27;re using a phone where the main input
+type is a <strong>virtual keyboard</strong>, please see the VirtualKeyboard help topic.
+</p>
+<p><strong>Note:</strong> the side that <strong>shift</strong>, <strong>alt</strong>,
+<strong>slash</strong>, and <strong>tab</strong> uses can be changed in
+preferences between left, right, and disabled.</p>
+<ul>
+ <li>Control key (CTRL)</li>
+ <blockquote>Pressing once on the trackball will toggle on
+ <strong>control</strong> for the next character typed. The cursor will
+ indicate this state with a &lt; symbol. Note that pressing the
+ trackball again will send an <strong>escape</strong> key.</blockquote>
+</ul>
+<ul>
+ <li>Escape (ESC)</li>
+ <blockquote>Pressing twice on the trackball will send <strong>escape</strong>
+ key. Note that some other terminal emulators map pressing <strong>ALT-<i>key</i></strong>
+ to <strong>escape + <i>key</i></strong>.</blockquote>
+</ul>
+<ul>
+ <li>Shift</li>
+ <blockquote>Pressing the <strong>shift</strong> (up arrow)
+ key once will make the next key typed its uppercase variant according
+ to the keyboard layout. This state is indicated with an outline of a
+ triangle on the top of the cursor. Pressing it twice will turn on <strong>shift
+ lock</strong> which is indicated by a solid triangle on the top of the cursor.</blockquote>
+</ul>
+<ul>
+ <li>Alt</li>
+ <blockquote>Pressing the <strong>Alt</strong> key once
+ will make the next key typed its symbol as indicated on the keyboard.
+ This state is indicated with the outline of a triangle on the bottom of
+ the cursor. Pressing it twice will turn on <strong>alt lock</strong>
+ which is indicated by a solid triangle on the bottom of the cursor.</blockquote>
+</ul>
+<ul>
+ <li>Slash (opposite side Alt)</li>
+ <blockquote>The opposite side <strong>alt</strong> key can
+ be used as a shortcut for the forward slash / character. This aids in
+ quickly typing directories on the G1.</blockquote>
+</ul>
+<ul>
+ <li>Tab (opposite side Shift)</li>
+ <blockquote>The opposite side <strong>shift</strong> key
+ can be used as a shortcut for the <strong>tab</strong> key (CTRL-i) for
+ quick completion in many shells.</blockquote>
+</ul>
+<ul>
+ <li>Function keys (F1 through F10)</li>
+ <blockquote>Hold down the shift key and press numbers 1
+ through 10 to send F1 through F10 respectively.</blockquote>
+</ul>
+
+
+</body>
+</html>
View
38 assets/help/ScreenGestures.html
@@ -0,0 +1,38 @@
+<html>
+<body style="background-color: #000; color: #fff">
+
+<p>Gestures in ConnectBot allow a user to do several things for
+which there&#x27;s no keyboard equivalent. If the gestures seem
+backward, then imagine that you&#x27;re grabbing the text and moving it
+with your finger.</p>
+<h1><a name="Page_Up_/_Page_Down" />Page Up / Page Down</h1>
+<p>Swiping your finger up and down on the left third of the screen
+will send a page up and page down key to the remote host. Many programs
+map this to scrolling back into history such as irssi or tinyfugue.</p>
+<p><img
+ src="http://connectbot.googlecode.com/svn/trunk/www/gesture-pgup.png" />
+Page Up gesture</p>
+<p><img
+ src="http://connectbot.googlecode.com/svn/trunk/www/gesture-pgdn.png" />
+Page Down gesture</p>
+<h1><a name="Scroll_back_/_Scroll_forward" />Scroll back / Scroll
+forward</h1>
+<p>Swiping your finger up on the right side of the screen allows you
+to scroll backward and forward in the local terminal buffer history.</p>
+<p><img
+ src="http://connectbot.googlecode.com/svn/trunk/www/gesture-scrollback.png" />
+Scroll back gesture</p>
+<p><img
+ src="http://connectbot.googlecode.com/svn/trunk/www/gesture-scrollforward.png" />
+Scroll forward gesture</p>
+<h1><a name="Switching_hosts" />Switching hosts</h1>
+<p>Swiping your finger from one side of the screen to the other will
+switch between currently connected hosts.</p>
+<p><img
+ src="http://connectbot.googlecode.com/svn/trunk/www/gesture-hostprev.png" />
+Previous host gesture</p>
+<p><img
+ src="http://connectbot.googlecode.com/svn/trunk/www/gesture-hostnext.png" />
+Next host gesture</p>
+</body>
+</html>
View
49 assets/help/VirtualKeyboard.html
@@ -0,0 +1,49 @@
+<html>
+<body style="background-color: #000; color: #fff">
+
+<p><img src="http://connectbot.googlecode.com/svn/trunk/www/magic-cb-screen.png" width="100%" /></p>
+
+<h2>Caveats</h2>
+<p>Since ConnectBot doesn&#x27;t use any of the normal TextView
+widgets, Android&#x27;s IME structure isn&#x27;t designed to directly
+support it.</p>
+<p>The best way to use Android with a virtual keyboard is in <strong>Portrait</strong>
+mode. By default, ConnectBot is set to use <strong>Portrait</strong>
+mode when no hardware keyboard is present. To change this setting, go to
+<strong>Preferences</strong> from the <strong>Host List</strong>.</p>
+<p>In <strong>Landscape</strong> mode, the Android virtual keyboard
+(or other IMEs) will take up the entire screen. Android provides no way
+for ConnectBot to resize the terminal view in <strong>Landscape</strong>.
+However, you may use a <i>work-around</i>: <strong>Force Resize</strong>
+to fit above the virtual keyboard if desired.</p>
+<p>On devices without a hardware keyboard, you may press and hold
+the <strong>MENU</strong> button to bring up the virtual keyboard. NOTE:
+This applies to any program on the Android platform; it is not
+ConnectBot specific.</p>
+<h2>How to Enter Control, Alt, Escape, and Function Keys</h2>
+<p>You can enter any key combination with ConnectBot and the virtual
+keyboard, but you must know how keys are mapped on a normal console. For
+instance, usually combinations of ALT+letter on a PC keyboard are
+actually mapped to sending, sequentially, ESC key then the letter.</p>
+<p>Note there are also screen gestures: see the ScreenGestures help topic.</a>
+for <strong>Page Up</strong> and <strong>Page Down</strong>.</p>
+<ul>
+ <li>Trackball: 1 press is <strong>CTRL</strong>, 2 presses sends <strong>ESC</strong>
+ </li>
+ <li><strong>Tab key</strong> = <strong>CTRL + i</strong></li>
+ <li><strong>Function key</strong> = <strong>CTRL + number</strong>
+ </li>
+</ul>
+<h2>Examples</h2>
+<ul>
+ <li><strong>ESC</strong> = Press the trackball twice.</li>
+ <li><strong>ALT + Right Arrow</strong> = Press trackball twice
+ then move trackball to right.</li>
+ <li><strong>CTRL + A</strong> = Press trackball once then tap the
+ &quot;A&quot; key on the soft keyboard.</li>
+ <li><strong>F3</strong> = Press trackball once then tap the
+ &quot;3&quot; key on the soft keyboard.</li>
+</ul>
+
+</body>
+</html>
View
BIN  assets/help/i/keyboard.jpg
Deleted file not rendered
View
3  res/values/arrays.xml
@@ -106,7 +106,8 @@
<string-array name="list_wizard_topics">
<item>Hints</item>
- <item>Keyboard</item>
+ <item>PhysicalKeyboard</item>
+ <item>VirtualKeyboard</item>
</string-array>
<string-array name="list_delkey">
Please sign in to comment.
Something went wrong with that request. Please try again.