Documented change to Makefile.
[debian/pforth] / releases.txt
1 Release History for pForth - a Portable ANS-like Forth written in ANSI 'C'\r
2 \r
3 Documentation for pForth at http://www.softsynth.com/pforth/\r
4 \r
5 V23 8/4/2008\r
6         - Removed -v option from mkdir in build/unix/Makefile. It was not supported on FreeBSD.\r
7           Thank you Alexsej Sauchdev for reporting this.\r
8         \r
9 V23  7/20/2008\r
10     - Reorganized for Google Code project.\r
11     \r
12 V22  (unreleased)\r
13     - Added command line history and cursor control words.\r
14         - Sped up UM* and M* by a factor of 3. Thanks to Steve Green for suggested algorithm.\r
15         - Modified ACCEPT so that a line at the end of a file that does NOT have a line\r
16             terminator will now be processed.\r
17         - Use _getch(), _putch(), and _kbhit() so that KEY, EMIT and ?TERMINAL will work on PC.\r
18         - Fixed  : foo { -- } 55 ;  - was entering local frame but not exiting.\r
19     - Redefined MAKE_ID to protect it from 16 bit ints\r
20     - John Providenza says "If you split local variables onto 2 lines, PForth crashes." Fixed. Also allow \\r
21     - Fixed float evaluation in EVALUATE in "quit.fth".\r
22     - Flush register cache for ffColon and ffSemiColon to prevent stack warnings from ;\r
23 \r
24 V21 - 9/16/98\r
25         - Fixed some compiler warnings.\r
26 \r
27 V20\r
28     - Expand PAD for ConvertNumberToText so "-1 binary .s" doesn't crash.\r
29       Thank you Michael Connor of Vancouver for reporting this bug.\r
30 \r
31     - Removed FDROP in REPRESENT to fix stack underflow after "0.0 F.".\r
32       Thank you Jim Rosenow of Minnesota for reporting this bug.\r
33         - Changed pfCharToLower to function to prevent macro expansion bugs under VXWORKS\r
34       Thank you Jim Rosenow of Minnesota for reporting this bug.\r
35 \r
36         - "0.0 F~" now checks actual binary encoding of floats. Before this it used to just\r
37           compare value which was incorrect. Now "0.0 -0.0 0.0 F~" returns FALSE.\r
38 \r
39         - Fixed definition of INPUT$ in tutorial.\r
40       Thank you Hampton Miller of California for reporting this bug.\r
41 \r
42         - Added support for producing a target dictionary with a different\r
43           Endian-ness than the host CPU.  See PF_BIG_ENDIAN_DIC and PF_LITTLE_ENDIAN_DIC.\r
44 \r
45         - PForth kernel now comes up in a mode that uses BASE for numeric input when\r
46           started with "-i" option.  It used to always consider numeric input as HEX.\r
47           Initial BASE is decimal.  \r
48 \r
49 V19  4/98\r
50 \r
51         - Warn if local var name matches dictionary, : foo { count -- } ;\r
52         - TO -> and +-> now parse input stream. No longer use to-flag.\r
53         - TO -> and +-> now give error if used with non-immediate word.\r
54         - Added (FLITERAL) support to SEE.\r
55         - Aded TRACE facility for single step debugging of Forth words.\r
56         - Added stub for ?TERMINAL and KEY? for embedded systems.\r
57         - Added PF_NO_GLOBAL_INIT for no reliance on global initialization.\r
58         - Added PF_USER_FLOAT for customization of FP support.\r
59         - Added floating point to string conversion words (F.) (FS.) (FE.)\r
60             For example:   : F.   (F.)  TYPE  SPACE  ;\r
61         - Reversed order that values are placed on return stack in 2>R\r
62           so that it matches ANS standard.  2>R is now same as SWAP >R >R\r
63           Thank you Leo Wong for reporting this bug.\r
64 \r
65         - Added PF_USER_INIT and PF_USER_TERM for user definable init and term calls.\r
66 \r
67         - FIXED memory leak in pfDoForth()\r
68 \r
69 V18\r
70         - Make FILL a 'C' primitive.\r
71         - optimized locals with (1_LOCAL@)\r
72         - optimized inner interpreter by 15%\r
73         - fix tester.fth failures\r
74         - Added define for PF_KEY_ECHOS which turns off echo in ACCEPT if defined.\r
75         - Fixed MARKER. Was equivalent to ANEW instead of proper ANS definition.\r
76         - Fixed saving and restoring of TIB when nesting include files.\r
77 \r
78 V17\r
79         - Fixed input of large floats.  0.7071234567 F.  used to fail.\r
80 \r
81 V16\r
82         * Define PF_USER_CUSTOM if you are defining your own custom\r
83           'C' glue routines.  This will ifndef the published example.\r
84         - Fixed warning in pf_cglue.c.\r
85         - Fixed SDAD in savedicd.fth.  It used to generate bogus 'C' code\r
86           if called when (BASE != 10), as in HEX mode.\r
87         - Fixed address comparisons in forget.fth and private.fth for\r
88           addresses above 0x80000000. Must be unsigned.\r
89         - Call FREEZE at end of system.fth to initialize rfence.\r
90         - Fixed 0.0 F. which used to leave 0.0 on FP stack.\r
91         - Added FPICK ( n -- ) ( i*f -- i*f f[n] )\r
92         - .S now prints hex numbers as unsigned.\r
93         - Fixed internal number to text conversion for unsigned nums.\r
94 \r
95 V15 - 2/15/97\r
96         * If you use PF_USER_FILEIO, you must now define PF_STDIN and PF_STDOUT\r
97           among other additions. See "pf_io.h".\r
98         * COMPARE now matches ANS STRING word set!\r
99         - Added PF_USER_INC1 and PF_USER_INC2 for optional includes\r
100           and host customization. See "pf_all.h".\r
101         - Fixed more warnings.\r
102         - Fixed >NAME and WORDS for systems with high "negative" addresses.\r
103         - Added WORDS.LIKE utility.  Enter:   WORDS.LIKE EMIT\r
104         - Added stack check after every word in high level interpreter.\r
105           Enter QUIT to enter high level interpreter which uses this feature.\r
106         - THROW will no longer crash if not using high level interpreter.\r
107         - Isolated all host dependencies into "pf_unix.h", "pf_win32.h",\r
108           "pf_mac.h", etc.  See "pf_all.h".\r
109         - Added tests for CORE EXT, STRINGS words sets.\r
110         - Added SEARCH\r
111         - Fixed WHILE and REPEAT for multiple WHILEs.\r
112         - Fixed .( ) for empty strings.\r
113         - Fixed FATAN2 which could not compile on some systems (Linux gcc).\r
114 \r
115 V14 - 12/23/96\r
116         * pforth command now requires -d before dictionary name.\r
117                 Eg.   pforth -dcustom.dic test.fth\r
118         * PF_USER_* now need to be defined as include file names.\r
119         * PF_USER_CHARIO now requires different functions to be defined.\r
120                 See "csrc/pf_io.h".\r
121         - Moved pfDoForth() from pf_main.c to pf_core.c to simplify\r
122           file with main().\r
123         - Fix build with PF_NO_INIT\r
124         - Makefile now has target for embedded dictionary, "gmake pfemb".\r
125 \r
126 V13 - 12/15/96\r
127         - Add "extern 'C' {" to pf_mem.h for C++\r
128         - Separate PF_STATIC_DIC from PF_NO_FILEIO so that we can use a static\r
129           dictionary but also have file I/O.\r
130         - Added PF_USER_FILEIO, PF_USER_CHARIO, PF_USER_CLIB.\r
131         - INCLUDE now aborts if file not found.\r
132         - Add +-> which allows you to add to a local variable, like +! .\r
133         - VALUE now works properly as a self fetching constant.\r
134         - Add CODE-SIZE and HEADERS-SIZE which lets you resize\r
135           dictionary saved using SAVE-FORTH.\r
136         - Added FILE?. Enter "FILE? THEN" to see what files THEN is defined in.\r
137         - Fixed bug in local variables that caused problems if compilation\r
138           aborted in a word with local variables.\r
139         - Added SEE which "disassembles" Forth words. See "see.fth".\r
140         - Added PRIVATE{ which can be used to hide low level support\r
141           words.  See "private.fth".\r
142         \r
143 V12 - 12/1/96\r
144         - Advance pointers in pfCopyMemory() and pfSetMemory()\r
145           to fix PF_NO_CLIB build.\r
146         - Increase size of array for PF_NO_MALLOC\r
147         - Eliminate many warnings involving type casts and (const char *)\r
148         - Fix error recovery in dictionary creation.\r
149         - Conditionally eliminate some include files for embedded builds.\r
150         - Cleanup some test files.\r
151 \r
152 V11 - 11/14/96\r
153         - Added support for AUTO.INIT and AUTO.TERM.  These are called\r
154           automagically when the Forth starts and quits.\r
155         - Change all int to int32.\r
156         - Changed DO LOOP to ?DO LOOP in ENDCASE and LV.MATCH\r
157           to fix hang when zero local variables.\r
158         - Align long word members in :STRUCT to avoid bus errors.\r
159         \r
160 V10 - 3/21/96\r
161         - Close nested source files when INCLUDE aborts.\r
162         - Add PF_NO_CLIB option to reduce OS dependencies.\r
163         - Add CREATE-FILE, fix R/W access mode for OPEN-FILE.\r
164         - Use PF_FLOAT instead of FLOAT to avoid DOS problem.\r
165         - Add PF_HOST_DOS for compilation control.\r
166         - Shorten all long file names to fit in the 8.3 format\r
167           required by some primitive operating systems. My\r
168           apologies to those with modern computers who suffer\r
169           as a result.  ;-)\r
170         \r
171 V9 - 10/13/95\r
172         - Cleaned up and documented for alpha release.\r
173         - Added EXISTS?\r
174         - compile floats.fth if F* exists\r
175         - got PF_NO_SHELL working\r
176         - added TURNKEY to build headerless dictionary apps\r
177         - improved release script and rlsMakefile\r
178         - added FS@ and FS! for FLPT structure members\r
179 \r
180 V8 - 5/1/95\r
181         - Report line number and line dump when INCLUDE aborts\r
182         - Abort if stack depth changes in colon definition. Helps\r
183           detect unbalanced conditionals (IF without THEN).\r
184         - Print bytes added by include.  Helps determine current file.\r
185         - Added RETURN-CODE which is returned to caller, eg. UNIX shell.\r
186         - Changed Header and Code sizes to 60000 and 150000\r
187         - Added check for overflowing dictionary when creating secondaries.\r
188 \r
189 V8 - 5/1/95\r
190         - Report line number and line dump when INCLUDE aborts\r
191         - Abort if stack depth changes in colon definition. Helps\r
192           detect unbalanced conditionals (IF without THEN).\r
193         - Print bytes added by include.  Helps determine current file.\r
194         - Added RETURN-CODE which is returned to caller, eg. UNIX shell.\r
195         - Changed Header and Code sizes to 60000 and 150000\r
196         - Added check for overflowing dictionary when creating secondaries.\r
197         \r
198 V7 - 4/12/95\r
199         - Converted to 3DO Teamware environment\r
200         - Added conditional compiler [IF] [ELSE] [THEN], use like #if\r
201         - Fixed W->S B->S for positive values\r
202         - Fixed ALLOCATE FREE validation.  Was failing on some 'C' compilers.\r
203         - Added FILE-SIZE\r
204         - Fixed ERASE, now fills with zero instead of BL\r
205         \r
206 V6 - 3/16/95\r
207         - Added floating point\r
208         - Changed NUMBER? to return a numeric type\r
209         - Support double number entry, eg.   234.  -> 234 0\r
210 \r
211 V5 - 3/9/95\r
212         - Added pfReportError()\r
213         - Fixed problem with NumPrimitives growing and breaking dictionaries\r
214         - Reduced size of saved dictionaries, 198K -> 28K in one instance\r
215         - Funnel all terminal I/O through ioKey() and ioEmit()\r
216         - Removed dependencies on printf() except for debugging\r
217 \r
218 V4 - 3/6/95\r
219         - Added smart conditionals to allow IF THEN DO LOOP etc.\r
220           outside colon definitions.\r
221         - Fixed RSHIFT, made logical.\r
222         - Added ARSHIFT for arithmetic shift.\r
223         - Added proper M*\r
224         - Added <> U> U<\r
225         - Added FM/MOD SM/REM /MOD MOD */ */MOD\r
226         - Added +LOOP EVALUATE UNLOOP EXIT\r
227         - Everything passes "coretest.fth" except UM/MOD FIND and WORD\r
228         \r
229 V3 - 3/1/95\r
230         - Added support for embedded systems: PF_NO_FILEIO\r
231         and PF_NO_MALLOC.\r
232         - Fixed bug in dictionary loader that treated HERE as name relative.\r
233         \r
234 V2 - 8/94\r
235         - made improvements necessary for use with M2 Verilog testing\r
236 \r
237 V1 - 5/94\r
238         - built pForth from various Forths including HMSL\r
239 \r
240 ----------------------------------------------------------\r
241         \r
242 \r
243 Enjoy,\r
244 Phil Burk\r