Support multiple sessions per terminal activity.

This patch does the following:

* Replace the EmulatorView widget in the activity layout with a
  TermViewFlipper, which is a ViewFlipper with a couple of added
  conveniences for dealing with EmulatorViews (e.g. pausing/resuming
  them when changing the view).
* Add an ArrayList in the service to hold TermSessions, and make the
  activity bind to the service so that it can retrieve the list.  This isn't
  strictly necessary for multisession support, but allows us to decouple
  the activity from the sessions, which will (in the future) allow us to
  restart or even close the activity without losing running sessions.
* Now that EmulatorViews aren't being created automatically when the
  layout is inflated, but are instead created by hand, move a bunch of
  initialization stuff to the EmulatorView constructor.
* Make the input reader threads for each session exit on EOF.  These
  threads hold a reference to their TermSession objects, which would
  leak otherwise.

For now, one EmulatorView and TermSession are created as soon as the
activity binds to the service, if none exist; no UI to create additional
sessions is included.

Don't accept input from process after TranscriptScreen is finished.

This prevents a bunch of noise in the logs.

Throw away TranscriptScreen backing store on session finish

Android's InputMethodManager seems to hold a reference to a finished
activity object for a while after the activity is destroyed.  This
keeps everything the activity holds a reference to in memory, which in
our case includes a fairly significant chunk of memory: the backing
store to the TranscriptScreen.  Throw this away when it's not needed, to
reduce the memory impact of this behavior.

Use TermSession in activity and view instead of old terminal-handling code

This completes the process of isolating the code for each terminal
session, which should considerably simplify the task of adding support
for multiple sessions.

Add TermSession class to represent a terminal session

At the moment, the assumption that each terminal activity contains only
one EmulatorView and hosts only one terminal session is fairly deeply
embedded into the code.  To help break this assumption, we introduce a
new TermSession class, which holds the TerminalEmulator and
TranscriptScreen for a session, and handles the launching and watching
of the process and the setup of the I/O streams.

Modify the activity and view to use the new TermSettings class.

For multisession support, we eventually want to keep the terminal
sessions in the service instead of tying them to the activity.  This
implies that we have to stop holding SharedPreferences objects in all of
the classes tied to the session.  To this end, introduce a new
TermSettings class, which is responsible for reading SharedPreferences
and holding the current value of config settings.

This patch isn't really necessary, but it makes life easier for me.  For
local builds, I change the package name to
net.steven676.android.terminal, which allows co-installation with the
Market version; however, if the debug constants stay in the Term class,
I have to change every file using them to either belong to the new
package, or else import net.steven676.android.terminal.Term.

The fact that Term.java contains substantially all of the classes of the
application clashes with Java's model of one class per file, and is
inconvenient when refactoring the code to allow for multiple terminal
sessions in the activity.  This patch splits out all of the classes into
separate files, and groups related classes into packages; no actual
changes to the code are made.

Ignore local.properties

contains machine-specific information, not useful to save in repo.

Shrink market icon to match "safe" bounds

See http://www.google.com/support/androidmarket/developer/bin/answer.py?answer=1078870

Improve market icon.

Shinier, and more like a terminal.

Updated translations

Thanks to fireb33@gmail.com

Increment version number.

Update in-app documentation for special keys

Contributed by Steven Luo steven+android@steven676.net

Add F1-F12 and Ins/Del/Home/End keys

Contributed by Steven Luo steven+android@steven676.net who writes:

The mapping is as follows:

Fn-[1-9]: F1-F9
Fn-0: F10
Ctrl-9: F11
Ctrl-0: F12
Fn-I: Ins
Fn-X: Del
Fn-H: Home
Fn-F: End

It should be noted that a real VT100 does not have Home/End keys, and as
such, the terminfo entry for TERM=vt100 doesn't contain escape codes for
Home and End.  This bothers some applications, but not others.  The
codes generated match those sent by the Linux console (TERM=linux),
which appears to work fine as a TERM setting since the emulation fixes
in 1.0.30.  xterm sends different escape codes, though; I left the
escape codes at their present values because TERM=xterm causes problems
with some applications.

Addresses GitHub issue #9.
---
I'm unhappy with the reintroduction of different behaviors for the Ctrl
key, but I couldn't think of another choice that's guaranteed to make
sense on any soft keyboard layout.  (Fn-J/K and Fn-(/) are the two other
possibilities that occurred to me.)  Feel free to change.

Fix behavior of Ctrl-[0-9]

Patch contributed by Steven Luo. steven+android@steven676.net

Steven writes:

In xterm on my Debian system, the Ctrl-[0-9] combinations appear to map
to the following:

Ctrl-2: ^@ (NUL)
Ctrl-3: ^[ (ESC)
Ctrl-4: ^\
Ctrl-5: ^]
Ctrl-6: ^^
Ctrl-7: ^_
Ctrl-8: \177 (DEL)

