ChangeLog

07/03/12 mdcb 2.2.01x-4
- build from vanilla yorick clone on github.
- fix namespace pollution due to imported foreign modules.
- add module constant 'version' aligned with yorick version.
- add module constant 'GISTPATH'
- include Xft patch from F. Rigaut
- include zero border width patch
- distfile build and setup overhaul, patch option (see setup.cfg)
- fix misc. memory initialization issue
- deprecate gistfuncts provided by numpy
- features (not so new)
    xid() .......... returns the window's xid for X11 reparenting
    keybd_focus() .. grab focus for screenshot
04/22/10 mdcb Upgraded to Yorick 2.1.06x
05/28/06 mdh Fixed the DrwText routine in gist/ps.c to deal correctly with
strings of zero length. This bug caused crashes when plt("") was called and
a hardcopy was made. The event loop was changed for Windows, Cygwin, and
Mac OS X; the event loop now works the same on Windows, Cygwin, Mac OS X, and
Unix/X11.  Some smaller fixes (memory leaks) on Mac OS X.
11/11/05 dpg/mdh Fix a memory leak in setkw_string. Replaced tabs by spaces
in gistCmodule.c.
07/30/05 dpg/mdh Replace int's with long's where needed in src/gistCmodule.c
for 64-bits linux. Modify setup.py to set the library search path to
/usr/lib64 for 64-bits linux. Change the order in which different options
are tried in the find_poll function in setup.py for gist to compile correctly
on Mac OS X 10.4. The new setup.py was also tried on Windows, Linux, Cygwin,
and older versions of Mac OS X; no problems were found.
11/16/04 llc Fix GxPointClick; replace ifdef on this w/ MOUSE_CLICK.
mouse function was not working because of this.
11/09/04 mdh The Py_InitModule4 needs to be called even if the module
has already been initialized.  Move the initialized test. 
11/08/04 mdh Added a couple of changes for Mac OSX.
11/04/04 dpg Changed TRY macro to return a MemoryError only if an 
exception has not already been raised (in which case, it
returns NULL). Also, fixed casting warning in contour's TRY 
with PyTuple_GetSlice, changing 0 to (PyOject*) NULL.
11/03/04 dpg Discovered that beginning with Numeric 23.4, which has
stricter type checking (problems converting longs to ints),
PyArray_INT had to be changed to PyArray_LONG. (else there
were problems in plc, ...).
04/22/03 llc Fix bug in PLF.
04/08/03 llc Remove include of limits.h and unused defines;
Replace DISPLAY_ENGINE with GpFXEngine, DISPLAY_MOUSE with
GxPointClick, and DISPLAY_ZOOM_FACTOR with gxZoomFactor, and
remove use NO_XLIB, and NO_MOUSE. 
04/07/03 mdh Implement justify option for plt (align).
Add functions as those in style.i in yorick to allow
allow users to change style properties interactively:
get_text_attributes, get_legend, get_line_attributes,
get_axis_style, get_tick_style, get_system, 
get_systems_list, get_style, ... similarly for set*.
03/25/03 dpg Provide a way to change CGM file size via pldefault.
03/12/03 llc Remove version and help comments; add to gist.py.
02/25/03 llc Fix mouse command so data is returned.
02/20/03 llc Correct mouse return; see MouseCallBack.
02/13/03 llc Disable initial pygist printout upon import (except 
when DEBUG flag is on).
02/13/03 dpg Add plremove implementation. 
Correct bug in pli (iMax anad JMax were reversed).
01/17/03 llc Remove remaining warnings with gcc 2.96 by:
- Reduce to one dummy for file
- Remove dumpFreeList, Add1 cumsum, equal, greater, 
greater_equal, less, logical_and, not_equal, 
WeightedHist if not INCLUDE_EXTRA_GISTCODE.
01/13/03 mdh Add back on omitted bug fix for Windows (wait_for_expose).
12/27/02 mdh Windows/Cygwin adjustments (e.g. pyg_on_idle calls for
Windows); fix formats for pointers.
12/04/02 dhm more fixes to get pygist working under windows, _tkinter
Macros for proper printing to stdout and stderr.
Add pyg_unhook, pyg_idler, pyg_pending, and pyg_register.
11/26/02 llc Add documentation on plg markers.
11/25/02 dhm Rework of play resulted in change to PyOS_InputHook and
other improvements (multi-line strings).
11/24/02 dhm fix event/exception handling interface
11/19/02 llc Use gist interface provided by Dave Munro for PyOS_InputHook.
Remove old solutions now that play/unix has changed.
11/15/02 mhd Add u_enterloop for third approach to interfacing Python
to gist.  Save the last approach as USE_U_WAITER.
11/13/02 llc Add back option to switch between two interfaces to Python.
(using define USE_RL_GETC)
11/11/02 llc Add Numeric to arrayobject.h include, so it is found
automatically when the Python include directory is searched.
(suggestion from MDH)
11/08/02 llc Use the PyFPE_START_PROTECT and PyFPE_END_PROTECT 
macros defined in the standard Python include pyfpe.h.
Add a dummy argument to PyFPE_END_PROTECT.
11/07/02 llc Clean up some compiler warnings:
Get rid of SETERR macro; used just once.
Correct format for writes of longs in debug_array, PrintColor.
Add explict casts to ERRSS where required.
Remove unused variables.
Cast u_waiter properly, and note possible issue.
11/01/02 mdh Replace rl_getc_function with PyOS_InputHook.
09/04/02 llc Deep copy string returned from PyString_AsString
in setkw_string.
12/17/01 llc Add documentation lines to slice2.
12/06/01 llc Remove fix for E_TEXT type entries in legend; these
are legitimate.
12/03/01 llc Discovered that new setting of zc in plf causes 
unaligned accesses on DEC Alpha; go back to earlier
form setting temporary zc1.
With this change, test suite runs to completion.
11/29/01 llc Set rgb for triples.
bytscl: Change len to long.
11/16/01 llc Update to 1.5's legend handling. 
11/12/01 llc Unpack color triples.
Colors changed from int to unsigned long (1.4 to 1.5).
Check for negative colors.
11/08/01 dhm Turn on idle function to do graphics tasks.
11/05/01 llc Move all of the function documentation from gist.help
to doc strings for each PyObject, so it can be accessed 
with pydoc.
11/03/01 llc Started from version with changes from Dave Munro:
turn on rl_getc_function, and add readline.h include. 
Must use with version of python built with readline.

