19 Version notes (1.0.914.956)

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 seconds. (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 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.