		TkGate 1.8.7 Release notes.

*****************************************************************************
INSTALLATION

To install tkgate follow the steps below:

0) Obtain and install tcl/tk 8.3 or later (versions 8.0-8.2 may work but are
   not tested.)

1) cd to the directory in which you unpacked this distribution.

2) Run the configuration script:

      ./configure

   The script will run a series of tests to discover properties of your
   environment and edit the config.h file.  The specific properties that
   are tested are:

    * O/S:				(FreeBSD, SunOS, Linux, other) 
    * Compiler:				(gcc or cc)
    * Tcl/Tk Version:			(8.3 or 8.4)
    * Language support:			(Japanese/English or English/Eurpoean)
    * Grammar compiler:			(bison or yacc)
    * Lexical analyizer:		(flex or lex)
    * Test for required libs:		(-X11)
    * Test for system-dependent libs:	(-xpg4, -ldl, -lsocket, -lnsl, -lm)
    * Test for long long:		("1" or "0")
    * Test for optreset requirement:	("1" or "0")
    * Check OS name to determine
         signal() semantics:		(handler disabled/reenabled on catch)

   The following actions are performed:
    * config.h is edited to reflect the results of the tests above.
    * Top-level makefile is built using xmkmf 
    * Subdirectory (src/common, src/tkgate, src/gsim, src/gmac) makefiles are built using xmkmf 
    * Include file links are built
    * Dependencies are built.

   Normally the configuration will take place fully automatically , but if
   some components such as tcl/tk are in non-standard locations you may need
   to edit config.h and add the required directories to TKGATE_INCDIRS and
   TKGATE_LIBDIRS.

3) Edit the file config.h to change the install directory locations if
   necessary.  By default, executables will be installed in
   "/usr/X11R6/bin", man pages in "/usr/X11R6/man/man1", and library
   files in "/usr/X11R6/lib/tkgate-1.6g".  Do not edit any of the lines
   between the BEGIN-AUTO and END-AUTO lines as these will be
   automatically generated by the configure script.

4) Edit the file "sitename.txt" to specify the name for the site.  This name
   will appear on traces and circuit diagrams printed by TkGate.  The default
   name is "Earth" (probably correct for most users, but maybe a little unspecific).
   Users can also override the site name by editing their preferences.

5) Compile TkGate using the command:

      make

6) Install TkGate using the commands:

      make install
      make install.man

   If you don't have write access to the install directories, you can also
   run TkGate from the compilation directory which is used as a secondary
   home directory.  You can also explicitly set the home directory by setting
   the enviornment variable TKGATE_HOME.  The executable for tkgate will be
   in src/tkgate/tkgate.

7) (optional) Set the protection on the file "tkgate-error.log" in the tkgate
   home directory to be publicly writable.  TkGate makes internal consistency
   checks and logs any problems to this file (these are potential problems with
   TkGate, not with the circuit being edited).  If the file is unwritable, errors
   will be logged to the file of the same name in the current directory.  Normally
   this file should have few or no entries.

*****************************************************************************
SAVE FILE DIFFERENCES

1.8.6 and earlier
   These versions have fixed order of data lines on muxes/demuxs and a fixed
   side on which the selector can be placed.

1.6h and earlier
   These versions do not support the "extender bar" style of basic gates.  Files
   saved by later versions may either not load properly, or may have input wires
   in odd places when loaded under old versions of tkgate.

1.5c and earlier
   Positions of wire "tap" elements have changed slightly due to the new method
   for drawing buses.  When reading old files, the positions will be slightly
   modified to fit the new scheme, but if you save the file, wire positions will
   be slightly off when rereading from an old version of tkgate.

   Basic flip-flop elements do not exist in this version and lower.
   
1.4c and earlier
   Multi-technology delay specification, and per-gate delay specification is
   not supported.  If any delays other than "default" are used, the file may
   not be readable by older versions of tkgate.

*****************************************************************************
CHANGES 

Version 1.8.7 - January 29, 2007
     * Fixed bug causing ROM outputs to be considered non-tristate.
     * Added support for rotation of selected gates.
     * Added support for changing ordering of wires on muxes/demuxes.
     * Added support for mirror-image flip-flops.
     * Updated some of the dialog boxes

Version 1.8.6 - April 29, 2005
     * Fixed bug causing potential self-transitions on register outputs.
     * Fixed bug in searching for auxilary files used by the simulator.
     * Updates to German and Italian locales.
     * Added support for Polish (still needs updates).

Version 1.8.5 - September 7, 2004
     * Drag-and-drop module creation (drag from module list and drop on canvas).
     * Fixed bugs with shift devices.
     * Fixed bug causing tkgate to crash when printing designs having instances
       of undefined modules.
     * Added support for Czech.