Ctrl-1, Ctrl-9, and Ctrl-0 appear to send 1, 9, and 0 respectively.

I have no idea whether anyone actually seriously uses these, but make
these key combinations behave in that manner, and remove the bogus
Ctrl-[0-9] and superfluous Fn-[234] combos.

Make Ctrl/Fn-[A-Z] work with uppercase as well as lowercase letters

Patch courtesy Steven Luo steven+android@steven676.net

Steven says:
For Ctrl-[A-Z], this matches the behavior of xterm running on my Debian
box; for Fn-[A-Z], there are no possible compatibility issues and it
seems like the most natural thing to do.

Add link to Downloads page to README file.

Enable an initial command string to be passed as part of the intent.

Thanks to Christoph Schmidt-Hieber, M.D., c.schmidt-hieber@ucl.ac.uk
for the idea and the patch.

Update Italian localization

Thanks to fireb33@gmail.com

Increment version number.

Implement a "None" setting for control and function keys.

Thanks to Eli Grey <me@eligrey.com> for the idea.

Also made the "Special keys" dialog text localizable.

Rename the rt tool to pushAndRun

This tool is used to build and test the terminal emulator.

Allow application to be installed on the SD Card.

Fix insert and delete line code.

Thanks to Sam Jacobson <sam.jacobson@snitchinc.com> for the
bug report and fix!

Implement missing SGR escape codes

Thanks to Sam Jacobson <sam.jacobson@snitchinc.com> for the bug report!

Escape single quote character so string resource compiles.

Merge pull request #20 from cpasmoi/master

missing translations

missing translations

missing translations

Increment version number.

Use a global reference to hold onto a class object between JNI calls.

This bug was detected by using CheckJNI

(setprop dalvik.vm.checkjni true; stop; start).

Update local properties for building on a new machine.

