
    README.Linux				    W - An Editor

    (last updated: 10.09.96)

    This is the W distribution for GNU/Linux.

    A couple of folks are using W now for several years, so I think
    it is a quite stable version. I'm using the GNU/Linux version now for some
    years and it is as stable as my OS/2 version. The X-Version now
    works fine. SGML syntax highlighting is implemented.

    - Console mode may be selected by option "-C".
    - X-Windows mode may be selected by option "-X".
    - "we" defaults to console-mode.
    - "wx" defaults to X-windows-mode.

    Note: The original name of the OS/2 version is "W", but it will be
    installed as "we" and "wx" under GNU/Linux. Tested on GNU/Linux version 1.2.13
    and 2.0.x.

    INSTALL
    =======
    - Edit w/src/Makefile if your install directory is not /usr/local/{bin,lib}
    - Enter:

	make

    - su and enter:

	make install

    - Non german users should edit the profile /usr/local/lib/w-edit/w.pro
      to select the US-keyboard.

    - Now you are ready, You my consider to create a private
      profile in your home diretory with the name ".w-profile"; this one
      will be included by W's main profile.
      To execute W on a tty:	  "we"
      To execute W on a X-Server: "wx"

    Have fun.


    Comments on the X windows version
    --------------------------------
    - W uses its own keyboard mapping, which defaults to the German
      GNU/Linux Version of XFree and may be overridden in the profile.
    - I use these entries in my ~/.Xdefaults on a 1152x910 screen:
       "w.font: -adobe-courier-medium-r-normal--18-*-*-*-m-*-iso8859-1"
       "w.geometry:     880x721+20+20"
     - If your X-Server doesn't show the text-cursor, try this
       resource entry:
       "w.toggleCaret: True"


    Comments on the console version:
    --------------------------------
    W makes extensive use of redefining keys, so I decided to
    to build this by switching the keyboard into raw mode to get the
    actual scan code (or is there another way?).
    - If you have the VCS(4) devices installed and rw permission
      to the current one, "W" will try to use this device.
      If this fails, "W" will use ANSI sequences to do the output.
    - You must have read/write access to your console device
      ("/dev/tty[1-9]")
    - ALT-CTRL-DEL will not power down the system, but terminate
      "W" by sending a SIGQUIT.
    - You must use ALT-CTRL-F1 .. F12 to switch between virtual
      terminal sessions (like in X-Windows)
    - I hacked a new function into my kernel, so I can set the cursor form
      (just a bad kludge, it dosn't save the old form etc.)
      "W" is able to detect this feature (it uses ESC#c and ESC#C).
      [How can I reset the blinking of the background?]


    Special Features:
    -----------------
    - "W" can be remote controlled:
	Create a file: "/tmp/w-edit.<pid>" with commands
	(like a profile) and send SIGUSR1 to the running "W".
	After this file is processed, "W" deletes the file.


    Bugs:
    -----
    of course -- report or try to fix them yourself.
    I use "W" as a kind of test-bench for everything (see command "tree")

    - No job control and such stuff
    - Should use terminfo and not hardcoded ANSI sequences.
    - The reference manual is in german. That's not a bug: I wrote it
      on request for a couple of german folks [my english isn't the best].


    Send bug reports and other stuff to:

    werner.koch@guug.de

------
