INSTALL
-------
This file describes how to install asedit program (Version 1.3.2).

PREREQUISITES
 X-Windows Release 6, 5, or 4 and Motif 1.2, 1.1 (usually the higher the
	 version the better)

INSTALLATION

1. Make sure that "xmkmf" is in your path somewhere (probably in
   /usr/bin/X11/xmkmf or /usr/X11R5/bin/xmkmf).

2. Check and edit the Imakefile for any customization that needs to be done
   (on most systems, if you want to install the program and other files in the
   standard places, you don't have to change anything).

3. I assume you want to use your installed libraries and include files.
   So type:

	xmkmf
	make asedit

4. If you want to TRY OUT asedit from within the build directory
   before doing the "make install" type:

	./asedit.try   [options] [filename(s)]

   or for a French version:

	LANG=fr ./asedit.try  [options] [filename(s)]

   (you can test the following language versions: da, de, en, fr, nl, pl, pt and sv).

   To test on SGI computers with high GAMMA colour corrections use:
	./asedit.try -xrm "*customization: -sgi" 

   To test the special emacs mode (alternate set of bindings) use:
	./asedit.try -emacs 


5. Install it. Become a root or somebody having write permission in the
   install directories and type:

	make install
	make install.man


   To install a non-default language version, for example a French one, type
   the following:

	INST_LANG=fr make install

   The above command is for the Korn(ksh) or Bourne(sh) shell.

   Repeat the above for other languages, if needed.

   Note that on some systems you might need to include a territory name
   for the full locale definition (for example for French you might choose one
   of the following: fr_FR, fr_BE, fr_CA, fr_CH).  Check your documentation or
   use INST_LANG=$LANG for the current locale installation.
   Note also that for all languages we use ISO8859 codesets.



That's all!
___________________
Installation notes:

i)  If you do NOT have xmkmf try:

	imake -DUseInstalled -I/usr/lib/X11/config

    The name of the directory where all the configuration files for imake
    reside might be slightly different for your system, change that if
    necessary (e.g. for IBM RS/6000 AIX 3.2.3 I found it as
    /usr/lpp/X11/Xamples/config, on SOLARIS 2.3 it is /usr/openwin/lib/config).


    If you do not have imake or something goes completely wrong, COPY
    the supplied Makefile.raw onto Makefile, edit it if needed and
    "make asedit".

ii) If you would like to compile in the non-English default fallback
    resources do the following (let's assume you want a French version):

	rm Asedit.ad.h
	INST_LANG=fr make asedit

    The above command is for the Korn(ksh) or Bourne(sh) shell.

iii) If you have previous versions of asedit installed on your system (i.e.
     1.0, 1.1x, 1,2x) please remember to CHANGE/UPGRADE the application
     defaults files (i.e. the system wide Asedit file and the private Asedit
     file in the user home directory). Otherwise the new asedit would pick up
     the old application defaults file(s) and some functionality might be lost.

iv)  If on a program startup you get a lot of warnings about osfKeys read the
     on-line help topic: "Index|Users' Q & A" (simply your Motif setup is wrong).



Andrzej Stochniol				(A.Stochniol@ic.ac.uk)
-----------------				----------------------
30 Hatch Road, London SW16 4PN, UK.

(Please use telephone and fax numbers only when absolutely necessary !!)
	Tel: +44 (0)181 679 5795		Fax: +44 (0)171 584 1560
 (work) Tel: +44 (0)171 594 7076

