Mercurial > 510Connectbot
changeset 360:7eb24880b111
add help files to the web documentation
| author | Carl Byington <carl@five-ten-sg.com> |
|---|---|
| date | Mon, 04 Aug 2014 08:10:12 -0700 |
| parents | 93621e963303 |
| children | 395a16681ae1 |
| files | Makefile assets/help/5250Keys.html assets/help/About.html assets/help/Hints.html assets/help/PhysicalKeyboard.html assets/help/ScreenGestures.html assets/help/VirtualKeyboard.html help/5250Keys.html.in help/About.html.in help/Hints.html.in help/Makefile help/PhysicalKeyboard.html.in help/ScreenGestures.html.in help/VirtualKeyboard.html.in help/footer help/header.android help/header.browser html/null.file xml/Makefile |
| diffstat | 18 files changed, 510 insertions(+), 346 deletions(-) [+] |
line wrap: on
line diff
--- a/Makefile Sun Aug 03 11:26:03 2014 -0700 +++ b/Makefile Mon Aug 04 08:10:12 2014 -0700 @@ -18,6 +18,7 @@ builder: sed -i -e 's/android:debuggable=".*"/android:debuggable="$(debuggable)"/g' AndroidManifest.xml rm -rf gen bin + (cd help; make) ndk-build clean; V=1 ndk-build android update project -p . -t android-16 ant $(style) @@ -27,6 +28,7 @@ docs: (cd xml; make) + (cd help; make) install: cp $(apk) $(dest)
--- a/assets/help/5250Keys.html Sun Aug 03 11:26:03 2014 -0700 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,14 +0,0 @@ -<html> -<head><meta http-equiv="content-type" content="text/html; charset=utf-8" /></head> -<body bgcolor="#000000" text="#FFFFFF" link="#00FFFF"> - -<h2>5250 Keys</h2> - -<ul> - <li><strong>ATTN</strong> = <strong>CTRL + A</strong></li> - <li><strong>SYSREQ</strong> = <strong>CTRL + S</strong></li> - <li><strong>RESET</strong> = <strong>CTRL + R</strong> or <strong>ESC</strong></li> -</ul> - -</body> -</html>
--- a/assets/help/About.html Sun Aug 03 11:26:03 2014 -0700 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,110 +0,0 @@ -<html> -<head><meta http-equiv="content-type" content="text/html; charset=utf-8" /></head> -<body bgcolor="#000000" text="#FFFFFF" link="#00FFFF"> - -<h2>510ConnectBot</h2> - -<p>Copyright © 2014 Carl Byington -<carl@five-ten-sg.com></p> - -<p>This is an enhanced version of the popular open-source telnet and -secure shell (SSH) client ConnectBot. It now includes tn5250 emulation.</p> - -<p>It is licensed under -the <a href="http://www.gnu.org/licenses/gpl-3.0.txt">GPLv3 or later -license</a>.</p> - -<p>The complete source code for this application is available at -<a href="http://www.five-ten-sg.com/510Connectbot"></a>http://www.five-ten-sg.com/510Connectbot</p> - -<h2>Credits</h2> - -<p> -This software is based on VX Connectbot provided under the Apache -License, Version 2.0. Copyright © 2012 Martin Matuska -<a href="http://connectbot.vx.sk">http://connectbot.vx.sk</a> -</p> - -<p> -Based on Irssiconnectbot provided under the Apache License, Version -2.0. Copyright © 2013 Iiro Uusitalo and Ville Kerminen -<a href="https://github.com/irssiconnectbot/irssiconnectbot">https://github.com/irssiconnectbot/irssiconnectbot</a> -</p> - -<p> -Based on ConnectBot provided under the Apache License, Version -2.0. Copyright © 2007-2008 Kenny Root -<a href="http://the-b.org">http://the-b.org</a> and Jeffrey Sharkey <a href="http://jsharkey.org">http://jsharkey.org</a> -</p> - -<p> -Based on the Ganymed SSH2 client provided under a BSD-style -license. Copyright © 2005 - 2006 Swiss Federal Institute of -Technology (ETH Zurich), Department of Computer -Science <a href="http://www.inf.ethz.ch">http://www.inf.ethz.ch</a>, -Christian Plattner. Copyright © 2006 - 2013 Christian Plattner. -<a href="http://code.google.com/p/ganymed-ssh-2/">http://code.google.com/p/ganymed-ssh-2/</a> -The Java implementations of the AES, Blowfish and 3DES ciphers have been -taken (and slightly modified) from the cryptography package released by -"The Legion Of The Bouncy Castle". -Copyright © 2000 - 2004 The Legion Of The Bouncy Castle -<a href="http://www.bouncycastle.org">http://www.bouncycastle.org</a> -The following disclaimer applies: -</p> - -<p> -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" -AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE -LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE -POSSIBILITY OF SUCH DAMAGE. -</p> - -<p> -Based on JTA Telnet/SSH client provided under the GPLv2 license. -Copyright © 1996-2005 Matthias L. Jugel and Marcus -Meiner <a href="http://www.javassh.org">http://www.javassh.org</a> -</p> - -<p> -Based on TN5250J terminal emulator provided under the GPLv2 -license. Copyright © 2001 Kenneth J. Pouncey. -<a href="http://tn5250j.sourceforge.net"></a>http://tn5250j.sourceforge.net -</p> - -<p> -Includes the JSOCKS library, provided under the GNU LGPL -license. <a href="http://jsocks.sourceforge.net">http://jsocks.sourceforge.net</a> -</p> - -<p> -Includes JZlib provided under a BSD-style license. Copyright © -2000-2004 JCraft, Inc. -<a href="http://www.jcraft.com">http://www.jcraft.com</a> -</p> - -<p> -Includes the ssh-agent service developed by Roberto Tyley -<a href="https://github.com/rtyley">https://github.com/rtyley</a> -</p> - -<p> -SCP file transfer support is based on -<a href="https://github.com/staktrace/connectbot/commits/filetransfer">https://github.com/staktrace/connectbot/commits/filetransfer</a> -modifications by Kartikaya Gupta. -</p> - -<p> -Internal file selection dialog is based on -<a href="http://code.google.com/p/android-file-dialog">http://code.google.com/p/android-file-dialog</a> Android File -Dialog by Alexander Ponomarev, provided under a BSD-style -license. -</p> - -</body></html>
--- a/assets/help/Hints.html Sun Aug 03 11:26:03 2014 -0700 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,14 +0,0 @@ -<html> -<head><meta http-equiv="content-type" content="text/html; charset=utf-8" /></head> -<body bgcolor="#000000" text="#FFFFFF" link="#00FFFF"> - -<h2>Helpful hints</h2> - -<p>When you have multiple sessions open, you can 'pan' between them by swiping your finger left-to-right or right-to-left over the screen.</p> - -<p>Long-press on your Android desktop to create direct shortcuts to frequently-used SSH hosts.</p> - -<p>Slide your finger up/down on the right-half of the terminal screen to look at the scrollback history. Slide up/down on the left-half to send the page up/down keys.</p> - -</body> -</html>
--- a/assets/help/PhysicalKeyboard.html Sun Aug 03 11:26:03 2014 -0700 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,111 +0,0 @@ -<html> -<head><meta http-equiv="content-type" content="text/html; charset=utf-8" /></head> -<body bgcolor="#000000" text="#FFFFFF" link="#00FFFF"> - -<h2>Physical Keyboard</h2> - -<p>Here are some keyboard shortcuts available when a <strong>hardware -keyboard</strong> is present. If you'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> -<p><strong>Note:</strong> to use advanced Sony Ericsson Xperia (mini) pro key mappings you -have to activate the appropriate option in application settings.</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 < symbol. Note that pressing the - trackball again will send an <strong>escape</strong> key.<br><br> - Xperia (mini) pro: the <strong>Language</strong> key (above right arrow) maps to CTRL. - </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>.<br><br> - Xperia (mini) pro: pressing the <strong>Language</strong> key (above right arrow) - twice maps to ESC</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 alt key with the shift key and press numbers 1 - through 0 to send F1 through F10 respectively.<br><br> - Xperia (mini) pro: pressing the <strong>Language</strong> (above right arrow) key twice - and a number (with <strong>Alt</strong>) maps to F1 through F10 - </blockquote> -</ul> -<ul> - <li>Navigation keys</li> - <blockquote><strong>Alt</strong> + Up Arrow = Page Up - <br><strong>Alt</strong> + Down Arrow = Page Down - <br><strong>Alt</strong> + Left Arrow = Home - <br><strong>Alt</strong> + Right Arrow = End - <br><strong>Search key</strong> = URL scan</blockquote> -</ul> -<ul> - <li>Other keys</li> - <blockquote><strong>Alt</strong> + BackSpace = Insert</blockquote> -</ul> -<ul> - <li>Additional mappings for Asus Transformer Series Mobile Dock:</li> - <blockquote><strong>Back key</strong> = ESC</blockquote> -</ul> -<ul> - <li>Additional mappings for Samsung Captivate Glide (SGH-i927):</li> - <blockquote><strong>Microphone key</strong> = TAB - <br><strong>.com</strong> = ESC - <br><strong>Alt</strong> + <strong>Shift</strong> + O = opening square bracket ([) - <br><strong>Alt</strong> + <strong>Shift</strong> + P = closing square bracket (]) - <br><strong>Alt</strong> + <strong>Shift</strong> + A = less than sign (<) - <br><strong>Alt</strong> + <strong>Shift</strong> + D = greater than sign (>)</blockquote> -</ul> -<ul> - <li>Additional mappings for Xperia (mini) pro:</li> - <blockquote><strong>SYM</strong> = opens/closes symbol input dialog - <br><strong>Alt</strong> + S = pipe symbol (|) - <br><strong>Alt</strong> + Z = backslash (\) - <br><strong>Shift</strong> + ' = tilde (~) - <br><strong>Shift</strong> + ? = grave accent (`) - <br><strong>Shift</strong> + . = caret (^) - <br><strong>Shift</strong> + , = greater than sign (>) - <br><strong>Shift</strong> + @ = less than sign (<) - <br><strong>Alt</strong> + <strong>Shift</strong> + U = opening square bracket ([) - <br><strong>Alt</strong> + <strong>Shift</strong> + I = closing square bracket (]) - <br><strong>Alt</strong> + <strong>Shift</strong> + O = opening curly bracket ({) - <br><strong>Alt</strong> + <strong>Shift</strong> + P = closing curly bracket ({)</blockquote> -</ul> - -</body> -</html>
--- a/assets/help/ScreenGestures.html Sun Aug 03 11:26:03 2014 -0700 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,28 +0,0 @@ -<html> -<head><meta http-equiv="content-type" content="text/html; charset=utf-8" /></head> -<body bgcolor="#000000" text="#FFFFFF" link="#00FFFF"> - -<h2>Screen Gestures</h2> - -<p>Gestures in ConnectBot allow a user to do several things for -which there's no keyboard equivalent. If the gestures seem -backward, then imagine that you're grabbing the text and moving it -with your finger.</p> - -<h2>Page Up / Page Down</h2> - -<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> - -<h2>Scroll back / Scroll forward</h2> - -<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> - -<h2>Switching hosts</h2> - -<p>Swiping your finger from one side of the screen to the other will -switch between currently connected hosts.</p> -</body> -</html>
--- a/assets/help/VirtualKeyboard.html Sun Aug 03 11:26:03 2014 -0700 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,65 +0,0 @@ -<html> -<head><meta http-equiv="content-type" content="text/html; charset=utf-8" /></head> -<body bgcolor="#000000" text="#FFFFFF" link="#00FFFF"> - -<h2>Virtual Keyboard</h2> - -<p>Since ConnectBot doesn't use any of the normal TextView -widgets, Android's IME structure isn'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>On-Screen symbols</h2> - <p>By touching the bottom line of your screen a pop-up list of - on-screen symbols will appear:</p> -<ul> - <li><strong>Ctrl</strong> - presses the CTRL key. Tap-and-hold - opens a CTRL+? letter dialog window.</li> - <li><strong>Esc</strong> - presses the ESC key. Tap-and-hold - opens the Function Keys dialog window.</li> - <li><strong>Sym</strong> - opens the Character Picker window. - Tap-and-hold opens the arrow keys navigation window. - <li><strong>Empty</strong> - allows to insert a single line of text. - <li><strong>Keyboard</strong> - shows the virtual keyboard. -</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 - "A" key on the soft keyboard.</li> - <li><strong>F3</strong> = Press trackball once then tap the - "3" key on the soft keyboard.</li> -</ul> - -</body> -</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/help/5250Keys.html.in Mon Aug 04 08:10:12 2014 -0700 @@ -0,0 +1,7 @@ +<h2>5250 Keys</h2> + +<ul> + <li><strong>ATTN</strong> = <strong>CTRL + A</strong></li> + <li><strong>SYSREQ</strong> = <strong>CTRL + S</strong></li> + <li><strong>RESET</strong> = <strong>CTRL + R</strong> or <strong>ESC</strong></li> +</ul>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/help/About.html.in Mon Aug 04 08:10:12 2014 -0700 @@ -0,0 +1,104 @@ +<h2>510ConnectBot</h2> + +<p>Copyright © 2014 Carl Byington +<carl@five-ten-sg.com></p> + +<p>This is an enhanced version of the popular open-source telnet and +secure shell (SSH) client ConnectBot. It now includes tn5250 emulation.</p> + +<p>It is licensed under +the <a href="http://www.gnu.org/licenses/gpl-3.0.txt">GPLv3 or later +license</a>.</p> + +<p>The complete source code for this application is available at +<a href="http://www.five-ten-sg.com/510Connectbot"></a>http://www.five-ten-sg.com/510Connectbot</p> + +<h2>Credits</h2> + +<p> +This software is based on VX Connectbot provided under the Apache +License, Version 2.0. Copyright © 2012 Martin Matuska +<a href="http://connectbot.vx.sk">http://connectbot.vx.sk</a> +</p> + +<p> +Based on Irssiconnectbot provided under the Apache License, Version +2.0. Copyright © 2013 Iiro Uusitalo and Ville Kerminen +<a href="https://github.com/irssiconnectbot/irssiconnectbot">https://github.com/irssiconnectbot/irssiconnectbot</a> +</p> + +<p> +Based on ConnectBot provided under the Apache License, Version +2.0. Copyright © 2007-2008 Kenny Root +<a href="http://the-b.org">http://the-b.org</a> and Jeffrey Sharkey <a href="http://jsharkey.org">http://jsharkey.org</a> +</p> + +<p> +Based on the Ganymed SSH2 client provided under a BSD-style +license. Copyright © 2005 - 2006 Swiss Federal Institute of +Technology (ETH Zurich), Department of Computer +Science <a href="http://www.inf.ethz.ch">http://www.inf.ethz.ch</a>, +Christian Plattner. Copyright © 2006 - 2013 Christian Plattner. +<a href="http://code.google.com/p/ganymed-ssh-2/">http://code.google.com/p/ganymed-ssh-2/</a> +The Java implementations of the AES, Blowfish and 3DES ciphers have been +taken (and slightly modified) from the cryptography package released by +"The Legion Of The Bouncy Castle". +Copyright © 2000 - 2004 The Legion Of The Bouncy Castle +<a href="http://www.bouncycastle.org">http://www.bouncycastle.org</a> +The following disclaimer applies: +</p> + +<p> +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. +</p> + +<p> +Based on JTA Telnet/SSH client provided under the GPLv2 license. +Copyright © 1996-2005 Matthias L. Jugel and Marcus +Meiner <a href="http://www.javassh.org">http://www.javassh.org</a> +</p> + +<p> +Based on TN5250J terminal emulator provided under the GPLv2 +license. Copyright © 2001 Kenneth J. Pouncey. +<a href="http://tn5250j.sourceforge.net"></a>http://tn5250j.sourceforge.net +</p> + +<p> +Includes the JSOCKS library, provided under the GNU LGPL +license. <a href="http://jsocks.sourceforge.net">http://jsocks.sourceforge.net</a> +</p> + +<p> +Includes JZlib provided under a BSD-style license. Copyright © +2000-2004 JCraft, Inc. +<a href="http://www.jcraft.com">http://www.jcraft.com</a> +</p> + +<p> +Includes the ssh-agent service developed by Roberto Tyley +<a href="https://github.com/rtyley">https://github.com/rtyley</a> +</p> + +<p> +SCP file transfer support is based on +<a href="https://github.com/staktrace/connectbot/commits/filetransfer">https://github.com/staktrace/connectbot/commits/filetransfer</a> +modifications by Kartikaya Gupta. +</p> + +<p> +Internal file selection dialog is based on +<a href="http://code.google.com/p/android-file-dialog">http://code.google.com/p/android-file-dialog</a> Android File +Dialog by Alexander Ponomarev, provided under a BSD-style +license. +</p>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/help/Hints.html.in Mon Aug 04 08:10:12 2014 -0700 @@ -0,0 +1,7 @@ +<h2>Helpful hints</h2> + +<p>When you have multiple sessions open, you can 'pan' between them by swiping your finger left-to-right or right-to-left over the screen.</p> + +<p>Long-press on your Android desktop to create direct shortcuts to frequently-used SSH hosts.</p> + +<p>Slide your finger up/down on the right-half of the terminal screen to look at the scrollback history. Slide up/down on the left-half to send the page up/down keys.</p>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/help/Makefile Mon Aug 04 08:10:12 2014 -0700 @@ -0,0 +1,11 @@ +a:=../assets/help +b:=../html + +all: + [ -d $(a) ] || mkdir -p $(a) + [ -d $(b) ] || mkdir -p $(b) + for i in *.html.in; do \ + f=$$(basename $$i .in); \ + cat header.android $$i footer >$(a)/$$f; \ + cat header.browser $$i footer >$(b)/$$f; \ + done
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/help/PhysicalKeyboard.html.in Mon Aug 04 08:10:12 2014 -0700 @@ -0,0 +1,104 @@ +<h2>Physical Keyboard</h2> + +<p>Here are some keyboard shortcuts available when a <strong>hardware +keyboard</strong> is present. If you'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> +<p><strong>Note:</strong> to use advanced Sony Ericsson Xperia (mini) pro key mappings you +have to activate the appropriate option in application settings.</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 < symbol. Note that pressing the + trackball again will send an <strong>escape</strong> key.<br><br> + Xperia (mini) pro: the <strong>Language</strong> key (above right arrow) maps to CTRL. + </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>.<br><br> + Xperia (mini) pro: pressing the <strong>Language</strong> key (above right arrow) + twice maps to ESC</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 alt key with the shift key and press numbers 1 + through 0 to send F1 through F10 respectively.<br><br> + Xperia (mini) pro: pressing the <strong>Language</strong> (above right arrow) key twice + and a number (with <strong>Alt</strong>) maps to F1 through F10 + </blockquote> +</ul> +<ul> + <li>Navigation keys</li> + <blockquote><strong>Alt</strong> + Up Arrow = Page Up + <br><strong>Alt</strong> + Down Arrow = Page Down + <br><strong>Alt</strong> + Left Arrow = Home + <br><strong>Alt</strong> + Right Arrow = End + <br><strong>Search key</strong> = URL scan</blockquote> +</ul> +<ul> + <li>Other keys</li> + <blockquote><strong>Alt</strong> + BackSpace = Insert</blockquote> +</ul> +<ul> + <li>Additional mappings for Asus Transformer Series Mobile Dock:</li> + <blockquote><strong>Back key</strong> = ESC</blockquote> +</ul> +<ul> + <li>Additional mappings for Samsung Captivate Glide (SGH-i927):</li> + <blockquote><strong>Microphone key</strong> = TAB + <br><strong>.com</strong> = ESC + <br><strong>Alt</strong> + <strong>Shift</strong> + O = opening square bracket ([) + <br><strong>Alt</strong> + <strong>Shift</strong> + P = closing square bracket (]) + <br><strong>Alt</strong> + <strong>Shift</strong> + A = less than sign (<) + <br><strong>Alt</strong> + <strong>Shift</strong> + D = greater than sign (>)</blockquote> +</ul> +<ul> + <li>Additional mappings for Xperia (mini) pro:</li> + <blockquote><strong>SYM</strong> = opens/closes symbol input dialog + <br><strong>Alt</strong> + S = pipe symbol (|) + <br><strong>Alt</strong> + Z = backslash (\) + <br><strong>Shift</strong> + ' = tilde (~) + <br><strong>Shift</strong> + ? = grave accent (`) + <br><strong>Shift</strong> + . = caret (^) + <br><strong>Shift</strong> + , = greater than sign (>) + <br><strong>Shift</strong> + @ = less than sign (<) + <br><strong>Alt</strong> + <strong>Shift</strong> + U = opening square bracket ([) + <br><strong>Alt</strong> + <strong>Shift</strong> + I = closing square bracket (]) + <br><strong>Alt</strong> + <strong>Shift</strong> + O = opening curly bracket ({) + <br><strong>Alt</strong> + <strong>Shift</strong> + P = closing curly bracket ({)</blockquote> +</ul>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/help/ScreenGestures.html.in Mon Aug 04 08:10:12 2014 -0700 @@ -0,0 +1,23 @@ +<h2>Screen Gestures</h2> + +<p>Gestures in ConnectBot allow a user to do several things for +which there's no keyboard equivalent. If the gestures seem +backward, then imagine that you're grabbing the text and moving it +with your finger.</p> + +<h2>Page Up / Page Down</h2> + +<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> + +<h2>Scroll back / Scroll forward</h2> + +<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> + +<h2>Switching hosts</h2> + +<p>Swiping your finger from one side of the screen to the other will +switch between currently connected hosts.</p> +
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/help/VirtualKeyboard.html.in Mon Aug 04 08:10:12 2014 -0700 @@ -0,0 +1,58 @@ +<h2>Virtual Keyboard</h2> + +<p>Since ConnectBot doesn't use any of the normal TextView +widgets, Android's IME structure isn'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>On-Screen symbols</h2> + <p>By touching the bottom line of your screen a pop-up list of + on-screen symbols will appear:</p> +<ul> + <li><strong>Ctrl</strong> - presses the CTRL key. Tap-and-hold + opens a CTRL+? letter dialog window.</li> + <li><strong>Esc</strong> - presses the ESC key. Tap-and-hold + opens the Function Keys dialog window.</li> + <li><strong>Sym</strong> - opens the Character Picker window. + Tap-and-hold opens the arrow keys navigation window. + <li><strong>Empty</strong> - allows to insert a single line of text. + <li><strong>Keyboard</strong> - shows the virtual keyboard. +</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 + "A" key on the soft keyboard.</li> + <li><strong>F3</strong> = Press trackball once then tap the + "3" key on the soft keyboard.</li> +</ul>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/help/footer Mon Aug 04 08:10:12 2014 -0700 @@ -0,0 +1,2 @@ + </body> +</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/help/header.android Mon Aug 04 08:10:12 2014 -0700 @@ -0,0 +1,93 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> + <head> + <title>510 ConnectBot</title> + <style type="text/css"> + <!-- + body { + background : black; + color : white; + link : aqua; + } + + .wrap { + margin : 1em; + min-width : 20em; + max-width : 35em; + } + + .logo { + float : left; + width : 10em; + margin : 0 0 1em 0; + } + + .address { + float : right; + width : 10em; + } + + .right { + margin : 0 0 1em 0; + text-align : right; + } + + .content { + clear : both; + } + + hr { + height: .2em; + width : 80%; + } + + .code { + font-family : Courier, monospace; + line-height : 1.2; + padding : 0; + border-width : 0; + margin : 0 0 0 1.5em; + vertical-align : middle; + background-color : rgb(230,230,230); + } + + .table-num { + padding : 0 1em; + text-align : right; + } + + .nice-list { + padding-bottom: 1em; + } + + .top-nice-list { + padding-top: 0em; + border-top-width: 0em; + margin-top: -1em; + } + + .centered { + text-align : center; + display : block; + margin-left : auto; + margin-right : auto; + } + + .blog-column { + min-width : 15em; + max-width : 35em; + } + + .emphasis { + font-weight : bold; + } + + .red { + color: red; + } + --> + </style> + </head> + <body bgcolor="#000000" text="#FFFFFF" link="#00FFFF">
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/help/header.browser Mon Aug 04 08:10:12 2014 -0700 @@ -0,0 +1,93 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> + <head> + <title>510 ConnectBot</title> + <style type="text/css"> + <!-- + body { + background : white; + color : black; + link : blue; + } + + .wrap { + margin : 1em; + min-width : 20em; + max-width : 35em; + } + + .logo { + float : left; + width : 10em; + margin : 0 0 1em 0; + } + + .address { + float : right; + width : 10em; + } + + .right { + margin : 0 0 1em 0; + text-align : right; + } + + .content { + clear : both; + } + + hr { + height: .2em; + width : 80%; + } + + .code { + font-family : Courier, monospace; + line-height : 1.2; + padding : 0; + border-width : 0; + margin : 0 0 0 1.5em; + vertical-align : middle; + background-color : rgb(230,230,230); + } + + .table-num { + padding : 0 1em; + text-align : right; + } + + .nice-list { + padding-bottom: 1em; + } + + .top-nice-list { + padding-top: 0em; + border-top-width: 0em; + margin-top: -1em; + } + + .centered { + text-align : center; + display : block; + margin-left : auto; + margin-right : auto; + } + + .blog-column { + min-width : 15em; + max-width : 35em; + } + + .emphasis { + font-weight : bold; + } + + .red { + color: red; + } + --> + </style> + </head> + <body bgcolor="#FFFFFF" text="#000000" link="#0000FF">
--- a/xml/Makefile Sun Aug 03 11:26:03 2014 -0700 +++ b/xml/Makefile Mon Aug 04 08:10:12 2014 -0700 @@ -1,12 +1,14 @@ ver:=$(shell grep versionName ../AndroidManifest.xml | cut -d'"' -f2) pkg:=510Connectbot +t:=../html all: sed -e 's/@PACKAGE@/$(pkg)/g' -e 's/@VERSION@/$(ver)/g' <510connectbot.in >510connectbot cat header.xml 510connectbot >510connectbot.xml cat header.sgml 510connectbot >510connectbot.sgml - rm -f ../html/*html - rm -f ../html/*pdf - xmlto -o ../html xhtml 510connectbot.xml - xmlto -o ../html pdf 510connectbot.xml + [ -d $(t) ] || mkdir $(t) + rm -f $(t)/*html + rm -f $(t)/*pdf + xmlto -o $(t) xhtml 510connectbot.xml + xmlto -o $(t) pdf 510connectbot.xml rm -f 510connectbot.xml 510connectbot.sgml