Modified in December, 1997 to coexist with the readline library used
in Python's interpreter. William Magro, Cornell Theory Center.

--- from HISTORY

V041206 Michiel de Hoon

        1.  gist/gistdemo3d.py:  Change demo5_n from an array of floats to 
            an array of ints (no reason to use floats and the change avoids 
            a deprecation warning).

        2.  src/gist/xbasic.c:  Correct bug: Do not set xeng->w in Kill 
            because xeng has already been freed.

        3.  src/play/win/pwin.c:  Correct bug in p_destroy: 
            The call to DestroyWindow effectively calls the w_winproc 
            window routine with the WM_DESTROY message. It does not simply
            post this message, but calls w_winproc immediately. In the 
            w_winproc function, pw is free'd:  p_free(pw);
            (line 400 in src/play/win/pscr.c). So, by the time we get to 
            the end of the p_destroy routine, pw has been freed and we 
            cannot access pw->pbflag, pw->pen, and pw->brush. Moving the 
            last two lines to the top of the p_destroy routine solves the 
            problem.

*** Release 1.5.22 ***

V041124 Michiel de Hoon 

        1.  gist:  Add missing colorbar.py.

        2.  Bug fixes for the pause function on native Windows and Mac OS X: 
            src/play/win/pwin.c
            src/play/mac/pscr.m

*** Release 1.5.21 ***

