eterm/src
Michael Jennings 6f6ebe924f Sat May 4 11:12:19 2002 Michael Jennings (mej)
Added a --enable-escreen option for those who wish to try it out.
Also fixed the compile with Escreen and profiling are both enabled,
and disabled Escreen debugging.


SVN revision: 6203
2002-05-04 15:12:59 +00:00
..
.cvsignore Initial import of Eterm 0.8.9 sources 1999-08-17 23:01:18 +00:00
.indent.pro Sun Apr 7 21:15:09 2002 Michael Jennings (mej) 2002-04-08 02:16:09 +00:00
Makefile.am Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
README.Escreen Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
actions.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
actions.h Sun Feb 3 15:51:38 2002 Michael Jennings (mej) 2002-02-03 20:53:07 +00:00
buttons.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
buttons.h Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
command.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
command.h Mon Jul 23 17:59:18 2001 Michael Jennings (mej) 2001-07-24 01:00:37 +00:00
defaultfont.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
defaultfont.h Thu Feb 21 19:06:18 2002 Michael Jennings (mej) 2002-02-22 00:09:23 +00:00
draw.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
draw.h Sun Feb 3 15:51:38 2002 Michael Jennings (mej) 2002-02-03 20:53:07 +00:00
e.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
e.h Sun Feb 3 15:51:38 2002 Michael Jennings (mej) 2002-02-03 20:53:07 +00:00
encoding.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
encoding.h Sun Feb 3 15:51:38 2002 Michael Jennings (mej) 2002-02-03 20:53:07 +00:00
eterm_debug.h Sun Feb 3 15:51:38 2002 Michael Jennings (mej) 2002-02-03 20:53:07 +00:00
eterm_utmp.h Fri Apr 26 14:28:08 2002 Michael Jennings (mej) 2002-04-26 18:30:48 +00:00
events.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
events.h Sun Feb 3 15:51:38 2002 Michael Jennings (mej) 2002-02-03 20:53:07 +00:00
feature.h Fri Apr 19 15:35:11 2002 Michael Jennings (mej) 2002-04-19 19:38:54 +00:00
font.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
font.h Wed Apr 24 22:27:51 2002 Michael Jennings (mej) 2002-04-25 02:28:57 +00:00
gdb.scr Thu Aug 31 23:02:10 PDT 2000 Michael Jennings <mej@eterm.org> 2000-09-01 05:46:04 +00:00
grkelot.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
grkelot.h Initial import of Eterm 0.8.9 sources 1999-08-17 23:01:18 +00:00
icon.h Tue Apr 18 23:55:42 PDT 2000 Michael Jennings <mej@eterm.org> 2000-04-19 06:46:03 +00:00
libscream.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
main.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
menus.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
menus.h Sun Feb 3 15:51:38 2002 Michael Jennings (mej) 2002-02-03 20:53:07 +00:00
misc.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
misc.h Sun Feb 3 15:51:38 2002 Michael Jennings (mej) 2002-02-03 20:53:07 +00:00
mmx_cmod.S Sun Feb 3 15:51:38 2002 Michael Jennings (mej) 2002-02-03 20:53:07 +00:00
netdisp.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
options.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
options.h Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
pixmap.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
pixmap.h Sun Feb 3 15:51:38 2002 Michael Jennings (mej) 2002-02-03 20:53:07 +00:00
profile.h Sun Feb 3 15:51:38 2002 Michael Jennings (mej) 2002-02-03 20:53:07 +00:00
scream.h Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
screamcfg.h Sat May 4 11:12:19 2002 Michael Jennings (mej) 2002-05-04 15:12:59 +00:00
screen.c Sat May 4 11:12:19 2002 Michael Jennings (mej) 2002-05-04 15:12:59 +00:00
screen.h Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
script.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
script.h Mon Apr 29 10:48:33 2002 Michael Jennings (mej) 2002-04-29 14:50:43 +00:00
scrollbar.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
scrollbar.h Sun Feb 3 15:51:38 2002 Michael Jennings (mej) 2002-02-03 20:53:07 +00:00
startup.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
startup.h Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
system.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
system.h Sun Feb 3 15:51:38 2002 Michael Jennings (mej) 2002-02-03 20:53:07 +00:00
term.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
term.h Mon Apr 8 15:29:27 2002 Michael Jennings (mej) 2002-04-08 20:31:10 +00:00
timer.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
timer.h Sun Feb 3 15:51:38 2002 Michael Jennings (mej) 2002-02-03 20:53:07 +00:00
utmp.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
windows.c Sat May 4 10:23:38 2002 Michael Jennings (mej) 2002-05-04 14:25:30 +00:00
windows.h Sun Feb 3 15:51:38 2002 Michael Jennings (mej) 2002-02-03 20:53:07 +00:00

