summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/README.xvt171
1 files changed, 171 insertions, 0 deletions
diff --git a/doc/README.xvt b/doc/README.xvt
new file mode 100644
index 0000000..a6537d7
--- /dev/null
+++ b/doc/README.xvt
@@ -0,0 +1,171 @@
+-------------------------------------------------------------------------
+Rxvt is a heavily modified version of xvt, many modifications were made by
+Rob Nation <nation@rocket.sanders.lockheed.com> to make it a little more
+compact and to add a few simple features.
+
+This is the README that came with xvt-2.0. It is included mainly to give
+the original author credit for his work.
+
+ README file for xvt 2.0
+ -----------------------
+
+Xvt is an X terminal-emulator that is designed to be more or less
+compatible with xterm while using much less swap space. It is mainly
+intended for use at sites which use large numbers of X terminals but
+may also be useful on single workstations that are short of memory. On
+a SPARCstation running SunOS4, an initially invoked xvt uses about 1/3
+megabyte of swap while xterm uses about 1.3 megabytes (obtained by
+running pstat rather than ps which seems to give unreliable size
+figures on SPARCs). The main way that xvt achieves its small size is
+by avoiding the use of the X toolkit.
+
+The current version of xvt is our default X terminal emulator and has
+been used for eight months by students, computing support staff and
+service users and so is fairly well tested.
+
+Supported architectures
+-----------------------
+
+One of the major changes between xvt-1.0 and 2.0 is that xvt-2.0 is
+much more portable. The released version should build and run on all
+the architectures I have access to, namely: SunOS4, SunOS5, HP-UX 8.0,
+HP-UX 9.0, DEC OSF/1 V1.2 and ULTRIX 3.?. In addition, the teletype
+initialisation code has been completely restructured to make it more
+portable. Almost all the system dependent code is in the single source
+file, ttyinit.c.
+
+Xterm features not supported
+----------------------------
+
+ - Tektronix 4014 emulation
+
+ - Session logging
+
+ - Pop-up menus. The only one of xterm's popup menu commands that is
+ provided in xvt is displaying and hiding of the scrollbar and this
+ is done simply by pressing any mouse key in the window with the
+ CONTROL key held down.
+
+ - Toolkit style configurability. In particular, xvt does not allow
+ the user to remap the mouse or keyboard keys.
+
+Major xterm features that are supported
+---------------------------------------
+
+ - VT100 emulation. Most of the main escape sequences are supported -
+ certainly all those used by the standard screen based UNIX
+ applications.
+
+ - Lines that scroll off the top of the window are saved can be
+ scrolled back with a scrollbar.
+
+ - Text selection and insertion including double and triple click for
+ words and lines.
+
+Differences between xvt2.0 and xvt1.0
+-------------------------------------
+
+ - xvt2.0 is eight bit clean and will generate and display eight bit
+ characters. The META key can be used to generate characters with
+ the eighth bit set (in eight bit mode) or prefix by escape (in seven
+ bit mode).
+
+ - The teletype setup code has been rewritten to make it much more
+ portable. See the comments at the head of ttyinit.c.
+
+ - Exposure handling has been made much more efficient so that xvt should
+ now be useable with window managers that provide opaque window movement.
+
+ - VT100 graphics characters are supported for fonts that include them.
+
+ - There is now a -ls option to enable the use of a login shell.
+
+ - Colored text cursors are now supported.
+
+ - There is support for the -C (console window) option but only on
+ SunOS 4.
+
+ - Bold characters are generated by overstriking if no bold font is
+ specified.
+
+ - Function keys generate escape sequences as in xterm.
+
+ - A number of bugs have been fixed:
+
+ - Setting the title without a terminating ^G no longer locks up.
+
+ - Paste followed by a keystroke will always insert in the correct
+ order.
+
+ - Pasting an uninitialised string will not cause a crash.
+
+Other differences between xvt and xterm
+---------------------------------------
+
+ - Xvt has a couple of additional enquiry escape sequences:
+
+ ESC[7n - causes xvt to respond with the name of its X display in a
+ form that can be used to initialise the DISPLAY environment
+ variable. If this is done in a user's .cshrc file it
+ provides a way to automatically update DISPLAY after an
+ rlogin. Something like the following should work if the
+ initial ^[ in the echo command is an ESC character:
+
+ if(!($?DISPLAY)) then
+ if($?term) then
+ if($term =~ xterm*) then
+ stty -echo >/dev/tty
+ echo -n '^[[7n' >/dev/tty
+ setenv DISPLAY `line </dev/tty`
+ stty echo >/dev/tty
+ endif
+ endif
+ endif
+
+ ESC[8n - causes xvt to respond with a hex encoded copy of the server's
+ magic cookie which can be used to update a user's .Xauthority
+ file. We have a program to do this which could be made available
+ if anyone is interested.
+
+Known Bugs
+----------
+
+ - xvt does not know about transferring selections in installments and so
+ making large selections or trying to insert large selections will
+ fail. The maximum selection size supported is server dependent but
+ seems to be a little under 64k on all our servers.
+
+ - xvt does not look in all the approved places for its X resources.
+ It does, however, work correctly with resources that have been
+ loaded into the server using xrdb
+
+Building and installing xvt
+---------------------------
+
+Xvt does not use imake but does come with a simple Makefile
+configuration scheme that provides some help with getting the Makefile
+right. If you want to build xvt on one of the supported architectures
+then you should uncomment the appropriate definition at the start of
+the Makefile and then run `make config', which will modify other
+Makefile comments to bring them into line with the chosen
+architecture.
+
+To install xvt, you should edit the MANDIR and BIN pathnames in the
+Makefile and then type 'make install' as root. When installed for
+general use, xvt needs to belong to root and have the setuid flag set
+so that it can make entries in the /etc/utmp file.
+
+Thanks to all the people who have mailed bug reports, patches and
+local improvements. Some requested additions have gone into V2.0,
+others perhaps should have, but were left out due to lack of time.
+
+Please send bug reports and WIBNIs to:
+
+John Bovey
+Computing Laboratory
+University of Kent at Canterbury
+Canterbury
+Kent
+UK
+
+email: jdb@ukc.ac.uk