19 Version notes (2.2.2469.586)
19.1 What the version number means
Consistent with Racket’s version-numbering system, the first digit reflects major updates to Pollen that break backward compatibility. The second digit reflects feature updates that don’t affect existing features.
Inconsistent with this system, Pollen’s version also appends a build number, which is the age of the software in days and minutes. (The official version reported in Pollen’s "info.rkt" is just the major + minor digits.)
19.2 Source code
Pollen’s source code is available from this Git repo. The MASTER branch of the repo will always contain the most recent stable version.
Racket’s package catalog relies on this branch, so if you get your updates with raco pkg update pollen, you’ll get the most recent updates from this branch.
I will add Git tags to commits where the major or minor version changed, so if you need to rebuild an earlier version, you can.
19.3 Development policy
Beyond keeping the commit history available, I make no promise to maintain the public interface in its current state. I will avoid unnecessary upheaval, of course. But my goal is to make the system more capable and stable, not to permanently burden it with my current level of ignorance.
19.4 Changelog
19.4.1 Version 2.2
Added --null and --dry-run switches to raco pollen render.
Extended the define-meta form to allow multiple key–value pairs.
Changed handling of current-metas so that values can be updated by tag functions during the evaluation of a source file.
Switched to MIT license.
19.4.2 Version 2.1
Added setup:envvar-watchlist.
raco pollen: Introduced support for parallel processing by adding --parallel and --jobs options to raco pollen setup and raco pollen render.
19.4.3 Version 2.0
Dropped support for Racket versions earlier than 6.3.
Added setup:allow-unbound-ids?.
19.4.4 Version 1.5
Added setup:trim-whitespace?.
19.4.5 Version 1.4
Added setup:cache-watchlist, for/splice, for*/splice, current-metas.
19.4.6 Version 1.3
Various optimizations and bugfixes.
19.4.7 Version 1.2
raco pollen: Added --local option to raco pollen start.
Various optimizations and bugfixes.
19.4.8 Version 1.1
New features
raco pollen: Added --recursive option to raco pollen render.
pollen/setup: setup:omitted-path? replaces setup:unpublished-path?, and setup:extra-path? replaces setup:extra-published-path?. These settings are used during both render and publish operations. (The old names will still work, however.)
Added setup:publish-directory, which can be used to set a default publish directory.
19.4.9 Version 1.0
New features
pollen/cache: cached-doc and cached-metas are the preferred way to retrieve data from a Pollen source file.
The pollen/core module has been added, the new home for functions that once lived in pollen/template. Also new splicing tag @ and when/splice macro.
pollen/setup replaces pollen/world. pollen/setup values can be overridden with a setup submodule. Parameter names are no longer prefixed.
Backward incompatibilities
pollen/cache: cached-require is deprecated. Use cached-doc or cached-metas.
pollen/template: functions like get-doc, get-metas, and the select functions have been moved to pollen/core. when/block is deprecated in favor of when/splice.
pollen/template: detect-paragraphs and detect-linebreaks have been renamed decode-paragraphs and decode-linebreaks. Typography functions like smart-quotes and smart-dashes have been moved to pollen/unstable/typography. register-block-tags is gone — override default-block-tags instead.
pollen/file: refined to a more carefully curated set of functions.
pollen/template: Pollen now supports any output formats, so this module has been broken into format-specific versions. For now, the only submodule is pollen/template/html, the home of ->html.
pollen/world: superseded by pollen/setup (see above). The config submodule in a "pollen.rkt" will no longer work.