README.Escreen

ESCREEN

1 - What is it?

Eterm now offers you to compile in experimental support for the
"screen" program.  "screen" is a terminal multiplexer (one window,
several shells).  Yes, it's like konsole or multi-gnome-terminal,
only that your shells won't die just because X or the Window Manager
do.  Oh, and you can pick up your home session from work, and vice
versa.  And several people can connect to the same session at once,
and...

You get this picture -- if you're a power-user, this is for you.

Also, if you're not a power-user, this is *not* for you.  It's alpha.
It's experimental.  Reported bugs will get fixed where possible, but
there can be no newbie support at this time.



2 - How do I get it?

You already have all you need.  Now, compile with ESCREEN defined in
the DEFS in src/Makefile.

  If you don't know how to do that, sorry, but you're not Escreen's
  intended audience at this point; please hold on.

Oh, and you also need the screen program.  In our tests, we used
$ screen -version
Screen version 3.09.11 (FAU) 14-Feb-02



3 - How do I start it?

If you call it an Eterm, it will behave like one.  Same for an Escreen.
(ln -s Eterm Escreen; ./Escreen).

Additionally, when called with a command-line (-e "/some/program"), the
suite will *always* behave like an Eterm, even if invoked as Escreen.
Likewise, when called with an URL (-U "screen://user@some.host.gov/"),
it will behave like an Escreen, even if invoked under another name.



4 - What should I expect from it?  (subject to change)

An Eterm should open with a screen (without a status-line) running
inside of it.  There should be a button-bar in the Eterm enumerating
the multiplexed terminal (you usually start with one).  If you normally
don't use a button-bar, Escreen will create one for you.  Otherwise, it
will add buttons to your existing bar.



5 - What should I expect in the future?  (TODO)

* Limited support for scrolling.  screen doesn't give us all the info
  we'd need to make this really sexy.  There will likely be limited
  support for screen (we need to keep this, it will be what we'll find
  on remote machine), and possibly support for enhanced screen-clones
  (like the perchance forthcoming "scream").

* Support for ".screenrc".  This was temporarily disabled to aid in
  debugging and will soon return in conjunction with

* Escreen accepting non-default key setups and

* menus for "screen"-functions so those unfamiliar with the program
  will not need to learn a dozen arcance key-sequences (or even get
  used to ^A meaning something new).



9 - FAQ

Q  I don't see any buttons!

A  Debian-users reported this before, and it is presumed to be a problem
   with the terminfo-data.  Call up Eterm (or xterm, or whatnot).  *Then*
   call up "screen" from inside that terminal.  Is the last line inverted?
   If it isn'T, something is seriously weird with your setup, and it's not
   a problem in Escreen.  Sorry.  : (

Q  ^A does funny things!

A  Well, yes.  ^A talks to the screen program.  You will be able to move
   that to a key of your choice with the next release.

Q  I'd like for the button labels to be in a different colour.

A  At this time, the labels follow the general (text) colours.
   You will be able to define colours for (foreground|background|active|bell)
   windows' labels in later releases.

Q  Escreen opens, then closes again.

A  Escreen cannot run "screen".  If you do have "screen", and it is in
   the search path, screen apparently terminates right away.  Normally
   this means that your screen-sessions are messed up; "screen -ls" will
   give you a list of them; "screen -wipe" will do the cleaning up.
   NOTE: If this happens with a remote session, the remote end might just
   find our terminal type confusing.  The "--term-name" option with some-
   thing vanilla (--term-name vt100) should remedy this.

Q "screen" support rocks!  Can we have it in konsole/multi-gnome-terminal?

A  I will not attempt anything like that before I am happy with Escreen.
   The code, however, is GPL'd, and its use is documented by example of
   Eterm.  If you can work with that, do.

Q  Who's responsible for this?

A  Escreen is an Eterm extension conceived and written by Azundris.
   Do not complain to KainX (who courteously added the patch for the
   enjoyment of the hardy) if you break your Eterm by compiling this
   in (or by trying to use the alpha-functionality).  By using this,
   you agree that anything happening while or because of using it is
   your fault, and your fault only.

-- Azundris 2002/05/03  <escreen@azundris.com>  http://www.azundris.com/