	asWedit ver. 3.0 - Installation notes
	=====================================


Quick start
-----------

To run the program without installing it, go to the distribution
directory and type:

	asWedit -helpdir .  [file_name]

(the file_name is optional).

The above runs the program in its "standard" HTML 3.2x mode. To try  the 
other two available modes (HTML experimental and the plain text) type:

	asWedit -helpdir . -htmlx

	asWedit -helpdir . -nohtml


Upgrade NOTES: 
    (1) Old resource file. 
    If you are upgrading from any previous asWedit version and 
    you had installed the old AsWedit application defaults file you MUST 
    install the new application defaults file first (or run the program 
    in a specific way -- see the on-line help topic Index|Users' Q & A|
    |Program startup).  You might also have to type "./asWedit" to ensure 
    that the new version will load up.

    (2) Private customization and new toolbars contents.
    The toolbars have new default contents as new useful HTML commands
    have been added. To see the new layout delete all lines from
    the file "~/.asWedit-prefs" that contain the word: "Content" and
    save it. Alternatively, if you have NOT done any private 
    customizations delete the whole file.

Non-English locale (Language NOTE)
    As the program is internationalized then you should, on many systems,
    set the language environment first. On most systems it means  defining
    the LANG environment variable. **If you get a warning** about a not
    supported locale on the program startup or you want to set a specific 
    locale, then do the following from the command line:
    For Bourne/Korn shell:
	LANG=C; export LANG
    For C shell:
	setenv LANG C
    (replace the C above with your locale name, like en, de, fr, pl, etc. 
    or use C if you want to work in the default 7-bit English locale).
    Note that on SunOS 4.x to set support for French (German, and so on) 
    you have to do the following:
	setenv LANG C
	setenv LC_CTYPE iso_8859_1


Simple installation
-------------------

After unpacking the distribution just copy the program "asWedit" into your
(or system) 'bin' directory and copy the supplied help file "asWedit.hlp"
into your 'lib' directory (the default is "/usr/local/lib").

If you use the default 'lib' directory and you don't want to customize
asWedit on a system-wide basis by modifying its X-resources, then that's
the end of installation for you (note that you will be able to make some
on-line customization of the program, for example modify the toolbar
contents).


Non-default 'lib' directory
---------------------------
If your 'lib' directory is different from the default one then you have 
to tell the program where to look for its help file. It might be done
in several ways. The two most common are: use the command line '-helpdir'
option as in the 'Quick start' section above, or specify asWedit resource
called 'helpDir' in your .Xdefaults file, for example:

  AsWedit*helpDir:	/usr/local/share/lib

Finally you have to copy the "asWedit.hlp" help file into your 'lib'
directory, for example:
	cp -p asWedit.hlp /usr/local/share/lib


Installation of the application defaults file
---------------------------------------------
Most of asWedit resources are defined in the supplied "AsWedit" resource file.
Note that all of them are built-in to the program so it is NOT necessary
to install this file. But if you would like to customize the program
in a way that is not possible during run-time (for example: define local
printers, change the colors, define some user tools or commands)
then you can do that by modifying the file or your personal AsWedit
resource file, which might be just a very small subset of the system-wide 
AsWedit file (the latter is recommended).

To install the "AsWedit" application defaults file copy it to your system
'app-defs' directory. If you use the default X11 setup do the following:
	cp -p AsWedit  /usr/lib/X11/app-defaults
		       ^^^ your app-defs dir ^^^

If you do install the "AsWedit" file specify the 'helpDir' directory there
(if necessary). Simply find, uncomment and edit the resource.

Note that AsWedit resources are grouped according to the probability of
them being changed by a user. For details see the AsWedit file and
the on-line help.


User customization
------------------
If you would like to do some personal customization that cannot be done
interactively from inside the program, for example define your own colors
etc., create a file called "AsWedit" in your home directory (or a directory
pointed by XUSERFILESEARCHPATH, if used) and copy only the resources to be
customized from the system wide resource file, then modify them.
Alternatively, copy the selected resources into your ".Xdefaults" file but
prepend them with the "AsWedit" name. The resources most likely to be
customized are in part 1 of the AsWedit file.


NOTES
-----
(1) To install in system-wide directories you have to become the system
    administrator (root).
    If *you* are a system administrator (education etc.) you should install
    the system wide resource file and modify some local definitions for your
    users (like printers, WWW server, etc.). See Parts 1 & 2 of AsWedit file.

(2) If you would like to use Emacs bindings you have to obtain the file:
	emacs-mode-asWedit-3.0.tar.Z
    and install "AsWedit_em" resource and "asWedit_em.hlp" help files.
    To run in Emacs mode use the "-emacs" command line option.

(3) If you want to use a localized version you have to obtain and install 
    a resource file from the i18n-resources directory, appropriate for 
    your language. Read the additional installation notes included
    with the localized resources (INSTALL.i18n).
    
(4) To learn about what is new in the version 3.0 read the help topic:
	Index|What's new ?



Problems ?
----------

If you have any problems **please** read the on-line help and especially
the topic:
	Index|Users' Q & A
before contacting your local supporting person.
Please remember that the help is context-sensitive: when you need extra
information about a command or an element, just press the Help key (F1)
when the command (element) is selected or alternatively, use the new
click-on-item help (Shift+F1).
You might also check the following Web document that will describe
problems discovered and existing workarounds:
	<URL:http://www.advasoft.com/bugs.html>

Finally, if you have problems that you cannot resolve (see above) or
you find a bug in the program please send E-mail to:
	help@advasoft.com
	bug@advasoft.com	(use only for bug reports).
Please describe the problem and include the output of the following
commands (executed on a computer the problem has occurred):
	uname -a
	asWedit -version

-----------------------------
Thank you. Enjoy the program.
as@advasoft.com (A.Stochniol)