V041116 Chase 

        1.  gistCmodule.c:  Fix GxPointClick; replace ifdef on this w/ 
            MOUSE_CLICK.  mouse function was not working because of this.

        2.  Note:  In response to the request for control over the size of
            the graphics window, to get a larger window, specify, a different 
            dpi arg to window; e.g.

               window ( 2, wait=1, dpi=50 )
               window ( 3, wait=1, dpi=125 )

            With dpi=100 and window size 6"x6", the size in pixels is
            600x600.  Resetting pixel sizes in xbasic.c makes a bigger
            window, but the plot is the same size; you just get more 
            white space around the plot.

*** Release 1.5.20 ***

V041109 Michiel de Hoon 

        1.  src/gistCmodule.c:  The Py_InitModule4 needs to be called even 
            if the module has already been initialized.  
            Move the initialized test. 

        *** This fixes a Python complaint about gistC not being properly 
            initialized.

V041108 Michiel de Hoon 
         
        *** Added support for Mac OSX. ***

        1.  setup.py:  Updated for Mac OSX.

            Nothing changes for Unix/Linux and MS Windows.
            Note that on Mac OS X, the compilation defaults to the native 
            version.  To use the X11 version instead, add --x11 when 
            running setup.py.

        2.  src/gistCmodule.c:  Add a couple of changes for Mac OSX. 

        3.  gist/gist.py:
            plh: Change test if color is a list; also test if array.

        4.  gist/gistdemolow.py:  Fixed typo on line 124 and 132.
            First arg should be 6.  (Yorick to Python translation error)
            Add font test #25 and a better histogram demo.

        5.  src/play/mac:  Added files:
               playm.h bitblt.m cell.m clips.m color.m cursors.m font.m
               pals.m pen.m points.m pscr.m pwin.m text.m
            These files are in Objective-C, which is the standard programming 
            language on Mac OS X.

V041108 Chase

        1.  Remove gist/__init__.disable, and add gist/__init__.py.

*** Release 1.5.19 ***

V041104 Dave Grote

        1.  gistCmodule.c:  Changed TRY macro to return a MemoryError only if an
            exception has not already been raised (in which case, it
            returns NULL). Also, fixed casting warning in contour's TRY 
            with PyTuple_GetSlice, changing 0 to (PyOject*) NULL.

V041103 Dave Grote

        1.  gistCmodule.c:  Discovered that beginning with Numeric 23.4, 
            which has stricter type checking (problems converting longs to 
            ints), PyArray_INT had to be changed to PyArray_LONG. (else there
            were problems in plc, ...).

V040924 Chase
  
        1.  Fixed fixPermissions_llnl, adding version.py.

V030616 Michiel de Hoon

        1.  gist.py:  plh (plot histogram): Added a keyword (height) 
            for font size of labels.

*** Release 1.5.18 ***

V030422 Chase

        1.  gist:  Add relevant gist 3D files to this subdirectory,
            as recommended by Michiel, and improve demo5.y (renamed 
            gistdemo3d.py). 

        2.  src/gistCmodule.c:  Fix bug reported by Michiel.

        3.  makehtml:  Fix latex2html command error redirection so it 
            also works with tcsh. 

V030410 Michiel de Hoon

        1. doc:  Add missing underscores on some functions names (3D section). 

*** Release 1.5.17 ***

V030408 Chase

        1.  setup.py:  Add extra compile option -nodtk for osf1V5; needed on
            some of these platforms (LLNL sc*).

        2.  fixPermissions_llnl:  Echo results for check.

*** Release 1.5.16 ***

V030408 Chase

        1.  gistCmodule.c:  Remove include of limits.h and unused defines;
            Replace DISPLAY_ENGINE with GpFXEngine, DISPLAY_MOUSE with
            GxPointClick, and DISPLAY_ZOOM_FACTOR with gxZoomFactor, and
            remove use NO_XLIB, and NO_MOUSE.

