ctemplate/trunk/NEWS

== 24 January 2012 ==

I've just released ctemplate 2.0.  It has no functional changes from
ctemplate 1.2.

The `google-ctemplate` project has been renamed to `ctemplate`.  I
(csilvers) am stepping down as maintainer, to be replaced by Olaf van
der Spek.  Welcome to the team, Olaf!  I've been impressed by your
contributions to the project discussions and code to date, and look
forward to having you on the team.

I bumped the major version number up to 2 to reflect the new community
ownership of the project.  All the
[http://google-ctemplate.googlecode.com/svn/tags/ctemplate-2.0/ChangeLog changes]
are related to the renaming.


=== 18 January 2011 ===

The `google-ctemplate` Google Code page has been renamed to
`ctemplate`, in preparation for the project being renamed to
`ctemplate`.  In the coming weeks, I'll be stepping down as
maintainer for the ctemplate project, and as part of that Google is
relinquishing ownership of the project; it will now be entirely
community run.  The name change reflects that shift.

=== 22 December 2011 ===

I've just released ctemplate 1.1.  The only functionality change is
obscure: when a reload is done (via, say, `ReloadAllIfChanged`), and a
new file has been created since the last reload that both a) has the
same filename as a template file that had been loaded in the past, and
b) is earlier on the template search-path than the previously loaded
file, *and* c) the previously loaded file hasn't changed since the
last reload, then at reload-time we now load the new file into the
template, replacing the old file.  Before we would only load the new
file if the old file had changed on disk, and would otherwise leave
the template alone.  Even more minor changes are in the
[http://google-ctemplate.googlecode.com/svn/tags/ctemplate-1.1/ChangeLog ChangeLog].

=== 26 August 2011 ===

I've just released ctemplate 1.0!  (I've decided 4 weeks is well
within the definition of "the next week or so"...)

A bit anti-climactic: there are no changes from ctemplate 1.0rc2.

=== 29 July 2011 ===

I've just released ctemplate 1.0rc2.  This fixes a serious bug where I
had added #includes in installed header files, that tried to include
non-installed header files.  This means it was impossible to use
installed ctemplate; it only worked if you were using it from the
tarball directory.

I also fixed the unittest that was supposed to catch this, but didn't
(it was also building in the tarball directory).

If no further problems are found in the next week or so, I will
release ctemplate 1.0.

=== 22 July 2011 ===

I've just released ctemplate 1.0rc1.  If no problems are found in the
next week or two, I will release ctemplate 1.0.

