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