Version 1.8.4 - June 14, 2004
     * Added memory of probes between invocations of the simulator.
     * Improved command-line printing capabilities.
     * Fixed a bug that resulted in a compilation error when compiling under
	a gcc version less than 3.0.
     * Fixed a bug that caused spurious warnings when printing a circuit
	directly from the command line.
     * Fixed another problem with EPSF output.
     * Fixed a bug with the critical path analysis of an empty circuit.
     * Fixed coding problem with Japanese messages file.
     * Fixed bug causing potential simulator core dump in critical path
	computation.

Version 1.8.3 - March 18, 2004
     * Fixed a bug occuring when creating or editing a comment after editing
       the ports on another circuit element.
     * Modules now printed in "hierarchical" order.
     * Updated German support and reorganized localization files.
     * Configure script now looks for MAC OS X directories.
     * Configure script is now more cygwin friendly.
     * Empty comments are no longer invisible.

Version 1.8.2 - February 12 , 2004
     * Fixed bug when loading library from command line.
     * Fixed bug when printing selected modules.
     * Fixed bug with '-V' circuit verify command. 
     * Fixed bug in Edit menu with Algn Vert. and Algn Horz. being swapped.
     * Fixed bug with cut/paste of concat elements at 90/270 degree orientations.
     * Fixed bug with undo of wire taps.
     * Fixed bug with simulator error reporting.

Version 1.8.1 - January 19, 2004
     * Fixed bug occurring when clocks are used to drive adders.
     * Fixed bug with printing of partial scope traces.
     * Fixed bug in undo from edit module interface screen.
     * Added toolbar on scope window.
     * Added a "crosshair" feature to scopes.
     * Added a right-click selection capability on scopes for selecting print range.
     * Added capability to suppress sorting of traces on scope.

Version 1.8 - January 7, 2004
     * Fixed multiple bugs in the undo/redo code.
     * Updated toolbar icons and changed the behavior of the toolbar to be context sensitve.
     * Fixed compatability problems with tcl/tk 8.4.
     * Fixed printing problem with wire merge elements.
     * Fixed problem with very long clock cycle times.
     * Fixed problem with EPSF output.

Version 1.7 - February 5, 2002
      * Added multi-undo/-redo function.
      * Current technology of gates are now visible through popup menu.
      * Fixed bug allowing changes to anchor flag of gates in library modules.
      * Fixed bug occuring when doing "Edit Interfaces..." while currently
	editing a library module.

Version 1.6i - February 5, 2002
      * Added extender bars on multi-input (more than 2) AND, OR and XOR
	gates to avoid "crunching" of wires for gates with many inputs.
	This feature is off by default when loading save files for earlier
	versions of tkgate unless explicitly enabled.
      * Fixed problem with using some right mouse button popup commands
	when zoomed.
      * Increased delay between a mouse press and hold on a signal and the
	pop-up showing the signal value while in simulation mode.  The previous
	short delay interfered with detection of a double click on some systems
	and thus made it difficult to set probes.  It now also possible to
	customize this delay through the simulator page on options dialogue box.
      * Disabled bug allowing net options to be modified while in simulator mode.
      * Added alternate probe set/remove command using 'P' keyboard shortcut
	or menu.
      * Initial support for "hierarchy graph" for Postscript output added.  This
	support is currently limited to graphs that fit on a single page.
      * Fixed several bugs that could sometimes cause a core dump and/or
	save file corruption when manipulating "wire tap" elements.
      * Fixed bug that sometimes resulted in a failure to determine the direction
	of concat (wire merge) elements.
      * Fixed a bug that caused calloc() to be called with nmemb=0.
      * Marked various popups as transient so they would not get buried under
	the main window.
      * Changed port add/editing so that an "*unnamed*" signal will be assigned
	a standard generated name.
      * Fixed bugs with port on editing through properties dialog box on modules.
      * Fixed problem with panic save feature.  The panic save feature causes
	tkgate to attempt to save the current circuit in PANIC.v if a core dump
	is detected.
      * Produces less confusing messages when running under an unsupported locale.

Version 1.6h - June 11, 2001
      * Fixed printing problems with dips, muxes and registers.
      * Fixed Japanese in menus and tutorials.
      * Added bit selection feature for register codes to gmac.
      * Made '\r' a valid whitespace character.
      * Fixed bug that allowed creation of meaningless inverters on wire taps.
      * Fixed core dump bug with "replicating" wire taps.
      * Fixed serious problem with cut/paste causing internal data structures
	and save file data to become corrupt.  The problem occured when gates
	attached to the same net were included in the cut, but one or more of
	the joints/taps on the net were not included in the cut causing a
	partitioning of the net.
      * Added a data structure integrity check feature.