ctemplate 1.0rc1 has relatively few changes from ctemplate 0.99.
xml-escaping has been improved a bit.  A couple of bugs have been
fixed, including one where we were ignoring template-global sections
(a relatively new feature) in some places.  A full list of changes is
available in the
[http://google-ctemplate.googlecode.com/svn/tags/ctemplate-1.0rc1/ChangeLog ChangeLog].

I've also changed the internal tools used to integrate
Google-supplied patches to ctemplate into the opensource release.
These new tools should result in more frequent updates with better
change descriptions.  They will also result in future ChangeLog
entries being much more verbose (for better or for worse).

=== 24 January 2011 ===

I've just released ctemplate 0.99.  I expect this to be the last
release before ctemplate 1.0.  Code has settled down; the big change
here is some efficiency improvements to javascript template escaping.
There is also a bugfix for an obscure case where ReloadAllIfChanged()
is used with multiple ctemplate search paths, where files are deleted
in one part of the search path between reloads.  Unless you need
either of the above, there's no particular reason to upgrade.

A full list of changes is available in the
[http://google-ctemplate.googlecode.com/svn/tags/ctemplate-0.99/ChangeLog ChangeLog].

=== 23 September 2010 ===

I've just released ctemplate 0.98.  The changes are settling down as
we approach ctemplate 1.0 -- a few new default modifiers, a few
performance tweaks, a few portability improvements, but nothing
disruptive.

In my testing for this release, I noticed that the template regression
test (but not other template tests) would segfault on gcc 4.1.1 when
compiled with -O2.  This seems pretty clearly to be a compiler bug; if
you need to use gcc 4.1.1 to compile ctemplate, you may wish to build
via `./configure CXXFLAGS="-O1 -g"` just to be safe.

=== 20 April 2010 ===

I've just released ctemplate 0.97.  This change consists primarily of
a significant change to the API: the addition of the `TemplateCache`
class, combined with deprecation of the `Template` class.

`TemplateCache` is a class that holds a collection of templates; this
concept always existed in ctemplate, but was not previously exposed.
Many static methods of the `Template` class, such as
`ReloadAllIfChanged()`, have become methods on `TemplateCache` instead
(the `Template` methods have been retained for backwards
compatibility.)  Other methods, such as `Expand()`, have become free
functions.  In fact, the entire `Template` class has been deprecated.

The deprecation of `Template` calls for changes in all clients of the
template code -- you can see in the example at the top of this page
how the code has changed from `Template* tpl =
ctemplate::Template::GetTemplate("example.tpl",
ctemplate::DO_NOT_STRIP); tpl->Expand(&output, &dict);` to
`ctemplate::ExpandTemplate("example.tpl", ctemplate::DO_NOT_STRIP,
&dict, &output);`.  These changes will make the code simpler and more
thread-safe.

Old code should continue to work -- the `Template` class remains --
but new code should use the new API, and old code should transition as
convenient.  One old API method is intrinsically thread-unsafe, and
should be prioritized to change: `tpl->ReloadIfChanged` should change
to `ctemplate::Template::ReloadAllIfChanged()`.  Note this is a
semantic change: all templates are now reloaded, rather than just one.
However, since templates are reloaded lazily, and only if they've
changed on disk, I'm hopeful it will always be a reasonable change to
make.

To go along with these changes, the documentation has been almost
entirely revamped and made more accessible.  Obscure ctemplate
features have been excised from the user's guide and moved into a
separate reference document.  The new API is fully documented,
including new flexibility around reloading templates, made available
by the introduction of `TemplateCache`.

There are some more minor changes as well, such as the addition of
#include guards in the auto-generated .tpl.h files, to make it safe to
multiply-include them.  I've also been continuing the portability
work: ctemplate should now work under Cygwin and MinGW.  A full list
of changes is available in the
[http://google-ctemplate.googlecode.com/svn/tags/ctemplate-0.97/ChangeLog ChangeLog].

I know I've said this before, but I don't expect major API changes
before the 1.0 release.  The most significant changes I expect to see
are the potential removal of some of the 'forwarding' methods in the
(deprecated) `Template` class.

=== 12 June 2009 ===

I've just released ctemplate 0.95.  This is entirely an API cleanup
release.  Actually, relatively little of the API proper has changed:
`StringToTemplate` no longer takes an autoescape-context arg (instead
you specify this as part of the template-string, using the
`AUTOESCAPE` pragma).  A few obsolete constructs have gone away, such
as the `TemplateFromString` class and
`TemplateDictionary::html_escape` and friends (just use the top-level
`html_escape`).  See the
[http://google-ctemplate.googlecode.com/svn/tags/ctemplate-0.95/ChangeLog
ChangeLog] for a full list of these changes.

The biggest change is a renaming: the default namespace is now
`ctemplate` rather than `google`, and the include directory is
`ctemplate` rather than `google`.  Other namespaces, such as
`template_modifiers`, have gone away.

All these changes will require you to modify your old code to get it
working with ctemplate 0.95.  I've written a
[http://google-ctemplate.googlecode.com/svn/trunk/contrib/convert_to_95.pl
script] to help you do that.  Please open an
[http://code.google.com/p/google-ctemplate/issues/list issue] if you
see a problem with the script.  I've tested it, but not as widely as
I'd like.  Also note the script will not be perfect for more complex
constructs, which you will have to clean up by hand.

I hope (expect) the API is now stable, and we won't see any more such
changes before ctemplate 1.0.  I tried to isolate them all in this
release; except for the API changes, this release should behave
identically to ctemplate 0.94.

=== 7 May 2009 ===

I've just released ctemplate 0.94.  A few new features have been
added, such as the ability to expand a template into your own custom
`ExpandEmitter` instance, and the ability to hook the annotation
system (typically used for debugging).  You can now remove strings
from the template cache in addition to adding them.  Also, there
continues to be a trickle of new modifiers, in this case a modifier
for URL's in a CSS context.

However, the most invasive changes were made for speed reasons.  The
biggest is that (almost) all `TemplateDictionary` allocations are now
done on the arena -- this includes allocations by the STL classes
inside the dictionary.  This allows us to free all the memory at once,
rather than item by item, and has yielded a 3-4% speed improvement in
our tests.  I've combined this with a `small_map` class that stores
items in a vector instead of a hash-map until we get to 3 or 4 items;
this gives another speed increase in the (common) case a template has
only a few sections or includes.

I also changed the hashing code to use
[http://murmurhash.googlepages.com/ MurmurHash] everywhere, rather
than the string hash function built into the STL library.  This should
be faster.

All these changes should not be outwardly visible, but they do use
more advanced features of C++ than ctemplate has to date.  This may
result in some problems compiling, or conceivably when running.  If
you see any, please file an
[http://code.google.com/p/google-ctemplate/issues/list issue report].

You can see a full list of changes on the
[http://google-ctemplate.googlecode.com/svn/tags/ctemplate-0.94/ChangeLog
ChangeLog].

=== 20 August 2008 ===

ctemplate 0.91 introduces the beginning of some API changes, as I look
to clean up the API in preparation for ctemplate 1.0.  After 1.0, the
API will remain backwards compatible, but until that time, the API may
change.  Please take a look at the
[http://google-ctemplate.googlecode.com/svn/trunk/ChangeLog ChangeLog]
to see if any of these changes affect you.

One change is the introduction of a new `PerExpandData` class, which
holds some state that was formerly in the `TemplateDictionary` class.
I'm still not sure if this class is a good idea, if it should be
separate from `TemplateDictionary` or a member, or what functionality
should move there (for instance, should `SetTemplateGlobal` move
there, since template-global variables are really, in some sense,
per-expand variables?)  If you have any feedback, ideally based on
your own experience using the current API, feel free to post it at
`google-ctemplate@googlegroups.com`.

ctemplate also has several new features, including the addition of
"separator" sections, and the ability to change the markup character
(from `{{`).  See the
[http://google-ctemplate.googlecode.com/svn/trunk/ChangeLog ChangeLog]
for a complete list, and the
[http://google-ctemplate.googlecode.com/svn/trunk/doc/howto.html howto
documentation] for more details on these new features.