V030407 Michiel de Hoon

        1.  setup.py:  Add src/gist/style.c and set log verbosity.
 
        2.  gist/gist.py:  Changes to plh (plot histogram) to support
            labels.  Comment from Michiel:
          
            "The plh function does not (yet) work exactly the way Dave 
            suggested, as it drops the labels onto the plot directly instead 
            of letting the user change the limits first. The reason is that 
            it would make the plh function more difficult, requiring two steps 
            to draw a histogram, and I would think that the benefit of being 
            able to change the limits is rather small. I would prefer to see 
            some way that the text labels move automatically if the user 
            decides to change the limits. Well we can always modify plh later 
            if it turns out that users really want to do that. With the current 
            setup, however, it is still possible to change the vertical plot 
            limits, as that does not move the plot horizontally."

        3.  src/gistCmodule.c:  Add support functions get_style and
            set_style that work the same as they do in yorick.
            get_style returns a set of nested dictionaries. By changing
            the keys in this dictionary and calling set_style, one can 
            change the window style interactively.  (See the labels
            section in function plh in gist/gist.py for a sample
            usage.)  The get_style and set_style routines in gistCmodule.c
            read the style info from the corresponding structs and put 
            that information in the dicitonary and vice versa. 
            The actual changes to the plot are made in function raw_style
            in style.c (adapted from yorick).

            Also fixed the justify option for plt.

        4.  Add new files: src/gist/style.h and src/gist/style.c

            Make a note in NOTES.developer to add these two to any
            new gist directory from Munro (yorick).
 
        5.  Updated doc/control_functions.tex and doc/plot2d.tex.

V030407 Chase

        1.  LLNL changes:  llnl_install invokes fixPermissions_llnl and
            sed using sed_llnl to import a module for LLNL code-usage 
            tracking; add gist/addPyGistTracker.py.

*** Release 1.5.15 ***

V030325 Grote 

        1. src/gistCmodule.c:  Provide a way to change CGM file size 
           via pldefault.

*** Release 1.5.14 ***

V030325 Chase

        1.  src/ysite.sh:  Remove local path. (no effect)

*** Release 1.5.13 ***

V030319 Chase

        1. Fix bug in plfc (gist/gist.py) (reported by Dave Grote).

*** Release 1.5.12 ***

V030314 Chase

        1.  gist/gistdemolow.py:  Add test for plfp.

V030312 Chase

        1.  Move version and help message from extension module to gist.py.

*** Release 1.5.11 ***

V030306 Chase

        1.  gist/wxtest.py:  Example to show how to get wxPython and 
            PyGist to work together (using hints from Dave Grote).

*** Release 1.5.10 ***

V030225 Chase

        1.  Fix mouse problem reported by Dave Grote.

V030113 Michiel de Hoon 

*** Release 1.5.9 ***

V030113 Michiel de Hoon 

        1.  gistCmodule.c:  Add back a bug fix for windows (related to 
            wait_on_expose).

*** Release 1.5.8 ***

V021227 Michiel de Hoon 

        1.  Modifications for Windows/Cygwin.  Replaced use of WH_KEYBOARD hook.

        *** Version works for all Windows/Cygwin/IDLE/Tkinter combinations
            tried, including python started from the DOS prompt.

        2.  Added "plh" (histogram drawing) function to gist.py.

        3.  setup.py:  Another major change to add config step, so that 

               python setup.py config

            performs the configuration step on Cygwin, Windows, and Mac OSX.
            Due to a bug in the current python distutils, it does not yet
            work on Unix/Linux, where one still needs:

               make config 

        4.  Add PKG-INFO.

