Starlink-pyast

----------------------

- Fix bug in FitsChan that caused SIP headers to be treated as linear
when creating a FrameSet from the headers.

- Fix bug in LutMap that incorrectly allowed an inverse lutmap to be used
even if the original LutMap was not monotonic.

- Allow attributes to be set for each plane of a Plot3D.

- Avoid some compiler warnings.

----------------------

- The SkyFrame class has a new attribute called SkyTol, which specifies
the smallest significant distance within the SkyFrame. It is used to
decide if the Mapping between two SkyFrames can be considered a unit
transformation. The default value is 0.001 arc-seconds.

- A bug has been fixed in the FitsChan class that prevented illegal
characters within FITS keyword names (i.e. characters not allowed by the
FITS standard) being detected. This bug could under some circumstances
cause a subsequent segmentation violation to occur.

- A "BadKeyName" warning is now issued by the FitsChan class if a FITS
keyword name is encountered that contains any illegal characters. See
attribute "Warnings" and function "astWarnings".

----------------------

- The behaviour of the astAddFrame method has been changed slightly.
Previously, astAddFrame modified the FrameSet by storing references to
the supplied Mapping and Frame objects within the FrameSet. This meant
that any subsequent changes to the current Frame of the modified FrameSet
also affected the supplied Frame object. Now, astAddFrame stores deep
copies of the Mapping and Frame objects (rather than references) within
the modified FrameSet. This means that subsequent changes to the modified
FrameSet will now have no effect on the supplied Frame.

- The choice of default tick-mark for time axes has been improved, to avoid
previous issues which could result in no suitable gap being found, or
inappropriate tick marks when using formatted dates.

- A new method called astRegionOutline has been added to the Plot class.
It draws the outline of a supplied AST Region.

- A bug has been fixed that could cause astSimplfy to enter an infinite loop.

- Some improvements have been made to the Mapping simplification process
that allow more Mappings to be simplified.

- The Frame class has a new read-only attribute called "InternalUnit",
which gives the units used for the unformatted (i.e. floating-point) axis
values used internally by application code. For most Frames, the
InternalUnit value is just the same as the Unit value (i.e. formatted and
unformatted axis values use the same units). However, the SkyFrame class
always returns "rad" for InternalUnit, regardless of the value of Unit,
indicating that floating-point SkyFrame axis values are always in units
of radians.

- The LutMap class has a new attribute called LutEpsilon, which specifies
the relative error of the values in the table. It is used to decide if
the LutMap can be simplified to a straight line.

----------------------

- Methods astRebin, astRebinSeq, astResample and astTranGrid now report an
error if an array is specified that has more pixels than can be counted by
a 32 bit integer.

- The hypertext documentation is now generated using Tex4HT rather
than latex2html. The format of the hypertext docs has changed
significantly.

- Another bug fix associated with reading CAR projections from FITS-WCS headers.

- Constructor options strings of the form "..., "%s", text );" can now be
supplied. This avoids a security issue associated with the alternative
form "..., text );".

----------------------

- For security reasons, the change introduced to astAppendString in
V8.0.1 has been moved to a new function called astAppendStringf, and
astAppendString itself has been reverted to its V8.0.0 version.

----------------------

- The macro used to invoke the astAppendString utility function has
changed to allow printf-style converstions to be included in the
supplied text. Any code that uses this macro must be re-compiled.

- The astRebin and astRebinSeq family of functions now include support
for arrays with char (byte) and unsigned char (unsigned byte) data types.

- The Base and Current attributes of a FrameSet may now be set using the
Domain name or the index of the required Frame.

- The FITS XPH projection is now supported.

- The order of WCS axes within new FITS-WCS headers created by astWrite
can now be controlled using a new attribute called FitsAxisOrder.