Version 1.6g - February 6, 2001
      * Added zoom in/out feature.
      * Fixed core dump caused by start-up time errors on some platforms.
      * Fixed core dump caused by loading out-dated tkgate file while flashing
        critical path option is enabled.
      * Improved commenting of macrocode in "menagerie" example.
      * Minor change to scrollbar semantics

Version 1.6f - November 30, 2000
      * Fixed incorrect installation of Japanese tutorials.
      * Japanese Translation of tutorials partially completed.
      * Added support for Spanish.
      * Fixed problem with dialog windows being lowered when opening
        a subordinate load/save file box.
      * Fixed problem with setting label on frames.

Version 1.6e - November 16, 2000
      * Fixed problem with memories with less than 8-bit data lines. 
      * Fixed possible direction problem with wire merge.

Version 1.6d - October 19, 2000
      * Fixed carry-out on 32-bit adders
      * Postscript generator now uses latin1 encoding to enable correct
	printing of accented characters.
      * Dip switch "value" boxes are now closed when exiting the simulation.	
      * Fixed Japanese configure problem.

Version 1.6c - October 16, 2000
      * Improved multi-lingual support.
      * Added French support.

Version 1.6b - October 4, 2000
      * Fixed possible core dump problem when deleting gates.
      * Fixed configuration script problems.

Version 1.6 - September 27, 2000
      * Experimental support for critical path analysis
      * Highlighting of selected net
      * Smooth scrolling in edit window
      * Added a seprated "D flip-flop" element.
      * -P and -p switch allow printing without starting the GUI.
      * Fixed problem with non-functional output inverters on several gate types
	including registers, rams, roms and ttys.
      * Fixed hang problem with simulator when root module not at top of module stack. 
      * Fixes problem with adding outputs to decoders. 
      * Fixes extraneous "unknown version" messages when loading old save files. 
      * Fixes problem with externally generated "destroy" events on scope windows.

Version 1.5c - September 8, 2000
      * Fixes an intermittent core dump problem in editor when manipulating wires. 
      * Fixes problem with inverters in postscript output. 
      * Fixes problem with configuration file in detecting existance of bison. 

Version 1.5b - June 27, 2000

      * Fixes core dump problem in simulator.

      * Fixes possible core dump in editor when exiting simulator.

Version 1.5 - June 26, 2000
      * Support for multiple gate 'technologies' and per-gate delay
	specification added.

      * Menu and shortcut internals updated.  Shortcuts and menus for gate
	definitions now contained in the gate definition files.  This is a
	precursor to supporting user-definiable primitives.  The new shortcut
	definition method allows keyboard shortcuts to be defined in .tkgaterc
	file.

      * Better recovery from syntax errors in input files.

      * Accedental editing of library modules disabled.  An explicit "Claim"
        command was added to convert library modules to user modules.

      * Bug fixes
           - fixed slopy gate label positions

           - fixed slopy delete of mux/demux 

           - fixed position of input numbers on mux/demux

           - fixed corruption of internal data structures when doing a
	     cut/paste in Edit Interface page

           - fixed core dump when opeing "Edit Interfaces" while simulation was
             active (now disabled while in simulation mode).

           - fixed possible save file corruption due to null net names.

           - fixed multiple module instances on the Edit Interfaces page.

           - fixed erroneous setting of 'modified' flag when opening Edit
	     Interfaces page.

	   - fixed memory initialization problem in gsim causing periodic
	     simulator crashes.

           - moved "Circuit Properties" command from "Module" menu to "Edit" menu.     

      * NOTE: Save files from tkgate 1.5 may not be readable under earlier
        versions of tkgate if you use the new delay specification features.

Version 1.4c - June 12, 2000
      * Fixed Postscript output and bit tap problems (Applied patch tkgate-1.4b.patch1) 

      * Added Postscript output of Japanese (works for printers with Japanese fonts only). 

      * Made ports on modules easier to select. 

      * Fixed problem with changing port type in external port dialog box. 

Version 1.4b - June 7, 2000
      * Fixed the library module problem (applied tkgate-1.4.patch1)

      * Fixed problems with Japanese input

      * Created a seperate directory for Japanese tutorials.  Selection of the
        tutorial directory depends on the selected interface language. Currently
        only a small portion of the tutorial have been translated. 

