Release notes for XPaint 2.7.0
------------------------------

This version of XPaint is one in a new series of releases produced by 
Jean-Pierre Demailly (demailly@fourier.ujf-grenoble.fr). It adds
a number of functionalities to the earlier releases 2.5.7-2.6.2.

Starting with version 2.6.4, Xpaint can be fully internationalized.
If you wish to add your own (yet unsupported) language, it is sufficient to
translate the app-default file and set it as 'XPaint_xy.ad.in' where
'xy' are the first two letters of the LANG parameter defining the
language. Also 'XPaint_xy.ad.in' should point to appropriate localized
files 'Messages_xy' (and optionally 'Help_xy') reproducing the
structure of 'Messages' and 'Help' respectively. Check for instance
'XPaint_fr.ad.in' to see how things work. If you do not provide a
translation of the (somewhat lengthy) Help file, the English 'Help' will
be loaded as a fallback.

The official maintainer, Torsten Martinsen (torsten@image.dk) produced 
versions numbered 2.2.x to 2.5.7, and still maintains the main web page. 

The current versions are derived from XPaint 2.1.1, which was written by 
David Koblas. Please do NOT send bug reports etc. to David Koblas.

To compile this program, you will need:

	- an ANSI C compiler (such as GCC),
	- the Xpm library, version 3.4c or later

To compile with support for TIFF images, you must have the TIFF library,
version 3.2 or later. 

To compile with support for JPEG images, you must have version 6 of the JPEG
library from The Independent JPEG Group, released 2-Aug-95. Newer versions
should also work.

To compile with support for PNG images, you must have the PNG library, version
1.0.8 or higher.

The TIFF/JPEG/PNG libraries can be downloaded from
http://www.libtiff.org/
http://www.ijg.org
http://www.libpng.org/
libpng itself requires zlib, which can be found at
http://www.zlib.org/


Xpaint can (and should) be compiled just with the standard X11 libraries 
and the Xt toolkit, augmented with one of the Athena widget library clones. 
The plain Xaw library is OK -- however it yields very old-fashioned widgets.
For better results, we recommend the Xaw95 clone, which is now included
in Xpaint's distribution, and can be compiled either statically or
dynamically.

XPaint is known to have been successfully built on the following platforms:
	- Linux 2.0.18, XFree86 3.1.2, GCC 2.7.2
	- Solaris 2.4, 2.5, 2.6
	- SunOS 4.1, 4.1.4
	- FreeBSD, NetBSD, BSD386
	- DEC Alpha, native cc
	- AIX
	- SGI IRIX-6.2
	- HP-UX A.09.05 A 9000/735, native cc

Any feedback on problems is welcome, but remember to include the following in
your bug report:
	- The version number of XPaint
	- The system you are using (e.g. 'Linux 1.3.14', 'Solaris 2.4')

See 'INSTALL' for installation instructions.

See 'Doc/CHANGES' for a list of changes relative to XPaint 2.1.1.

See 'Doc/Operator.doc' for a description of XPaint internals.

See 'Doc/sample.Xdefaults' for an example of setting resources for XPaint.

See 'README.old' for the original README.

See 'README.PNG' for notes on the PNG support.

See 'TODO' for a list of possible improvements.

See 'Doc/CHANGES' for a list of people who have contributed patches and bug
reports.

The most recent version of XPaint is always available from

	http://sourceforge.net/projects/sf-xpaint/

Thanks to the many beta testers who put up with the first buggy releases.


KNOWN BUGS

The 'Transparent Brush' tool does not work well on colour mapped visuals with
256 colours. The reasons are:
	1) It is too slow. This could perhaps be fixed.
	2) All entries in the colour map are used up in rather quickly.
	3) The limited number of colours give rise to round-off errors
	   when computing the new pixel colours.

Undo/Redo exhibits some weirdness in certain circumstances.

Selecting a region enables the 'Last Filter' menu item.

The following causes a SIGSEGV (reported by Hans Dietmar Jäger
<jagger@uni-paderborn.de>):

	open a file A
	open another file B
	do Image -> Change Size to file A, change Width, press TAB and leave the
	dialog open
	do Image -> Change Size to file B, change Width and leave the dialog open
	try to change Height by pressing TAB or clicking mouse-left in the
	Height field

-Torsten Martinsen (torsten@image.dk)

The following are new due and are related to the -visual flag:
	1) DirectColor colormap is wrong.

	2) Xaw3d only works in 8 bit mode -- has a problem with
	   button = XtCreateManagedWidget(...) menu bar in menu.c
	   in anything higher than 8 bits.

	3) The smear tool fails in anything greater than 8 bit mode
	   because XPutImage in smear() in brushOp.c is failing.
	   Probably caused by depth mismatch somewhere in call
	   to smear.

-Scott D. Nelson (nelson18@llnl.gov), August 1997

