distribution-README.begin 3.85 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14



    The LysKOM Emacs Lisp Client
    -------------------------------------------
    Release notes for version @@CLIENTVERSION@@



    LysKOM is a project in progress at the Lysator Academic Computing
    Society at Linköping University in Sweden. For information about
    Lysator, see <URL:http://www.lysator.liu.se/>. For more information
    on LysKOM, see <URL:http://www.lysator.liu.se/lyskom/>.

15
16
    The latest version of the Emacs Lisp client for LysKOM is available
    from <URL:http://www.lysator.liu.se/lyskom/klienter/emacslisp/>.
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

    LysKOM is free software; you can redistribute it and/or modify it
    under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2, or (at your
    option) any later version.

    LysKOM is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
    General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with LysKOM; see the file COPYING. If not, write to Lysator,
    c/o ISY, Linköpings universitet, S-581 83 Linköping, SWEDEN, or
    the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA
    02139, USA.

    Please mail bug reports to bug-lyskom@lysator.liu.se. 
    Please mail change requests to kom@lysator.liu.se.



1.  REQUIREMENTS

41
42
    You need an Emacs. The client appears to work completely with the
    following versions of Emacs:
43

44
45
    * XEmacs version 21.4 and newer
    * Gnu Emacs version 20.7 and newer
46

47
48
49
50
    The client may work with earlier versions of Emacs and XEmacs. To
    compile in Emacs 19.34 you will have to replace the included
    custom package, and if you use Gnus you may have to update that as
    well (see below).
51

52
    There are some requirements on supplemental elisp packages:
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

    * custom

      You need to have a recent version of the custom package
      installed. The custom.el file that is bundled with Gnu Emacs
      19.34 and older versions of Gnus will not work.

      The version that is bundled with recent versions of XEmacs, with
      Gnu Emacs 20, with recent versions of Gnus and w3 is the one you
      need.

      Custom is not longer distributed as a separate package, but it
      may be available at <URL:http://www.dina.kvl.dk/~abraham/
      custom/>. An old version is available in the elisp-client ftp
      directory at <URL:ftp://ftp.lysator.liu.se/pub/lyskom/elisp-
      client/>.

      If you have a version of Gnus installed that uses the old custom
      package, it's time to upgrade. The latest version of Gnus is
      available from <URL:http://www.gnus.org/>.

74
    * You should NOT HAVE macedit.el
75
76
77

      Make sure you do not have a file called macedit.el early in your
      load path. This file redefines a function that the client relies
78
79
80
81
82
83
      heavily on. The redefinition is buggy. The client will attempt
      to detect this situation and fix it by loading edmacro. If you
      have macedit but not edmacro, you will experience problems. You
      can recognize this situation if your Emacs says something like
      this: "Key sequence < m o u s e - 2 > uses invalid prefix
      characters" when you load or compile the elisp client.
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

    * w3 4.0 or later (optional)

      LysKOM can use w3 for displaying HTML. At the time of writing
      this, the latest version of W3 is 4.0. It is available from
      <URL:http://www.cs.indiana.edu/elisp/w3/w3.html> and included in
      many distributions of Emacs. If w3 is not installed, LysKOM will
      be unable to display HTML.

    * calc (optional)

      LysKOM uses calc to implement the "Compute" command. If you want
      to use it you need calc. The latest version of calc, as of
      writing this, is available at <URL:ftp://ftp.gnu.org/pub/gnu/
      calc/calc-2.02f.tar.gz>