etc/gnuserv.README

   1 This file is not meant to be proper documentation. See the file gnuserv.1 for
   2 more information.
   3
   4 ****
   5 NOTE: This version of gnuserv has some enhancements over the original version
   6   distributed by Andy Norman. See the end of this file for more details.
   7 ****
   8
   9 To install, copy gnuserv.el into a directory on your GNU Emacs
  10 load-path. Edit Makefile and change INCLUDES to point to the src
  11 directory underneath your emacs source tree (or make yourself a
  12 config.h file in this directory by hand, starting with config.h.proto
  13 as a first cut) and type:
  14
  15      make
  16
  17 This should compile the server and the two clients. Now put gnuserv,
  18 gnuclient and gnudoit in a directory that users have in their executable
  19 search paths.
  20
  21 File                    : Description
  22 ----------------------------------------------------------------
  23 Makefile                : Makefile to build gnuserv
  24 LICENSE                 : GNU General License
  25 README                  : this file
  26 gnuclient.c             : editor client C code
  27 gnudoit.c               : eval client C code
  28 gnuserv.1               : gnuserv man page
  29 gnuserv.c               : server C code
  30 gnuserv.el              : server LISP code for GNU Emacs V18,V19,
  31                           XEmacs/Lucid Emacs and Epoch V4
  32 gnuserv.h               : server/client C header file
  33 gnuslib.c               : server/client C common code
  34 src.x11fns.diff         : diffs to src/x11fns to raise window (for emacs18)
  35
  36 config.h.proto          : Use this file as the starting point for constructing
  37                           a config.h if you don't have access to the
  38                           one that was used when compiling your emacs.
  39
  40 If you find *any* problems at all with gnuserv, or you can think of better
  41 ways of doing things (especially remote file access), please e-mail me at one
  42 of the addresses below.
  43
  44 ange@hplb.hpl.hp.com
  45 ange@hpl.hp.co.uk
  46 ...!hplabs!hplb!ange
  47 ...!ukc!hplb!ange
  48
  49
  50
  51 This version of gnuserv has been enhanced by a number of people, including
  52 Bob Weiner <weiner@mot.com>, Darrell Kindred <dkindred@cmu.edu>,
  53 Arup Mukherjee <arup@cmu.edu>, and Ben Wing <ben@xemacs.org>. The
  54 modifications are basically as follows:
  55
  56 Bob Weiner:
  57
  58      Integrated support for several versions of emacs. New requests
  59      from gnuclient cause the creation of new frames. Removed the
  60      restriction on the length of the string passed to gnudoit. Later
  61      added a server-done-function variable to control what happens to
  62      a buffer after the user is done with it. Mods to each of the .c
  63      files as well as gnuserv.el.
  64
  65 Darrell Kindred:
  66
  67      Removed the restriction on the length of the string returned from
  68      a gnudoit request, for the purposes of unix/internet sockets.
  69      Allow the gnudoit request to be read from stdin if it's not
  70      specified on the command line. Internet sockets are not opened
  71      unless the GNU_SECURE variable is specified. Unix sockets are
  72      created in a protected ancestral directory, since many Unix
  73      variants don't enforce socket permissions properly. An internet
  74      socket accepting local connections is not opened by default
  75      because this would make it possibly to override all security on
  76      the unix socket. See the man page for details. Unless told to do
  77      otherwise by a command-line argument, gnuclient and gnudoit now
  78      try to open a unix socket by default if support for them was
  79      compiled in.  Mods to each of the .c files and to gnuserv.el.
  80
  81 Arup Mukherjee:
  82      Removed the restriction on the length of the string returned from
  83      a gnudoit request, for the purposes of sysv ipc. Added support
  84      for the "gnuserv-frame" variable allowing you to specify control
  85      whether or not new screens are created in response to each
  86      gnuclient request. Made a number of other bugfixes and changes to
  87      the lisp part of the code, allowing gnuserv to work properly with
  88      newer emacs versions. All the changes are listed in the changelog
  89      at the beginning of gnuserv.el. Also fixed up the man page to
  90      reflect the new gnuserv features. On HPs, stopped the "-r"
  91      parameter (in gnuclient) from defaulting to /net/<remotehost>.
  92      Not all installations want this, and it's much harder to debug
  93      when things stop working. Changed the man page to reflect this.
  94      Mods to each of the .c files, gnuserv.el and gnuserv.1
  95
  96      More recently - added Xauth(1X11)-style authentication to gnuserv (as
  97      of version 2.1). Although the code is completely new, credit is
  98      due to Richard Caley <rjc@cogsci.edinburgh.ac.uk> ... he wrote a
  99      prototype implementation from which I borrowed the basic
 100      mechanism for hooking Xauth into gnuserv.
 101
 102 Ben Wing:
 103      Added gnuattach.