You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2 lines
13 KiB
HTML
2 lines
13 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><meta name="viewport" content="width=device-width, initial-scale=0.8"/><title>Version notes (2.0.2038.749)</title><link rel="stylesheet" type="text/css" href="scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="racket.css" title="default"/><link rel="stylesheet" type="text/css" href="manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="manual-racket.css" title="default"/><script type="text/javascript" src="scribble-common.js"></script><script type="text/javascript" src="manual-racket.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="scribble-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,"tocview_0");">►</a></td><td></td><td><a href="file:///Users/MB/git/pollen/pollen/scribblings/version-history.html" class="tocviewselflink" data-pltdoc="x">Version notes (2.0.2038.749)</a></td></tr></table></div><div class="tocviewsublistonly" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1 </td><td><a href="file:///Users/MB/git/pollen/pollen/scribblings/version-history.html#%28part._.What_the_version_number_means%29" class="tocviewlink" data-pltdoc="x">What the version number means</a></td></tr><tr><td align="right">2 </td><td><a href="file:///Users/MB/git/pollen/pollen/scribblings/version-history.html#%28part._.Source_code%29" class="tocviewlink" data-pltdoc="x">Source code</a></td></tr><tr><td align="right">3 </td><td><a href="file:///Users/MB/git/pollen/pollen/scribblings/version-history.html#%28part._.Development_policy%29" class="tocviewlink" data-pltdoc="x">Development policy</a></td></tr><tr><td align="right">4 </td><td><a href="file:///Users/MB/git/pollen/pollen/scribblings/version-history.html#%28part._.Changelog%29" class="tocviewlink" data-pltdoc="x">Changelog</a></td></tr></table></div></div></div><div class="tocsub"><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber"></span><a href="#%28part._version-notes%29" class="tocsubseclink" data-pltdoc="x">Version notes (2.0.2038.749)</a></td></tr><tr><td><span class="tocsublinknumber">1<tt> </tt></span><a href="#%28part._.What_the_version_number_means%29" class="tocsubseclink" data-pltdoc="x">What the version number means</a></td></tr><tr><td><span class="tocsublinknumber">2<tt> </tt></span><a href="#%28part._.Source_code%29" class="tocsubseclink" data-pltdoc="x">Source code</a></td></tr><tr><td><span class="tocsublinknumber">3<tt> </tt></span><a href="#%28part._.Development_policy%29" class="tocsubseclink" data-pltdoc="x">Development policy</a></td></tr><tr><td><span class="tocsublinknumber">4<tt> </tt></span><a href="#%28part._.Changelog%29" class="tocsubseclink" data-pltdoc="x">Changelog</a></td></tr><tr><td><span class="tocsublinknumber">4.1<tt> </tt></span><a href="#%28part._.Version_2_0%29" class="tocsubseclink" data-pltdoc="x">Version 2.0</a></td></tr><tr><td><span class="tocsublinknumber">4.2<tt> </tt></span><a href="#%28part._.Version_1_5%29" class="tocsubseclink" data-pltdoc="x">Version 1.5</a></td></tr><tr><td><span class="tocsublinknumber">4.3<tt> </tt></span><a href="#%28part._.Version_1_4%29" class="tocsubseclink" data-pltdoc="x">Version 1.4</a></td></tr><tr><td><span class="tocsublinknumber">4.4<tt> </tt></span><a href="#%28part._.Version_1_3%29" class="tocsubseclink" data-pltdoc="x">Version 1.3</a></td></tr><tr><td><span class="tocsublinknumber">4.5<tt> </tt></span><a href="#%28part._.Version_1_2%29" class="tocsubseclink" data-pltdoc="x">Version 1.2</a></td></tr><tr><td><span class="tocsublinknumber">4.6<tt> </tt></span><a href="#%28part._.Version_1_1%29" class="tocsubseclink" data-pltdoc="x">Version 1.1</a></td></tr><tr><td><span class="tocsublinknumber">4.7<tt> </tt></span><a href="#%28part._.Version_1_0%29" class="tocsubseclink" data-pltdoc="x">Version 1.0</a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="versionbox"><span class="versionNoNav">7.1.0.6</span></div><h2><a name="(part._version-notes)"></a>Version notes (2.0.2038.749)</h2><h3>1<tt> </tt><a name="(part._.What_the_version_number_means)"></a>What the version number means</h3><p>Consistent with Racket’s <font class="badlink">version-numbering system</font>, the first digit reflects major updates to Pollen that break backward compatibility. The second digit reflects feature updates that don’t affect existing features.</p><p>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 <span class="stt">"info.rkt"</span> is just the major + minor digits.)</p><h3>2<tt> </tt><a name="(part._.Source_code)"></a>Source code</h3><p>Pollen’s source code is <a href="http://github.com/mbutterick/pollen">available from this Git repo</a>. The <span class="stt">MASTER</span> branch of the repo will always contain the most recent stable version.</p><p>Racket’s <a href="http://pkg.racket-lang.org">package catalog</a> relies on this branch, so if you get your updates with <span class="stt">raco pkg update pollen</span>, you’ll get the most recent updates from this branch.</p><p>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.</p><h3>3<tt> </tt><a name="(part._.Development_policy)"></a>Development policy</h3><p>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.</p><h3>4<tt> </tt><a name="(part._.Changelog)"></a>Changelog</h3><h4>4.1<tt> </tt><a name="(part._.Version_2_0)"></a>Version 2.0</h4><p>Dropped support for Racket versions earlier than 6.3.</p><p>Added <span class="RktSym"><span class="badlink"><span class="RktValLink">setup:allow-unbound-ids?</span></span></span>.</p><h4>4.2<tt> </tt><a name="(part._.Version_1_5)"></a>Version 1.5</h4><p>Added <span class="RktSym"><span class="badlink"><span class="RktValLink">setup:trim-whitespace?</span></span></span>.</p><h4>4.3<tt> </tt><a name="(part._.Version_1_4)"></a>Version 1.4</h4><p>Added <span class="RktSym"><span class="badlink"><span class="RktValLink">setup:cache-watchlist</span></span></span>, <span class="RktSym"><span class="badlink"><span class="RktValLink">for/splice</span></span></span>, <span class="RktSym"><span class="badlink"><span class="RktValLink">for*/splice</span></span></span>, <span class="RktSym"><span class="badlink"><span class="RktValLink">current-metas</span></span></span>.</p><h4>4.4<tt> </tt><a name="(part._.Version_1_3)"></a>Version 1.3</h4><p>Various optimizations and bugfixes.</p><h4>4.5<tt> </tt><a name="(part._.Version_1_2)"></a>Version 1.2</h4><p><font class="badlink"><span class="stt">raco pollen</span></font>: Added <span class="RktSym"><span class="nobreak">--l</span>ocal</span> option to <font class="badlink">(part ("(lib pollen/scribblings/pollen.scrbl)" "raco_pollen_start"))</font>.</p><p>Various optimizations and bugfixes.</p><h4>4.6<tt> </tt><a name="(part._.Version_1_1)"></a>Version 1.1</h4><p><span style="font-weight: bold">New features</span></p><p><font class="badlink"><span class="stt">raco pollen</span></font>: Added <span class="RktSym"><span class="nobreak">--r</span>ecursive</span> option to <font class="badlink">(part ("(lib pollen/scribblings/pollen.scrbl)" "raco_pollen_render"))</font>.</p><p><font class="badlink"><span class="RktModLink"><span class="RktSym">pollen/setup</span></span></font>: <span class="RktSym"><span class="badlink"><span class="RktValLink">setup:omitted-path?</span></span></span> replaces <span class="RktSym"><span class="badlink"><span class="RktValLink">setup:unpublished-path?</span></span></span>, and <span class="RktSym"><span class="badlink"><span class="RktValLink">setup:extra-path?</span></span></span> replaces <span class="RktSym"><span class="badlink"><span class="RktValLink">setup:extra-published-path?</span></span></span>. These settings are used during both render and publish operations. (The old names will still work, however.)</p><p>Added <span class="RktSym"><span class="badlink"><span class="RktValLink">setup:publish-directory</span></span></span>, which can be used to set a default publish directory.</p><h4>4.7<tt> </tt><a name="(part._.Version_1_0)"></a>Version 1.0</h4><p><span style="font-weight: bold">New features</span></p><p><font class="badlink"><span class="RktModLink"><span class="RktSym">pollen/cache</span></span></font>: <span class="RktSym"><span class="badlink"><span class="RktValLink">cached-doc</span></span></span> and <span class="RktSym"><span class="badlink"><span class="RktValLink">cached-metas</span></span></span> are the preferred way to retrieve data from a Pollen source file.</p><p>The <font class="badlink"><span class="RktModLink"><span class="RktSym">pollen/core</span></span></font> module has been added, the new home for functions that once lived in <font class="badlink"><span class="RktModLink"><span class="RktSym">pollen/template</span></span></font>. Also new splicing tag <span class="RktSym"><span class="badlink"><span class="RktValLink">@</span></span></span> and <span class="RktSym"><span class="badlink"><span class="RktValLink">when/splice</span></span></span> macro.</p><p><font class="badlink"><span class="RktModLink"><span class="RktSym">pollen/setup</span></span></font> replaces <span class="stt">pollen/world</span>. <font class="badlink"><span class="RktModLink"><span class="RktSym">pollen/setup</span></span></font> values can be overridden with a <span class="RktSym">setup</span> submodule. Parameter names are no longer prefixed.</p><p><span style="font-weight: bold">Backward incompatibilities</span></p><p><font class="badlink"><span class="RktModLink"><span class="RktSym">pollen/cache</span></span></font>: <span class="stt">cached-require</span> is deprecated. Use <span class="RktSym"><span class="badlink"><span class="RktValLink">cached-doc</span></span></span> or <span class="RktSym"><span class="badlink"><span class="RktValLink">cached-metas</span></span></span>.</p><p><font class="badlink"><span class="RktModLink"><span class="RktSym">pollen/template</span></span></font>: functions like <span class="RktSym"><span class="badlink"><span class="RktValLink">get-doc</span></span></span>, <span class="RktSym"><span class="badlink"><span class="RktValLink">get-metas</span></span></span>, and the <span class="RktSym"><span class="badlink"><span class="RktValLink">select</span></span></span> functions have been moved to <font class="badlink"><span class="RktModLink"><span class="RktSym">pollen/core</span></span></font>. <span class="stt">when/block</span> is deprecated in favor of <span class="RktSym"><span class="badlink"><span class="RktValLink">when/splice</span></span></span>.</p><p><font class="badlink"><span class="RktModLink"><span class="RktSym">pollen/template</span></span></font>: <span class="stt">detect-paragraphs</span> and <span class="stt">detect-linebreaks</span> have been renamed <span class="RktSym"><span class="badlink"><span class="RktValLink">decode-paragraphs</span></span></span> and <span class="RktSym"><span class="badlink"><span class="RktValLink">decode-linebreaks</span></span></span>. Typography functions like <span class="RktSym"><span class="badlink"><span class="RktValLink">smart-quotes</span></span></span> and <span class="RktSym"><span class="badlink"><span class="RktValLink">smart-dashes</span></span></span> have been moved to <font class="badlink"><span class="RktModLink"><span class="RktSym">pollen/unstable/typography</span></span></font>. <span class="RktSym">register-block-tags</span> is gone — override <span class="RktSym"><span class="badlink"><span class="RktValLink">default-block-tags</span></span></span> instead.</p><p><font class="badlink"><span class="RktModLink"><span class="RktSym">pollen/file</span></span></font>: refined to a more carefully curated set of functions.</p><p><font class="badlink"><span class="RktModLink"><span class="RktSym">pollen/template</span></span></font>: Pollen now supports any output formats, so this module has been broken into format-specific versions. For now, the only submodule is <font class="badlink"><span class="RktModLink"><span class="RktSym">pollen/template/html</span></span></font>, the home of <span class="RktSym"><span class="badlink"><span class="RktValLink">->html</span></span></span>.</p><p><span class="stt">pollen/world</span>: superseded by <font class="badlink"><span class="RktModLink"><span class="RktSym">pollen/setup</span></span></font> (see above). The <span class="RktSym">config</span> submodule in a <span class="stt">"pollen.rkt"</span> will no longer work.</p></div></div><div id="contextindicator"> </div></body></html> |