Version 1.4 - June 2, 2000
      * Added LED devices (single bit, bar graph, 7-segment)

      * Added context sensitive popup menus (bound to right mouse button)

      * Added "add wire segment" feature to attach new wire segments in
        the middle of existing wires.

      * Bug fix (Simulator crashed when circuit contained anchored modules)

      * Bug fix (States of switches in modules sometimes not shown properly
        when there are multiples instances of that module)

      * Bug fix (Various objects still created with default name even
        when hitting 'cancel' in dialog box).

      * Bug fix (Y2K problem in Postscript output)

      * Bug fix (Connecting wires of different bit widths caused core dump)

Verion 1.3b - May 4, 2000
      * Fixed minor problem with compiling in some versions of Linux

      * Improved commenting in the Menagerie CPU example.

      * Fixed bug in editing comments (comment not saved when closing dialog box
	by hitting return in hyperlink entry box).

Verion 1.3 - April 20, 2000
      * Microcode/macrocode compiler (gmac) now generates a human readable symbol map.

      * Better delay model

      * Multi-lignual features added (English and Japanese)

      * Hyperlink comments

      * Improved tutorial (using hyperlinks)

      * Added 'zoom' command to simulator script to set zoom factor on scope.

Version 1.2b - April 13, 2000
      * Fixed problems with SunOS 5.7

Version 1.2 - April 13, 2000
      * Hit test for gates no works better for long thin gates such as registers

      * Problem with deleting ports on primitive gates fixed

      * Horizontal/Vertical alignment feature added (see "Edit" menu)

Version 1.1 - March 31, 2000
      * Color interface implemented. 

      * Smooth scrolling in scope implemented. 

      * Fixed bugs under Solaris (SunOS 5.5) 

      * Fixed verious other bugs. 

Version 1.0 - March 22, 2000
      * Fixed bugs. 

Version 0.9 - May 28, 1999
      * Initial public release. 

*****************************************************************************
USING LATER VERSIONS OF TCL/TK

  TkGate will search the list TKGATE_TCLTK_VERSIONS defined in config.h for
  the first properly installed version of tcl and tk.  To add additional later
  versions, simply add them to the beginning of the list.  Japanese versions
  of tcl/tk should be added to the list TKGATE_JP_TCLTK_VERSIONS.  If
  TKGATE_LANG is set to "jp", these versions will be tried first.

*****************************************************************************
NON STANDARD TCL/TK LOCATIONS

  TkGate requires at least tcl/tk 8.0 to compile and run.  It will not compile
  with earlier versions, so make sure you have the right version.

  In a "standard" tcl/tk installation, files are in the following locations:

	Tcl include files in:		/usr/local/include/tcl8.0
	Tk include files in:		/usr/local/include/tk8.0
	Tcl library files:		/usr/local/lib/libtcl80.a or /usr/local/lib/libtcl8.0.a
	Tk library files:		/usr/local/lib/libtk80.a or /usr/local/lib/libtk8.0.a
	Tcl script files:		/usr/local/lib/tcl8.0
	Tk script files:		/usr/local/lib/tk8.0

   The include and library files are required to compile and link tkgate.
   If your Tcl/Tk installation is not in the location above, you may have
   to manually set some of the the configuration options.  To do this, make
   the following changes to "config.h":

     * Look for the definition of "TKGATE_INCDIRS".  Add the directories where
     tcl and tk include files can be found.  Be careful to add these to the
     beginning of the list in case header files for earlier versions
     of tcl/tk are in the listed directories.

     * Look for the definition of "TKGATE_LIBDIRS".  Add the directories where
     tcl and tk library files can be found.

   Now try running the "configure" script.  "configure" will attempt to find the
   additional tcl/tk script files based on the include file directories.   If it
   is still unable to find them, warning messages will be printed at the end.
   Follow the steps for MANUAL CONFIGURATION and explicitly set the variables
   TCL_LIBRARY and TK_LIBRARY.  These should point to the directories for the tcl
   and tk initialization script files.  The tcl script directory should include
   a file named "init.tcl" and the tk script directory should include a file
   names "button.tcl".  

   PITFALLS:

   Make sure the list of include directories in the TKGATE_IPATH variable
   in config.h (after running the configure script) includes directories
   in the correct order.  If an old version of tcl.h or tk.h is in a
   directory earlier in the list than the correct version, tkgate will
   not compile.


*****************************************************************************
MULTI-LINGUAL SUPPORT (JAPANESE)

To compile tkgate with Japanese support you will need the Japanese
version of tcl/tk version 8.0 or later.  Next edit "config.h" and set
the value of "TKGATE_LANG" to "jp".  If everything goes well, you can
simply configure and install the system as usual, otherwise you may
need to manually configure (see the next section).

