The version number is 5.0.0

What works - what doesn't
=========================

This version can tokenize, load and run TxBASIC programs on any Tattletale
loaded with TxBASIC 4.10 and above. The editor and terminal emulator should
be fully functional. The datafile off-load command works. ReMind works as
well as the View Variables function. The serial port set-up screen allows
setting all the serial port parameters now.

Scrolling back through the terminal window buffer can seem a bit strange
at first. You can scroll back by either hitting the Up Arrow key or by
clicking in the terminal window "Scroll off" box (which will change to
"Scroll on"). A scroll bar will appear on the right of the terminal window.
You can scroll back and forth using the mouse on the scroll bar or by using
the Up Arrow and Down Arrow keys.

Although characters coming into the COM port will be saved in a buffer, they
will not be displayed until scrolling is turned off. This can be done by
either hitting the Return key or clicking in the terminal window "Scroll on"
box (which will change to "Scroll off"). Remember - the terminal window will
not accept new characters until scrolling is off. If scrolling stays on for
an extended time, characters may be lost when the buffer overflows.

This version cannot modify variables on your Tattletale from TxTools (used by
all Tattletales except the Model 8) but you can view variables on your
Tattletale. Modifying variables will be added at a future date.


When you find problems
======================
Please send all bug reports and requests for features to:

Jim Dodd
Onset Computer Corp.
jim_dodd@onsetcomp.com


Installing TxTools for Windows
==============================

Simply run the program. TxTools will check the Windows Registry and will not find
an entry for itself. It will display a list of available COM ports and ask you
to choose one. This port number (along will a long list of parameters) will be
saved in the Registry when you exit TxTools. To uninstall TxTools, run RegEdit.exe
and delete the key "TxTools" under the heading "Onset Computer Corporation" in
the "Software" heading under the "HKEY_CURRENT_USER" root key. At this point,
the following items are saved in the registry. This will change in future versions
of the application.

HKEY_CURRENT_USER
   |
   Software
      |
      Onset Computer Corporation
         |
         TxTools
            |
			Program
				Version			Int		Version number of TxTools
				OpenDir			String	Start directory for Open dialog
				SaveAsDir		String	Start directory for Save As dialog
				OffloadDir		String	Start directory for Offload dialog
				NumMRU			Int		How many Most Recently Used files follow
				MRUFile00		String	Most recently used file followed by others
				MRUFilexx		String	Less recently used files
				Autoindent		Bool	True if editor autoindents text
				TabSize			Int		Tab size in characters. Must > 0 and < 255
				FileExAction	Int		Suggested action if saving to existing file
			|
			Window
				Maximized		Bool	True if main window is maximized
				Left			Int		Non-maximized left side of main window
				Top				Int		Non-maximized top side of main window
				Width			Int		Non-maximized width of main window
				Height			Int		Non-maximized height of main window
			|
			Terminal
				Maximized		Bool	True if terminal is maximized
				Left			Int		Non-maximized left side of terminal window
				Top				Int		Non-maximized top side of terminal window
				Width			Int 	Non-maximized width of terminal window
				Height			Int 	Non-maximized height of terminal window
				Columns			Int		Number of characters displayed in a text line
				Rows			Int		Number of rows of displayed text
				Capture file	String	Path and name of default capture file
				Capture append	Bool	True if in append mode, false if in overwrite
				TabSize			Int		Tab size in characters. Must > 0 and < 255
			|
			Ports
				Baud			String	Serial port baud rate
				ComNum			String	Serial port com port number must be 1 or greater
                DataBits        String  Serial port data bits (7 or 8)
                StopBits        String  Serial port stop bits (1 or 2)
                Parity          String  Serial port parity (Even, Odd or None)
                Handshake       String  Serial port handshaking (None or XON/XOFF)
			|
			Transfer
				TermType		Int		ASCII recv terminate, 0=char, 1=time-out, 2=cancel
				TermChar		String	Character that terminates ASCII receive
				TermTimeout		Int		Seconds of inactivity that terminates ASCII receive
				Prefix			String	String sent before sending ASCII file
				Suffix			String	String sent after sending ASCII file
				CharDelay		Int		Delay between send ASCII file characters (millisec)
				LineDelay		Int		Delay between send ASCII file lines (millisec)
			|
			Find
				StartAtTop		Bool	True if first find starts at top of document
				WrapAround		Bool	True if search wraps to top when end found
				SelectedText	Bool	True if search only selected text (if any)
				WholeWords		Bool	True to search for only whole words
				CaseSensitive	Bool	True to perform case sensitive search
				PromptOnReplace	Bool	True to prompt each replace operation
				ReplaceAll		Bool	True to replace all instances of find string
				NumFindStrings	Int		How many Most Recently Used find strings follow
				FindString00	String	Most recently used find string
				FindStringxx	String	Less recently used find strings
				NumReplStrings	Int		How many Most Recently Used replace strings follow
				ReplaceString00	String	Most recently used replace string
				ReplaceStringxx	String	Less recently used replace strings
			|
			Compile
				ConfirmConnect	Bool	True if app should wait for Tattletale response
				EmbedLineNum	Bool	True to put line number tokens in object file
				CreateListFile	Bool	True to create a separate List file
				CreateBinFile	Bool	True to create a separate binary copy of object file
				CreateSymFile	Bool	True to create a separate Symbol Table file
				CaseInsenSym	Bool	True to use case insensitive compare for all symbols
				MaxLabels		Int		Maximum number of symbols (variables + labels)
				MaxAsmLines		Int		Maximum number of assembler source lines