V021206 Dave Munro 
 
        1.  Further development to address issues raised in Michiel's 
            Cygwin/Windows port.  Fixed bad dependencies.
            Studied PyOSInputHook in Python and concluded that the hook
            was made for exclusive use by _tkinter.  Concluded that there are
            still a lot of problems getting gistC to interoperate with Tcl/Tk on
            *any* platform, but there are some Windows-only quick and dirty
            solutions to make it largely work.  There is one bit of 
            functionality that I believe will never work properly,
            which is timeout events (gistC pause or Tcl after). 
            Everything else ought to be possible, at least in principle.
            It would be cleaner to make it work with a PyOS_InputHook owned 
            by gistC, but the current code attempts to use the _tkinter 
            version, and would need to be heavily modified to handle idle 
            events properly.

            Changed gistCmodule.c, so that it only replaces PSOS_InputHook
            if it is not already set, and provided a pyg_unhook function to
            remove it if we want to import _tkinter after gistC. (Assumes
            that normally that if _tkinter is loaded, it is done before gistC.)
            
        2.  Made p_on_idle and p_pending_events calls explicitly available
            to python interpreter (see pyg_idler and pyg_pending). 
            Idea: Tkinter should be capable of calling these routines at 
            the appropriate times.  Under Windows, one should never need to
            call pyg_pending(), because the OS calls gist winproc automatically.
            Under Unix, one should be able to get the pending events delivered
            by means of the _tkinter.createfilehandler function.  (See the
            incomplete gist/tkgist.py for attempt at this that has partial 
            success so far.)

        3.  Added pyg_register function, a hook to set callback functions for
            p_connect/p_disconnect and for the g_on_keyline routines.   

        4.  Fixed plq function so that it will work properly under _tkinter.


*** Release 1.5.7 ***

V021125 Dave Munro 

        1.  Reworked pygist sources (gistCmodule.c, gist, play).

        This version tested ok on LC and local A-net machines
        (OSF/1, AIX, Intel Linux, Solaris). There's a minor (?) problem on 
        IRIX64 with the last test (animation); I did not notice it with
        the previous test on IRIX64 because I did not test to completion.  
        The problem exists with 1.5.6 as well.
        The animation stops mid-stream with no further interaction possible;
        cannot break out of execution and could only kill the python window.
        With multiple tries, I could also get it to stop on test 21 (image).
        The code is either hung or is somehow disconnected; top shows no
        running process.  As our SGI has not been well-maintained and is
        also going to be phased out, I am unsure it's worth pursuing this one.

*** Release 1.5.6 ***

V021119 Chase

        1.  Upgrade to yorick 1.5.13 and use interface provided by Dave
            Munro for PyOS_InputHook.

*** Release 1.5.5 ***

V021115 Michiel de Hoon

        1.  A better approach to interfacing Python and Gist.
            Give PyOS_InputHook a wrapper to u_getc(stdin), but change
            u_getc so that only Python gets the characters from stdin 
            (i.e. getc is not called). 
            
            For now, keep last approach in source; define USE_U_WAITER 
            to useit. 

*** Release 1.5.4 ***

V021114 Chase

        1.  Update STATUS section in README.

V021113 Chase

        1.  setup.py:  Build back in the option to use rl_getc_function
            instead of PyOS_InputHook, but do not use it. (for testing only)

V021111 Chase

        1.  New setup.py file (rewritten by Michiel de Hoon) to solve the
            problem of recognizing the gistCmodule.so dependency on libpyg.a. 

V021108 Chase

        1.  gistCmodule.c:  Fix some compiler warnings.

V021107 Chase

        1.  gistCmodule.c:  Fix some compiler warnings.

V021106 Chase

        1.  Add drawing function fix from Munro (see HISTORY in src).

        2.  Add fixPygistPermissions for LLNL installation.

*** Release 1.5.3 ***

V021104 Chase

        1.  Incorporate fix to input handling from Michiel de Hoon to 
            enable plots to be displayed completely on cygwin and Linux
            (alpha and Intel).  
            (see src/HISTORY directory).

            With this change: PYGIST works on Compaq OSF/1, alpha and PC
            Linux, and IBM SP AIX 5.1 (frost),
            but not IBM SP AIX 4.x (blue).

        2.  Remove INSTALL, and expand capability of setup.py to handle
            installation on all supported platforms.

*** Release 1.5.2 ***

V020913 Chase

        1.  Add script setup.py.solaris_8_s64 (which needs a hand-installed
            libreadline.so).  Able to compile and start demo, but it gives
            the same blank screens and occasional lines as blue does.

V020912 Chase

        1.  INSTALL script for LLNL installations.

