1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124
|
-*-text-*-
UNIX installation specific functions. Please read this file.
0. Building and installing JED requires that you also have the S-Lang library
to installed. See http://www.jedsoft.org/slang/download.html for
information about obtaining the library.
* NOTE: Many Unix distributions distribute a version of the library
that that may be used to compile against. For example, on Debian
Linux the library is in the "libslang2-dev" package, which may be
installed using:
apt-get install libslang2-dev
* NOTE: Since the jed editor is a conforming slang application, it
makes use of the slsh library files, which are part of the slang
distribution. If you install slang from source, then these files
will also get installed. However, on Debian Linux and its derivatives,
these files have been placed into a separate "slsh" package you
will need to install:
apt-get install slsh
1. Choose an installation location for JED. JED is distributed in a
TREE structure:
$JED_ROOT/
$JED_ROOT/src
$JED_ROOT/info
$JED_ROOT/doc
$JED_ROOT/lib
$JED_ROOT/bin
Here JED_ROOT can be anything (e.g., /usr/local/jed). It must be
specified in the Makefile of the src subdirectory. It is important
that the subdirectories under $JED_ROOT remain intact. An
environment variable called `JED_ROOT' can also be created to over
ride the value compiled with the executable.
3. Build JED.
./configure --prefix=/usr/local
This assumes that you want it installed with JED_ROOT equal to
/usr/local/jed/, with the main jed executable installed in /usr/local/bin/.
This step creates the necessary Makefiles.
* Note: If you have the slang library installed in a
non-standard location, you may have to tell configure
where to look, e.g.,
./configure --prefix=/usr/local --with-slang=/goodies/lib
For more options, run `./configure --help`
* Note: On CYGWIN, make sure the libslang2.dll in your PATH,
otherwise jed will not run, nor will the chkslang program.
* Note: On Linux systems, JED may be compiled to take advantage
of the GPM mouse server. See the mouse section in
src/Makefile for enabling this.
* Note: If you are building jed on a system that uses more than
one architecture, then before running make, define an
environment variable called ARCH whose value specifies
the system, e.g., sun4, solaris, etc.
Now type `make' at the shell prompt. If you have X windows and you
would like to create 'xjed', additionally run 'make xjed'. If all
goes well install it with `make install'.
JED comes with a highlighting recursive grep program called rgrep.
Use `make rgrep` to build it.
4. By default, when JED starts up, it will load some files out of
$JED_ROOT/lib then it will look for the file .jedrc in the user's
home directory. If it does not find it, it will load the default
file jed.rc from $JED_ROOT/lib.
In fact, the user is encouraged to copy jed.rc to $HOME/.jedrc and
make personal changes there. The $JED_ROOT/lib/jed.rc file should
be regarded as a template for .jedrc and should not be changed.
The default editor emulation is specified by the
_Jed_Default_Emulation variable, which defaults to "emacs".
Site specific customization should be placed in /etc/jed.conf or
more generally in $prefix/etc/jed.conf. An example jed.conf file
may be found in the lib subdirectory. Among other things, it may
be used change many of the defaults on a system-wide basis. For
instance, many Unix users may not want emacs bindings and may
prefer something like Borland's IDE keybindings. It is in this
file where such defaults may be made. See the sample file for more
details.
For more information about customizing jed on a site-wide basis,
read the INSTALL file.
5. Optional but highly recommended: preparse the S-Lang files. This
is done by running JED as:
# jed -batch -n -l preparse.sl
This creates pre-parsed *.slc files that load quicker than *.sl
files. If this step fails to work for some reason, JED is probably
not properly installed. Note that the bytecodes that are stored in
the preparsed files (*.slc) may depend upon the version of the
slang library that was used. This is particularly relevant if jed
is dynamically linked to the slang library and for some reason you
upgrade the library. If you do this, then immediately after
installing a new version of the slang library, run the command
`touch *.sl' on all the .sl files in the $JED_ROOT/lib directory.
See the release notes (changes.txt) that are distributed with the
slang library to see if any of the byte-codes have changed.
6. New releases will be announced to the jed mailing lists as well
as the newsgroups comp.editors and alt.lang.s-lang. See
<http://www.jedsoft.org/jed/> for more information about
the mailing lists. Additional information may be found at
<http://www.jedsoft.org/slang/>.
7. That's it. Enjoy.
--John
|