What changed with version 5.0.0
- Only the version number!

What changed with version 4.14.14
- The "Save all" selection under "File" now works.

What changed with version 4.14.13
- The Help file is now available with the "Help | TxBASIC summary..." menu selection.
  The file used for this help is a standard Windows Help file named TxTools.hlp and
  can be used independently from the TxTools application. This is just a rough first
  pass at the help file. We hope to improve it soon.

- The Print selection of the File dialog now allows more options and correctly
  handles the options it allowed before. You can now optionally select a range of
  pages to print (instead of printing the entire document). You can now optionally
  print multiple copies of a document and optionally collate the pages. TxTools
  now corectly handles printing selections that span pages on the printer.

What changed with version 4.14.12
- On first installing TxTools and selecting a serial COM port, it was possible to
  later exit TxTools and have this information not be stored in the Windows Registry.
  This meant that the next time TxTools started, no COM port would be selected and
  all menu items (except those involved in selecting a COM port) would be disabled.
  This has been corrected and installing TxTools will save the COM port information
  when you first set it up.

- Sometimes, when receiving an XMODEM file, TxTools would force a TXB extension on
  the new file. Now this should never happen.

- When the ASCII Transfer Options dialog was closed, an empty error message box
  would appear. Nevermore (apologies to Mr. Poe).

- If the process of starting Capture to File for the Terminal window was canceled,
  Capture to File mode would be enabled anyway. Now it remains disabled.

- A clarification - When you open a program file, save a program file or off-load
  a datafile, the initial directory displayed in the file dialog box comes from
  a value that is saved in the Windows Registry. There is a separate entry for each
  of the three situations (open program, save program, off-load datafile) and it
  is updated to the directory of the last file that was selected by the dialog.
  When you first install TxTools, all three directories are initialized to the
  directory where TxTools.exe is located. If you immediately open a program file
  in a different directory, that different directory becomes the default the next
  time you go to open a program file. The save program and off-load datafile
  default directories will not be changed until you use those dialogs. Is that
  more clear or more confusing? If you have comments on this, contact Jim Dodd
  at: jim_dodd@onsetcomp.com
  
What changed with version 4.14.9
- The option to embed line number information in the final TxBASIC executable file
  was being ignored. Line numbers were ALWAYS being embedded in the program making
  the program larger by three bytes for every line of your program. Now, you can
  choose if you want the line numbers (a HOW? error will give the line number where
  the error occurred) or not (saving program space) from the
  "Tattletale| Compiler options..." dialog. The checkbox is labeled
  "Embed line numbers". Unchecking this will reduce your program size.
  
- A new option is available for the "Tile" selection of the "Window" menu. Tile now has
  a sub-menu to allow tiling the windows horizontally or vertically.
  
- A new command is available under the CommPort menu. You can now choose "Clear terminal"
  to clear all the text in the terminal window. This includes text in the scroll-back
  (non-visible) part of the terminal window. There is also a new "button" labeled "Clear"
  in the status bar at the bottom of the Terminal window. This acts just like you selected
  CommPort | Clear terminal.