V020911 Chase

        1.  Add setup.py.redhat_7a_ia32_qsw for PC Linux (pengra).	
        *** PYGIST works ok on Compaq, alpha Linux, and PC Linux.
            Still have a problem with plots not showing up on IBM SP 
            (blue,frost). Some lines show up.  When redraw requests are made,
            sometimes more of the plot is displayed. 

*** Release 1.5.1 ***

V020904 Chase

        1.  Port to Linux cluster (redhat_7_a) (fix problem in 
            src/gistCmodule.c).

        2.  Added INSTALL script for LLNL installation (uses environment
            variable SYS_TYPE.  

            INSTALL copies the appropriate setup.py.<SYS_TYPE> to setup.py
            and also does the preliminary make of libpyg.a, so that now
            to install pygist, one only needs to:

            setenv PYTHONHOME /usr/gapps/python/redhat_7_a/opt  (for LX cluster)
            INSTALL

*** Release 1.5 ***

V020221 Chase

        1.  Also on AIX (blue), it does not pick up libreadline.a and
            its dependent libcur.a automatically.  Add these two as
            comments to setup.py, and instruct user to uncomment them
            when doing an installation on AIX.

V020215 Chase

        1.  Add information to README on how to fix the compilation 
            problem on AIX.  AIX handles shared files differently; 
            additional tools were needed, but the links to these 
            tools were incorrect in the Python installation.

            For example:

            cd /g/g16/chase/aix/lib/python2.1
            rm makexp_aix
            ln -s config/makexp_aix makexp_aix
            rm python.exp
            ln -s config/python.exp python.exp

V020212 Chase

        1.  Add RELEASE and release.msg (release notice and id).

V011217 Chase

        1.  Fix src/README comments for installation.

V011206 Chase

        1.  setup.py:  Replace hardwired path for Numeric include directory.

V011029 Chase

        1.  Get a new configure from Dave (to correct NO_EXP10 problem).

V011028 Chase

        1.  Replace makethis.py, installthis.py, compile.py, and 
            installtool.py with setup.py, which uses the standard distutils 
            installation process.

            *** Still need to make libpyg.a with process set up by Dave
                in the src directory.

V011026 Chase

        1.  Symptom:  exp10 missing.  

            Configure:
               configure /g/g16/chase/OSF1
            Edit the Make.cfg file produced to add -DNO_EXP10,
            needed in gist directory to indicate that exp10 does not
            exist on this platform.

V011024 Chase

        1.  Got another version from Dave Munro.
        2.  Makepyg:  Change include file to ${SYS_TYPE} or tru64_4 python 
            include.  See log message below.

r r ../libpyg.a gist.o tick.o tick60.o engine.o gtext.o draw.o draw0.o clip.o  gread.o gcntr.o hlevel.o ps.o cgm.o xfancy.o xbasic.o
gcc  -O -DNO_EXP10 -I. -I../play -I. -I/usr/gapps/python/src/Python-2.1/Include -I/usr/gapps/python/src/Numeric-20.0.0/Include/Numeric -Igist -Iplay -c gistCmodule.c
In file included from /usr/gapps/python/src/Python-2.1/Include/Python.h:54,
                 from gistCmodule.c:75:
/usr/gapps/python/src/Python-2.1/Include/pyport.h:422: #error "LONG_BIT definition appears wrong for platform (bad gcc/glibc config?)."
gistCmodule.c:91: warning: `PyFPE_END_PROTECT' redefined
/usr/gapps/python/src/Python-2.1/Include/pyfpe.h:169: warning: this is the location of the previous definition

V011019 Chase

   This version of Graphics came from ftp-icf.llnl.gov:OLD 
   public distribution LLNLDistribution11.
   The package is is outdated, depending on Numerical instead of Numeric,
   gist1.4 instead of 1.5, in fact the gistCmodule.c is actually circa 1.3
   and needs to be upgraded to yorick 1.5's Graphics.c.

   Focus just on getting Graphics/Gist up and operational for now.
   There are other graphics packages (Gist3D, Narcisse, ...) under Graphics.