If you have compiled tkgate with Japanese support, you can enable the
support by setting the LANG environment variable to a valid locality
value, for example 'ja_JP.EUC' for Japanese, and 'ASCII' for English.
You can also specify the locality with the -L switch.  Attempting to
run TkGate with an invalid locality value could cause it to core dump
in the tcl/tk initialization routines.  You must also set up kanji
conversion and input servers in order to input Japanese.  Currently,
Japanese is only supported in comments and "frames".

There are many ways of configuring kanji conversion and input servers,
so I will not go into all of them here.  I have tested tkgate with
wnn4/jserver as the conversion server and kinput2 as the input server.
I started jserver from rc.local, executed kinput2 from my .xinitrc
using the command:

   kinput2 -wnn -jserver localhost&

edited my .Xresources file to contain the line:

   *inputMethod: kinput2

and my .cshrc file to contain the line:

   setenv XMODIFIERS "@im=kinput2"

To enter switch between English input and Japanese input use the
command <shift-space>.  To convert a kana string use the command
<control-J>.

*****************************************************************************
MANUAL CONFIGURATION

If the configuration script fails to run for some reason, you can manually
configure the system by uncommenting the defines in the "override parameters"
section of config.h.  Set each of these to the correct value and run the
configure script as:

   ./configure -notests

Then, make and install as usual.

*****************************************************************************
TROUBLESHOOTING

- Compiler errors with Tcl/Tk components.
- Link errors with Tcl/Tk components.
- TkGate compiles and runs, menus and buttons don't work.
   See the secion NON STANDARD TCL/TK LOCATIONS

- Compiler warnings in luthor.
   In some versions of flex, the generated code does not pass gcc with all warnings
   enabled (-Wall). These warnings can be safely ignored.

- Configuration script fails to run.
   See the section on MANUAL CONFIGURATION  

- Got "Unknown language" error.
   Make sure you have set TKGATE_LANG in config.h to either "jp" or "en".  The
   value should be unquoted.  If you still get errors, it is possible the code
   to extract this information is not working on your system.  You can bypass
   the language extraction code by replacing the body of "findlang" in the file
   "configure" with a simple assignment of the variable "lang" to one of the
   two values.

*****************************************************************************
RELEASE CHECKLIST

The items below should be completed before doing a release.  Note
these items should be consider a minimum checklist and this checklist
should be performed after testing.

1) Update version number and release data
   a) Set TKGATE_VERSION in config.h
   b) Verify TKGATE_MAILCONTACT, TKGATE_HOMEPAGE, TKGATE_COPYRIGHT values.
   c) Update version notices in documentation (if major release).
   d) Update change notes in README file, verify release date is correct.

2) Verify that Japanese interface is working
   a) Set TKGATE_LANG to "ujp" the configure and compile it.
   b) Make sure Japanese interface runs without errors and that
	there are no untranslated message tags.

3) Do final sanity checking
   a) Set TKGATE_LANG to "en" the configure and compile it.
   b) Make sure there are no undefined message tags.
   c) Load the "menagerie" circuit and run simulator.
   d) Place and remove probes in simulator.
   e) Print circuit to postscript file and verify that file is correct.
   f) Use editing features on the menagerie circuit (including cut/paste).
   g) Do a "new", create a simple circuit and save it to a file.
   h) Make sure non-English Western languages display properly.

4) Do final preparation
   a) Verify TKGATE_LANG is set to "auto"
   b) Unset personal LANG environment variable
   c) Verify TKGATE_GCCFLAGS is set to "-O"
   d) Run the configure script
   e) Do a "make release"
   f) Do a "make" to verify a clean compile.
   g) Do a "make cleanclean"
   h) Check for and remove any extraneous files.
   i) Create .tgz file of release

5) Release
   a) Update tkgate homepage with release notice.
   b) Create updated locale distrbutions (tkgate-ja.tgz, etc.)
   c) Move distribution file to public directory.
   d) Move locale distributions to public directory.
   e) Upload new tkgate homepage.

*****************************************************************************
CREDITS

  * Thanks to Marc Lavallee for Linux rpm spec file.
  * Thanks to Peter Bartke for the German translation.
  * Thanks to Laurent Bonnaud for the French translation.
  * Thanks to Agustin Borrego for the Spanish translation.
  * Thanks to Kevin Donnelly for the Welsh translation.
  * Thanks to Jacques JANVILLE for the French translation and French tutorials.
  * Thanks to Marc Lavallee for Linux rpm spec file.
  * Thanks to Roman Valls for the Catalan translation.
  * Thanks to Anthony Winstanley for the cygwin patch. 