What changed with version 4.14.8
- Another bug was fixed in the Replace function. If "Start at top", "Replace All" and
  "Prompt On Replace" were selected, after finding the first instance, the second search
  would start at the top of the document again - subsequent searches would be handled
  correctly. Now, Replace works as it should.


What changed with version 4.14.7
- All the normal serial port parameters can be viewed and changed with the port settings
  dialog. This includes baud rate, port number, data bits, stop bits, parity and
  handshaking.

- All of these serial port parameters are stored in the Windows Registry when TxTools exits
  and are restored when the program starts the next time. The Registry list (above) has
  been updated. Notice that baud rate and port number used to be stored as integers under
  different names. When you first run this version, TxTools attempts to read the old
  settings, update the new settings to those values and remove the old Registry values.
  If you get an error on start-up, use the Alt-P (Port set-up) shortcut or choose
  "Port setup..." under the CommPort menu to set up the serial port correctly.

- A bug was found in the Most Recently Used file list that would, rarely, allow
  multiple copies of the same file to show up in the list. Also, in announcing this feature,
  the explanation failed to mention that the full path to the file can be found in the
  status bar at the bottom of the TxTools main window. Just let the mouse hover over the
  file name in the Most Recently Used list and its full path name will show up in the
  status bar.

- Another bug in the Most Recently Used file list was found and fixed. This involved
  files opened from a network. Now, the path to these files should be handled correctly.

- The list file and symbol table file no longer produce a blank line between every line
  of text.

- Shortcut keys were added for the File|Open and File|Save menu items. In the DOS
  version of TxTools, Function Key 3 (F3) could be used as a shortcut for Open and
  Function Key 2 (F2) could be used as a shortcut for Save. Unfortunately, many
  Windows programs use F3 for the Find Again function (as we have in TxTools for
  Windows). Therefore, we've changed the shortcut for File|Open to F4 - Function
  Key 4. The shortcut for File|Save is F2, as in the DOS version of TxTools.
  Please accept our apologies for trying to change your habits.

- The ReMind EPROM function (under the Tattletale menu) now works.

- The View Variables function (under the Tattletale menu) now works. To get the data for
  a specific variable, just click (once is enough) in the Data column for that variable.
  To get the data for all variables, use the "All data" button at the bottom of the dialog.
  To get a different symbol table, use the "Open" button. To change the format of the
  addresses for the variables, click in the "Address..." heading box. You can toggle
  between hexadecimal (the default) and decimal. The default format for floating point data
  is fixed point format. You can toggle between this and scientific format by clicking in
  the "Data..." heading box. Floating point values larger than 1.0e7 or less than 1.0e-6
  are forced to be in scientific notation.

- A bug was fixed in the Replace function. If "Replace All" and "Prompt On Replace"
  were selected, you would continue to be prompted about replacing the selection after the
  last selection was finished even though there was no selection. The only way out of this
  was to cancel the action. Now, Replace works as it should.

- New filters are available in the Open File Dialog box. There is now a filter for:
  TxBASIC programs - *.TXB (this has always been available)
  TxBASIC list files - *.LST
  TxBASIC symbol tables - *.SYM
  Any TxBASIC file - *.TXB, *.LST, *.SYM
  Any file - *.* (this has always been available)


What changed with version 4.14.6
- A bug was fixed in the compiler. If the MODEL command was not used to specify a Tattletale
  model, TxTools would complain about an unknown model number. Now, unless certain commands
  demand it, the MODEL command is not necessary.
- The Replace function under the Search menu works now.
- The Find Again function under the Search menu now works for both Find and Replace.
  Normally, it will find the next occurrence of the find string in the editor. If the last
  operation was a replace, though, Find Next will replace the current selection and find
  the next occurrence of the find string.