(Maybe I shouldn't check this file in at all.)

Increment version number.

Change shared library name (again) to make sure our copy takes precedence on CyanogenMod

Commit 28d47b8... ("Fix java.lang.UnsatisfiedLinkError error.") changed
the name of the shared library from libandroidterm to libandroidterm2,
to avoid a potential library conflict with API/ABI incompatible versions
being shipped in some custom firmwares.  Unfortunately, CyanogenMod also
uses the name libandroidterm2:

https://github.com/CyanogenMod/android_packages_apps_AndroidTerm/commit/7d0de89f0ed5231a7d7eb3ca7917accb83c8eaee

Change the name again, this time to something that should hopefully be
unique, which should fix the problems that CyanogenMod users have been
reporting in the Android Market comments.  (A big scary warning to
firmware distributors that the shared library ABI must not be modified
without consulting upstream might be appropriate somewhere ...)

Signed-off-by: Jack Palevich <jackpal@google.com>

Bump version number.

Fix java.lang.UnsatisfiedLinkError error.

Change shared library name from libandroidterm to libandroidterm2

My theory is that this bug is happening on systems that have
system versions of the libandroidterm shared library.

Version 1.0.26 of Android Terminal Emulator added a new API,
hangupProcessGroup, to the libandroidterm library.

I think on devices that have libandroidterm in their system library,
that version takes precedence over the version in the application,
and so the hangupProcessGroup API is not found.

By changing the name of the libandroidterm library to libandroidterm2
we should avoid loading the system version of the
libandroidterm library.

Housekeeping odds-and-ends.

Make sure the release build is a clean build.
Regenerate build.xml
Add update.sh script for regenerating build.xml

Rename buld tool, and make it build the JNI code as well.

Bump version number.

Add commitCorrection() to our InputConnection

Required in order to compile under API level 10.

Add setComposingRegion() and getSelectedText() to our InputConnection

The definition of the InputConnection interface for SDK version >= 9
includes new functions setComposingRegion() and getSelectedText().  If
we don't include them in our implementation, the build fails with

   [javac] /home/steven/devel/android-terminal-emulator/src/jackpal/androidterm/Term.java:2955: <anonymous jackpal.androidterm.EmulatorView$4> is not abstract and does not override abstract method setComposingRegion(int,int) in android.view.inputmethod.InputConnection

(at least when building with SDK 10).

Make the Terminal activity singleTask instead of singleInstance

With the Terminal activity's launchMode set to singleInstance, the
Preferences activity starts a new task, which can lead to some very
strange back stack behavior.  Set launchMode to singleTask instead,
which will allow the Preferences activity into the same task.

Add menu options to take WakeLock and WifiLock

It can be very useful to prevent the device from sleeping or from
turning off the wifi radio -- but in a general terminal application it's
difficult to guess when this is wanted.  Consider the following:

(1) Nothing is happening.  We don't want to hold either a WakeLock or
WifiLock.
(2) The user is logged into a remote system via SSH on wifi.  We don't
need to hold a WakeLock, but should take a WifiLock to prevent the SSH
session from being disconnected.
(3) The user is doing some long-running computation (locally on the
device) in the shell.  We should take a WakeLock, but not a WifiLock.
(4) The user is doing apt-get dist-upgrade in her Debian chroot on the
device.  We should hold both a WakeLock and a WifiLock.

Therefore, assume the user knows best, and add menu options to take/drop
a WakeLock and a WifiLock.  Note that this requires adding WAKE_LOCK to
the set of permissions we use.

Add a service to prevent Android from killing our process

By default, an Android process is liable to be killed whenever it's
not in the foreground.  When this happens to us, it leaves the user
unable to resume her terminal session, which is still running.

By starting a service in our process (even one which, like this one,
does nothing at all) and marking it as a foreground service, we prevent
the system from killing our process except in out-of-memory situations.

Add an Fn key for easier access to extra keys

Instead of overloading the Ctrl key to provide arrow keys and send some
control characters, add a new "Fn" key (defaulting to Volume Up) to
provide these functions.  By splitting Ctrl and Fn, we can reach these
functions via the more easily-accessible letters, and also provide
access to more useful keys (such as PageUp/Down and Tab).

The mapping is this:
Fn-W/A/S/D: Up/Left/Down/Right
Fn-P/N: PageUp/PageDown
Fn-T: Tab
Fn-L: |
Fn-U: _
Fn-E: Ctrl-[ (Esc)
Fn-.: Ctrl-\
Fn-2: Ctrl-_
Fn-3: Ctrl-^
Fn-4: Ctrl-]

Kill the started process group in onDestroy

As it stands now, if the user presses the Back button without closing
her shell, it will keep running unattached to any tty.  Over time, this
leads to a buildup of shells, each inaccessible to the user.

Fix this by doing what xterm and other terminals do -- send SIGHUP to
the process group of the started process when quitting.

Remove unused variable in native implementation of Exec.close()

Turkish localization

Provided by Doğukan Korkmaztürk <d.korkmazturk@gmail.com>

Declare SDK target 10 (Gingerbread) rather than 11 (Honeycomb)

Otherwise the Options menu key doesn't appear on Honeycomb devices.

Declare that we don't require a touchscreen.

Add support for Android 1.5

+ set minSdkVersion to 3, so we run on Android 1.5
+ set targetSdkVersion to 11, so we run without compatability hacks.
   - otherwise the terminal emulator screen size calculation is
     incorrect and scrolling doesn't work on Android 2.3 devices.
+ add a res/drawable/app_terminal.png file, so that we get a
  custom launcher icon on Android 1.5 devices.

+ bump version name to 1.0.22.

+ add files to support building from command line using "ant".

Mark this module optional.

Add Android.mk file

To help people trying to incorporate AndroidTerm in their own custom
ROMs.

(This hasn't been tested, but it might work.)

Add '|' and arrow keys to "Special Chars"

Add 'Camera' button as a possible Control key

Make 'Volume Down' the default control key.

Ignore a png file that's a documentation build artifact.

Add a white background layer.

We don't require a touch screen, even though we use the feature.

Bump version number.

Handle composing text.

Translation strings courtesy CyanogenMod:

   https://github.com/CyanogenMod/android_packages_apps_AndroidTerm

Modify text selection algorithm to work better:

+ Use drag to select rather than two taps.
+ Text selection is now a spring-loaded mode: It only lasts for
  one drag session.
+ Add a verical offset so you can see what you're selecting.

Fix style of text selection patch.

Merge branch 'master' of https://github.com/pelya/Android-Terminal-Emulator into pelya-master

Update docs for current build environment.

Added an option for selecting part of the text on the screen with two screen touches.

Bump version number.

Add support for full PC keyboards.

Tested with a Logitech Bluetooth keyboard.

Adobe Photoshop file for high-resolution icon for Android Market.

Avoid potential memory leak in String8::set

(Not an actual memory leak because the current clients of String8
never call set more than once for the same object. But you never
know who might use String8 in the future.)

Bump version number.

(I think this change was made a long time ago, just forgot to publish it.)

Support swype delete key long press

Bump version number.

IME arrow key support

Moved updates to a new page.

Improve formating.

Give proper extension for markdown.

Edit markup.

Support Swype IME backspace key.

Thanks to Julian Brost (who fixed the same bug in the connectbot project),
and thanks to Todd Musall for spotting the bug fix in the connectbot
tracker, and tried it out in Android Term.

In general we now support any IME trying to delete text to the left of
the cursor by calling InputConnector.deleteSurroundingText(). We generate
one "del" key event for each character of text that is to be deleted.

We don't support deleting text to the right of the cursor. If this
becomes an issue we can experiment with forward-cursor followed by del.

Import sources from code.google.com/p/androidterm

imported readme

first commit