Whitespace fix in the VERSION file.
[shapes.git] / VERSION
blob2ded2d1f1f681169c5d1e6ecd80b146498597bca
1 0.6.0
2 The first line of this file shall be the last tagged version string.  The version history may be filled in at any time, but when a version is tagged, the current date shall be added on the first line of the release notes for the version being tagged.
4   Version history
5 ===================
7 ====( 0.6.0 )====
8 2010-06-02
10 Bringing in FreeType and fontconfig.  So far, the only supported font format is TrueType, and the support of this format is in no way complete.  Still, this version marks the start of a more serious treatment of text and fonts in Shapes.  Currently supported features include access to glyph outlines and painting (as well as clipping with respect to) text using both embedded and outlines fonts.  Better font support and more features related to text formatting are expected in the future.
12 Backwards incompatible change: "TeX" is no longer the keyword of a special form.  It now behaves as an ordinary function, although the implementation still detects calls with a literal string argument during program analysis.  Expressions like (TeX ("$x^{2}$")) are deprecated and shall be replaced by [TeX ("$x^{2}$")].  The old special form will still be allowed for some (not very long) time, but a warning message will inform the user about the need to switch to a function call.
14 Other new features include:  Wider support for folds, and a new efficient implementation of ranges.  New syntax %last refers to last position in a container.  New syntax allows mutators to be called as part of an insertion sequence.  New atomic data type for characters.  New state type for one-dimensional arrays.  The new dynamic variable @spot is an alternative to [spot (0m,0m)].  Shapes now ship with shapes-mode, which comes with some new features and bugfixes, and is now described in the Shapes on-line documentation.
16 Bugfixes include:
17 -  Workaround for Flex not being compatible with modern C++ compilers.
18 -  A configuration bug caused errors when libpng was present, but not libjpeg.
19 -  Miter limit is a float, and values less than 1 are not allowed.
20 -  Default value for @text_knockout was wrong.
23 ====( 0.5.2 )====
24 2009-12-14
26 Now supporting native include of some raster image formats, namely PNG and JPEG.  JPEG file inclusion is supported by means of the JPEG facilities defined in the PDF standard, while parts of the feature-rich PNG format are supported with help from the libpng library.  Compared to using \includegraphics in a TeX label, including images directly in Shapes is more reliable since there is no need to detect when a TeX label needs to be rebuilt.
28 Command line option --iteration=false prevents reuse of stored labels (in addition to preventing the label database file from being written).  This feature would have been of greater value before the release of this version, since problems with raster images not being updated was the main reason behind it.
30 The shapes-mode for Emacs is now using a new technique for indentation.
32 Bugfixes include:
33 -  Configuration of Saxon after they changed their naming scheme.
36 ====( 0.5.1.2 )====
37 2009-11-02
39 This is a bugfix release.
41 Bugfix:
42 -  The man page silently failed to build, and an empty man page was installed.
45 ====( 0.5.1.1 )====
46 2009-08-22
48 This is a bugfix release.
50 Bugfix:
51 -  Fixed C++ conformity issue causing build failure with modern C++ compiler.
54 ====( 0.5.1 )====
55 2009-08-19
57 A minor version increment with important new features, one remarkable removal of a bad feature, changed syntax, and more.
59 The two big news are the path-to-path approximation and an improved analysis of user programs.
61 The path-to-path approximation is available through <approximator>.  It captures a very natural way to select a point on a path (but the implementation was a little bit involved, which is why the feature hasn't appeared until now).
63 The improved analysis keeps track of the free states in every expression, and is therefore able to detect that a code bracket which only mutates its own states is a pure expression.
65 With this version, the old and ugly procedures have been removed from the language.  They were never used, and made programs much more difficult to analyze.  Without procedures, there was no longer any need for the old "!" syntax, and hence the old "!!" was changed to "!".
67 Bugfixes include:
68 -  Errors in the CSS for HTML documentation.
69 -  Subpaths at end of closed path.
70 -  A 3D arrowhead was trying to fill a non-closed path.
73 ====( 0.5.0 )====
74 2009-05-18
76 Stepping the version from 0.4.x to 0.5.x is motivated by the arriaval of the interactive mode of the compiler.  The interactive mode could make it easier to teach and learn Shapes, and the it is also used extensively by the new debugging facility.  The debugging facility, represented by the debugger state #db (available in the interacitve mode only), provides common debugging tools such as examination of the current evaluation state (lexical and dynamic environments, and backtrace), breakpoints, and stepping.  While the true usefulness of the interactive mode during normal use of Shapes remains unclear, it implementation brings important improvements to the compiler design.
78 The shapes-mode for Emacs has been updated, and includes some support for the interactive mode (try it with "M-x run-shapes" in Emacs!).
80 This release also contains the new arrowhead <ShapesArrow>.  It generally looks better than <MetaPostArrow>, and replaces <MetaPostArrow> in most examples and extensions.
82 Now supporting the PDF feature to clip with a text object as mask.
84 More documentation.
86 Bugfixes include:
87 -  Random number generation was completely broken when compiling with recent gcc g++ compiler.
88 -  Installation of HTML documentation was broken, causing the documentation index.html to be overwritten by the "project web" index.html.
89 -  The PDF text state was not updated correctly in some situations.
92 ====( 0.4.3.1 )====
93 2009-03-10
95 This release combines compatibility fixes for GCC 4.3 with some install-related improvements.
97 Bugfixes include:
98 -  Sloppy C++ has been cleaned up to compile with GCC 4.3.
101 ====( 0.4.3 )====
102 2008-12-22
104 This release comes with many long awaited, but backwards incompatible changes.  Merry Christmas!
106 New string construction syntax.  There are now three ways to enter strings, two of which have no escape characters, and a third that is only partly human-readable.  Most notably, the newline is now entered as the four character construct "{n} (having no special meaning inside the human-readable strings).
108 New operator for sending one argument through a function from the left.  For instance, the following two lines are equivalent:
109   [stroke [immerse [circle 1cm]]]
110   [circle 1cm] >> immerse >> stroke
111 Note that the operator is left associative.
113 Changed operator precedence and associativity rules.  Biggest change is that [] is now left associative to give good support for hard-wired curry functions.  This means that all old chains of [], changes into chains of >> (in reversed left-right order).  The new priority of | allows many old parentheses to be removed, but needs only a few new to be inserted.  Operator precedence and associativity can now be found in the syntax documentation.
115 There is now a prelude.  The standard prelude relieves the user from bringing in the most common extensions with ##needs.
117 Many functions in the standard prelude were renamed.
119 Bleed boxes are used instead of bounding boxes to determine size of final page.  Used by TeX (which takes a setting from @TeX_bleed) to remedy an old problems with bounding boxes coming out slightly too small from pdfLaTeX.
121 Improved Emacs support.
123 More documentation.
125 Buxfixes include:
126 -  Prevention of endless elementary path computation.
127 -  Problems with thunks in user dynamic variable declarations.
128 -  Character encoding setting in the Emacs shapes-mode.
131 ====( 0.4.2.1 )====
132 2008-12-13
134 (Celebrating Gustaf's thirtieth birthday.)
136 This is primarily (but not only) a bugfix release.
138 Bugfixes:
139 -  For some build setups, not all xsl files were included in distributions.
140 -  Exponents in scientific notation.
141 -  Removed confusion regarding which dynamic environment to use in tack-on operations.
144 ====( 0.4.2 )====
145 2008-12-02
147 GPL and copyright notes have been inserted in all non-trivial files.
149 A logo has been introduced.  Do not consider it final!
151 New notation, including more ASCII fall-backs.  The change of notation for functions is not backwards compatible!
153 Introduced mutators for states.  Old, global, non-pure functions were removed -- not backwards compatible!
155 New shapes-mode for Emacs.
157 Stuff for transforms, including fields (components as well as predicates), a <chop> method, and a kind of real Schur decomposition in 3D.
159 Lots of new documentation.
161 Source code for methods of types in Shapes has been reorganized.
163 Bugfixes include:
164 -  Including FlexLexer.h in distribution.
165 -  Annoying internal errors when displaying source locations were removed.
168 ====( 0.4.1 )====
169 2008-10-16
171 (Celebrating my thirtieth birthday.)
173 Improved build process for the documentation.
175 Introducing exit codes.
177 Bugfixes include:
178 -  Building the correct index.html at the top of the HTML documentation.
179 -  Lost JPG files in the HTML documentation were found by correct handling of the percent sign in URIs.
182 ====( 0.4.0 )====
183 2008-10-05
185 The distribution contains the documentation now, making it complete.
187 Lots of new documentation.
189 Minor, but many, changes in the syntax of command line options.  Basically, all parameters but files and directories are given using the --param=val style.
191 The directory for temporary files can be created automatically, if allowed.
193 New operator, &|, that combines dynamic bindings with priority to the second argument.
195 Pages can be grouped to have equal media boxes.  At the moment, the media box will be the smallest that contains the bounding boxes of all pages in the group.  See the non-pure function setbboxgroup for more details.
197 The document can be split into one output file per page, see the --split=mode option.
199 Improvements relating to PDF versions including a separate setting for whether to use transparency in the kernel, and not marking the output file with a higher version than what is implied by the PDF features is uses.
201 Additions and improvements to some of the standard extensions.
203 Bugfixes include:
204 -  Intersection of straight line segments.
205 -  Sometimes, functions were associated with the wrong environment.
206 -  Escaping the '\' in PDF strings.
209 ====( 0.3.7 )====
210 2008-04-21
212 The previous version was broken.  This version has been verified by running "make distcheck".
215 ====( 0.3.6 )====
216 2008-04-20
218 Lots of new documentation, including substantial work on structure, crosslinks, and formatting.  So far the HTML format has been in focus.
220 Procedure application is limited to certain scoping rules to ensure that the function abstraction is not broken.
222 Improved output to help finding errors i TeX label strings, and a bug with the --tmpdir feature was remedied.
224 Changed command line syntax for boolean options changed; no more --no-someopt, instead we use --someopt=no (the "no" has some synonyms).
226 New features of all kinds, ranging from additions to the scanner to new state types and functions.
228 Also new application examples in 3D, code optimizations, and bugfixes.
231 ====( 0.3.5 )====
232 2007-12-06
234 The previous attempt to create a file for distribution failed.  This version is the second attempt.
237 ====( 0.3.4 )====
238 2007-12-03
240 Bugfixes, including one in the computation of elementary paths.  There also used to be a problem (since 0.3.2) with running pdfLaTeX in a different directory than where the Shapes source is located, since the meaning of relative file locations must be changed when source code is moved.
242 This is the first version planned for (very limited) distribution using the new build process.
245 ====( 0.3.3 )====
246 2007-11-21
248 Simple constants in the global environment were named back to their names before variables had to begin with lowercase letters.  For instance, rgb_RED changed back to RGB_RED.
251 ====( 0.3.2 )====
252 2007-11-21
254 New ways to specify files, both on the command line and through environment variables.
256 Further improved build process, and minor additions to the documentation.
259 ====( 0.3.1 )====
260 2007-11-05
262 Bugfixes required to make the project compile in the Cent environment.
264 More standardization.
267 ====( 0.3.0 )====
268 2007-11-03
270 First version with most references to old project names removed.
272 Slowly changing to a more standardized way to compile things, for better compilance with standard make tools in the future.
275 ====( 0.2.3 )====
276 2007-11-03
278 Upsampling has been added.  The interesting methods for upsampling only apply in 2D, but length-based upsampling is provided also in 3D.  Please note that there is no need to do upsample_inflections before doing upsample_bends, as this is done autimatically to ensure clear semantics.  The method upsample_balance samlpes the timewise midpoint of each segment, which I believe will make the speed equal in the incoming and outgoing side of the sample point.
280 Identifiers are again allowed to begin with uppercase letters.  Type names are prefixed with either a paragraph sign or a double slash.
282 This is planned to be the last version where anything "Drool" remains.
285 ====( 0.2.2 )====
286 2007-06-05
288 The interpreter now makes another pass of the code, checking variable bindings, function borders, and other static aspects of the code.  Type checking will hopefully fit in here in the future.  The three passes are:
289 1) Scan and parse
290 2) Analyze
291 3) Evaluate
293 The error reporting mechanism has been revised so that the errors found during static analysis are collected in a list, rather than throwing just the first we detect and then abort.
296 ====( 0.2.1 )====
297 2007-05-19
299 By now many feature examples have been compiled successfully, and the tests go through.
301 More importantly, the random number facility has been redesigned so that states are used where appropriate.  To make it easy to use states in folds, the kernel's list type has been enhanced with methods foldsl ("fold with state, left") and foldsr ("fold with state, right").  However, this was not quite necessary since the same functionality can be implemented as an extension, as was done in conssupport.drext, and used random.drool.
303 Among all bugs found lately, one was in the z-buffer.  Although it was fixed, I'm not at all convinced that transforms are handled correctly, nor that overlaps and line-surface intersections are determined correctly.
306 ====( 0.2.0 )====
307 2007-04-24
309 This version marks the point where the two feature examples states.drool and values.drool compile.  This means that the program is getting useful again.  However, the great majority of the examples have not been updated, and it is expected that many bugs will be revealed in the process of updating them.
311 In other words, this version marks the beginning of the use of states and structures, but these features should be debugged and tested on the many available examples before being considered a true alternative to using the language as of version 0.1.1.
314 ====( 0.1.2 )====
316 This version is to be used during the early phases of the transition from hot variables to temporary states.  One the program becomes useful again, the version number shall be incremented.
319 ====( 0.1.1 )====
320 2007-01-02
322 Testing has been automated.  The tests are divided into two cathegories depending on whether it is the graphical or textual program output that is to be compared against a given output.  See the Makefile's in the ./test directory and its subdirectories to learn how to run the tests or add new tests.
324 The z-buffer idea has been postponed.  Instead, a z-sorter has been implemented.  It does not handle cyclic overlaps properly.
326 There are lots of bugfixes and small enhancements over the previous version.  One of the enhancements is the "[...]"-syntax for evaluated cuts along one argument.
328 This is planned to be the the last usable version with hot variables.
331 ====( 0.1 )====
332 2006-12-12
334 First named version.
336 I'd say this is far too late for the introduction of a version number.  The reason not to make a named version has been that rather big changes in the language syntax have been expected.  However, these changes are still expected, but today I was really curious to know what binary I had installed, and this is what made me take this step.
338 To give an idea of how long this project has been running I'll mention two things.  First, the initial import of the project into subversion dates back to 2005-09-23.  Second, there's now 395 kB of zipped source code for the compiler.  In addition, there are many examples and language extension files.
340 There still not much at all of documentation.  Comments in the source are sparse, much too sparse.  A user's guide hsa been initiated, but the files have not yet entered the project repository.  There is no laguage definition either, but this is partly because the language is still expected to change substantially.
342 A few words about testing:  The testing is without structure so far.  I generate examples to test the features I'm currently working on, but I do not generate tests that can be checked automatically.  This probably says something about the quality of this version.  That I plan automatize testing soon does not make this version better.
344 The list of features that exist in this version is much too long for me to think of right now.  The first such a list I expect to create will be the user documentation, so until then the examples is as close as one gets.