- The Send File ASCII function (under the CommPort menu) is now implemented.
- The Receive File ASCII function (under the CommPort menu) is now implemented.
- There is a new dialog for setting options for the Send File ASCII and Receive File ASCII
  functions. The dialog is accessed through a menu item labeled "ASCII transfer options..."
  under the CommPort menu.

  ASCII Receive - Select how an ASCII receive will terminate.

                  Selecting the first radio button, Character, will stop storing data to
                  the file when a specified character is received. The terminating character
                  will not be included in the disk file. You can enter the character in the
                  edit box to right. Any printable character is specified by simply typing
                  the character in the edit box.

                  Certain control codes can be entered by using the escape character before
                  a letter. These control characters are allowed:

                   \a     BEL    alarm, the bell character     07H
                   \b     BS     backspace character           08H
                   \f     FF     formfeed character            0CH
                   \n     LF     newline (linefeed) character  0AH
                   \r     CR     carriage return character     0DH
                   \t     HT     horizontal tab character      09H
                   \v     VT     vertical tab character        0BH
                   \"            double quote character        22H
                   \'            single quote character        27H
                   \\            backslash character           5CH

                  Finally, any character from 00 to FF hex can be specified by using
                  \xhh where '\' and 'x' are the literal characters and 'hh' is two
                  hexadecimal digits. For instance, to specify that FF hex is to be
                  used as the terminating character, enter "\xff" (without the quotes)
                  in the edit box. To specify 00 hex, use "\x00".

                  Selecting the second radio button, Time-out (sec), will stop storing
                  data to the file when there is no activity on the serial input for
                  a specified number of seconds. You can enter the number of seconds in
                  the edit box to right.

                  Selecting the third radio button, User cancel, will stop storing
                  data to the file ONLY when the Cancel button is clicked in the
                  status window. Clicking cancel will also stop either of the other
                  two options of file reception.

  ASCII Send -    Select options for sending an ASCII file.

                  You can send a string out the serial port before and/or after sending
                  the disk file. Just fill in the edit box labeled "Send prefix" for a
                  string to be sent before the disk file is sent. Fill in the edit box
                  labeled "Send suffix" for a string to be sent after the disk file has
                  been sent. Non-printable and control characters can be sent using the
                  same techniques listed above for the Terminating Character for an ASCII
                  receive. For example, if you need to send a command (like "Load")
                  followed by a carriage return/line feed pair before the file is sent,
                  fill in the "Send prefix" edit box with:

                  Load\r\n

                  or alternately:

                  Load\x0d\x0a

                  using the hex codes for carriage return (0d hex) and line feed (0a hex).

                  If you are sending the file to a slow device, you can add a delay between
                  characters and/or lines by filling in the appropriate edit box with the
                  number of milliseconds of delay you want between characters and/or lines.

- A "Most Recently Used" list of files has been added under the File menu. The last five
  editor files are listed. The order is changed when a new file is opened with the latest
  file to be opened listed at the top. To open a file in the list, just click on it. If
  it's already open, the file's editor will be brought into focus. If you want to remove
  a file name from the Most Recently Used list, hold the Control key while you select the
  file in the list.

What changed with version 4.14.5
- Sending a BREAK over the serial port was added. A menu item was added under the CommPort
  menu was added along with a shortcut of Alt+K (holding the Alt key while hitting the 'K').
  Also, the status bar at the bottom of the Terminal Window has a new section showing the
  status of the BREAK (either on or off). If you click on this area of the status bar, the
  state of the BREAK will toggle.

- This version was not released


What changed with version 4.14.4
- Programs for the Model 8 would give various problems but none would run. All TxBASIC
  programs for the Model 8 should run now.


What changed with version 4.14.3
- A bug was fixed that caused memory to be corrupted or a non-working TxBASIC program
  to be generated. The code that caused this was triggered by using forward label
  references in the TxBASIC program. This has been corrected and forward references
  are once again available to TxBASIC programs.

- The Disk Off-load function (under the Tattletale menu) is now implemented.

- The Send File XMODEM function (under the CommPort menu) is now implemented.

- The Receive File XMODEM function (under the CommPort menu) is now implemented.

- The status window now shows both the percent complete and the number of bytes transferred
  (under the moving bar). Where the full size of the transfer is unknown (as when receiving
  an XMODEM transfer), the moving bar just shows activity and does not display percent
  completed.


What changed with version 4.14.2
- The Open file and Save file functions (under the File menu) were using a default TFB
  extension instead of TXB. They both use TXB now.

- The Open menu item is supposed to save the path of the last opened file but it wasn't.
  When the next open is attempted, it is supposed to start in the saved directory. TxTools
  now works that way.


What changed with version 4.14.1
Initial release
