Permalink
Browse files

* Add changelog documentation.

  • Loading branch information...
jjensen committed Nov 19, 2008
1 parent 03a0709 commit c115f70e7ee9aca0a711527f342e8d9340ae019c
View
@@ -16,7 +16,7 @@ ENABLED_SECTIONS = logo_on
ENABLE_PREPROCESSING = NO
CASE_SENSE_NAMES = NO
IMAGE_PATH = .
-INPUT = index.dox bugs.dox builtin_rules.dox builtin_variables.dox dependency_cache.dox file_cache.dox improvements.dox jam_language.dox jambase_rules.dox jamtoworkspace.dox language_variables.dox lua_support.dox multiple_passes.dox quick_start.dox scripts.dox usage.dox warnings_and_errors.dox
+INPUT = index.dox bugs.dox builtin_rules.dox builtin_variables.dox changelog.dox dependency_cache.dox file_cache.dox improvements.dox jam_language.dox jambase_rules.dox jamtoworkspace.dox language_variables.dox lua_support.dox multiple_passes.dox quick_start.dox scripts.dox usage.dox warnings_and_errors.dox
TAGFILES =
ALLEXTERNALS = NO
SEARCHENGINE = NO
View
@@ -0,0 +1,122 @@
+/*! \page changelog Changelog
+
+\section version0_2 Version 0.2
+
+<h3>New features for 0.2:</h3>
+
+- Visual Studio 2005 and 2008 solution and vcproj files.
+
+<h3>Documentation:</h3>
+
+- In some manner, every JamPlus feature is documented (we hope).
+
+<h3>Jam Executable:</h3>
+
+- Fixed a 'don't know how to make' bug when trying to create the subdirectory . (period)
+- Fixed an MD5 network cache issue in filecache_fillvalues. Reported by Jan van Valburg.
+- Fixed the -T command line option which, in turn, fixed the -t command line option.
+- Added the MightNotUpdate flag to work as a single target alternate to Needs.
+- Fixed directory file pattern match for $(dir/:W).
+- Fixed \ref language_variable_expansion "variable expansion" modifier issues when extra colons are present.
+- Altered the way the :I= and :X= \ref language_variable_expansion "variable expansion" modifiers work to better fit the documentation.
+- Addded the :T \ref language_variable_expansion "variable expansion" modifier to expand to the bound name.
+- For the :W modifier, grab the files earlier in the \ref language_variable_expansion "variable expansion".
+- Only compile a given regular expression once. This existed in the original version of the header scanning code but not the HDRPIPE version.
+- Optimized retrieval of directories from the timestamp() code. This results in a very limited number of file queries for directories that cannot possibly exist. See OPT_TIMESTAMP_EXTENDED_PARENT_CHECK_EXT.
+- Fixed path delimiter in pathunix.c.
+- Made \ref rule_UseMD5Callback "UseMD5Callback" a built-in rule, instead of having it sit in the Jambase.
+- Removed the need to compile and link against the LuaPlus library when the Lua support was turned on.
+- Added Subst rule, based on Lua's string.gsub.
+- Added CppCompileOptions.
+- Bug fix for multiple passes.
+
+
+
+
+
+
+<h3>Jambase:</h3>
+
+- Re-added basic MinGW support, accessible by setting the \c COMPILER variable to \c mingw.
+- \ref rule_SubInclude "SubIncluding" a given Jamfile only happens once.
+- Exits when an incorrect platform or configuration is specified.
+- Added \ref rule_OutputPostfix "OutputPostfix", \ref rule_OutputPostfixClear "OutputPostfixClear", and \ref rule_OutputSuffix "OutputSuffix".
+- For Visual Studio 2005, made the Microsoft .NET SDK include and library paths available.
+- WINDOWS was not a side-by-side #define with WIN32. Fixed.
+- Attempt to load a Jamrules-style file called $(_top).jamrules.
+- Fix import library dependencies for DLLs.
+- Allow an additional optional \ref rule_SubDir "SubDir" parameter denoting a 'target' in the grist. LOCATE_SOURCE, LOCATE_TARGET, and SOURCE_GRIST all append it.
+- \ref rule_IncludeModule "IncludeModule": Modules can only be included once.
+- Added \ref rule_ReferenceDirectories "ReferenceDirectories" for .NET references.
+- Added \ref rule_BatchCompileGroupSize "BatchCompileGroupSize". The default batch compilation group size is unlimited.
+- Fixed precompiled header support to allow precompiled header .cpp files with relative paths attached to the name. Uses the \ref built_in_variables_binding_binding_search_locate "BINDING" to control the output location.
+- Assign \c LINK_TARGET variable to the \c TARGET when setting up an executable or shared library link, so later post-build steps can get access to the binary without a complex look up.
+- \ref rule_Library "Library's" \c OPTIONS now accepts 'noexportlib'.
+- Re-added \ref rule_ObjectCFlags "ObjectCFlags" and \ref rule_ObjectC++Flags "ObjectC++Flags".
+- Added \c rule_FGristDirectories "FGristDirectories" rule.
+- \ref rule_Lump "Lump" rule handles .cxx.
+- \ref rule_PrecompiledHeader "PrecompiledHeader" rule accepts a shortened version where the .cpp and .h are determined by a single parameter.
+- Optimization - Don't scan inside .lib files, since the .obj files are present by default.
+- Major C/C++ compilation optimizations.
+- Fix support for .c precompiled headers.
+- Add \ref rule_CRuntimeType "CRuntimeType" to change between statically linked and dynamically linked C runtimes for Visual C++.
+- Remove VC5 support, since I have no way of testing it.
+- Change grists to be project level and not subdirectory level.
+- LINKDIRECTORIES was set up wrong and put in the global variable list. This is corrected now, and the initial LINKDIRECTORIES is assigned to *.
+- Moved \c DEFINES down with the platform they represent.
+- Change <dir> grist to <!dir!>.
+- Minor clean up for calculation of \c MSVCNT and \c MSVCNT_PATH.
+- Moved the \c MSVCNT_PATH first in the \c PATH.
+- Get rid of top-level dependencies that don't mean anything.
+- Removed unused script and targets.
+
+
+
+
+<h3>Jam Modules:</h3>
+
+- MFC module: Removed automatic ATL and MFC include and library paths. \ref rule_IncludeModule "IncludeModule" \c MFC to access the paths and apply ATL/MFC support to a target.
+- DirectX module: Removed automatic DirectX include and library paths and added DirectX module. \ref rule_IncludeModule "IncludeModule" \c DirectX to apply DirectX support to a target.
+- wxWidgets module: Minor fix when generating the target name.
+- wxWidgets module: Added contrib libraries support. Only supports stc for now.
+- DotNet module: Add \c StrongName rule.
+- CopyDirectory and CopyFile modules: When generating a workspace that uses \ref rule_CopyDirectory "CopyDirectory" and \ref rule_CopyFile "CopyFile", files would get copied. Both rules now guard against that during workspace generation.
+
+
+
+
+
+<h3>JamToWorkspace:</h3>
+
+- For the source Jamfile path, handle the case where Jamfile.jam is not specified.
+- When a project is specified as existing in a workspace but has not been defined, pop up an error message instead of crashing.
+- Handle quotes inside the preprocessor #defines.
+- Fix JamToWorkspace conversion when the target name is implicit and specified through ActiveProject.
+
+
+
+
+<h3>Samples:</h3>
+
+- Make the batch maxtargets sample a little more clear.
+- helloworld test that is slightly more complicated than the helloworld sample app.
+- Add md5test.jam in tests/md5/.
+- Add tests/expand/expandtests.jam.
+- Very simple generatedheader test added.
+- tests/source_and_jamfiles_separate example added.
+- Batch file in samples/sharedlib/ to create a CodeBlocks MinGW project.
+- Lua parsing phase examples in tests/lua/testluaparser.jam and tests/lua/testluaparser.jam.lua
+- Added tutorial 02-helloworld-static.
+- Useful output in the filecache_luamd5callback test.
+- tests/compile_outputastree/ - Fix obj/ output location.
+- Add .fx compilation sample.
+
+
+
+
+<hr>
+\section version0_1 Version 0.1
+
+- Initial release.
+
+*/
View
@@ -10,7 +10,7 @@ <h1><a class="anchor" name="bugs">Bugs, Limitations </a></h1>The -j flag can cau
For parallel building to be successful, the dependencies among files must be properly spelled out, as targets tend to get built in a quickest-first ordering. Also, beware of un-parallelizable commands that drop fixed-named files into the current directory, like <b>yacc</b>(1) does.<p>
With the <code>-j</code> flag, errors from failed commands can get staggeringly mixed up.<p>
A poorly set <code>$(JAMSHELL)</code> is likely to result in silent failure. </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Wed Oct 29 23:32:26 2008 for JamPlus manual by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Tue Nov 18 20:27:34 2008 for JamPlus manual by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.7 </small></address>
</body>
@@ -385,7 +385,7 @@ <h2><a class="anchor" name="rule_W32_GETREG">
</pre></div><p>
<hr>
</div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Nov 18 00:46:18 2008 for JamPlus manual by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Tue Nov 18 20:27:34 2008 for JamPlus manual by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.7 </small></address>
</body>
@@ -111,7 +111,7 @@ <h2><a class="anchor" name="built_in_variables_jamshell">
</pre></div><p>
<hr>
</div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Tue Nov 18 01:03:29 2008 for JamPlus manual by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Tue Nov 18 20:27:35 2008 for JamPlus manual by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.7 </small></address>
</body>
View
@@ -0,0 +1,56 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+<title>JamPlus manual: Changelog</title>
+<link href="doxygen.css" rel="stylesheet" type="text/css">
+<link href="tabs.css" rel="stylesheet" type="text/css">
+</head><body>
+<!-- Generated by Doxygen 1.5.7 -->
+<div class="contents">
+<h1><a class="anchor" name="changelog">Changelog </a></h1><h2><a class="anchor" name="version0_2">
+Version 0.2</a></h2>
+<h3>New features for 0.2:</h3>
+<p>
+<ul>
+<li>Visual Studio 2005 and 2008 solution and vcproj files.</li></ul>
+<p>
+<h3>Documentation:</h3>
+<p>
+<ul>
+<li>In some manner, every JamPlus feature is documented (we hope).</li></ul>
+<p>
+<h3>Jam Executable:</h3>
+<p>
+<ul>
+<li>Fixed a 'don't know how to make' bug when trying to create the subdirectory . (period)</li><li>Fixed an MD5 network cache issue in filecache_fillvalues. Reported by Jan van Valburg.</li><li>Fixed the -T command line option which, in turn, fixed the -t command line option.</li><li>Added the MightNotUpdate flag to work as a single target alternate to Needs.</li><li>Fixed directory file pattern match for $(dir/:W).</li><li>Fixed <a class="el" href="language_variables.html#language_variable_expansion">variable expansion</a> modifier issues when extra colons are present.</li><li>Altered the way the :I= and :X= <a class="el" href="language_variables.html#language_variable_expansion">variable expansion</a> modifiers work to better fit the documentation.</li><li>Addded the :T <a class="el" href="language_variables.html#language_variable_expansion">variable expansion</a> modifier to expand to the bound name.</li><li>For the :W modifier, grab the files earlier in the <a class="el" href="language_variables.html#language_variable_expansion">variable expansion</a>.</li><li>Only compile a given regular expression once. This existed in the original version of the header scanning code but not the HDRPIPE version.</li><li>Optimized retrieval of directories from the timestamp() code. This results in a very limited number of file queries for directories that cannot possibly exist. See OPT_TIMESTAMP_EXTENDED_PARENT_CHECK_EXT.</li><li>Fixed path delimiter in pathunix.c.</li><li>Made <a class="el" href="builtin_rules.html#rule_UseMD5Callback">UseMD5Callback</a> a built-in rule, instead of having it sit in the Jambase.</li><li>Removed the need to compile and link against the LuaPlus library when the Lua support was turned on.</li><li>Added Subst rule, based on Lua's string.gsub.</li><li>Added CppCompileOptions.</li><li>Bug fix for multiple passes.</li></ul>
+<p>
+<h3>Jambase:</h3>
+<p>
+<ul>
+<li>Re-added basic MinGW support, accessible by setting the <code>COMPILER</code> variable to <code>mingw</code>.</li><li><a class="el" href="jambase_rules.html#rule_SubInclude">SubIncluding</a> a given Jamfile only happens once.</li><li>Exits when an incorrect platform or configuration is specified.</li><li>Added <a class="el" href="jambase_rules.html#rule_OutputPostfix">OutputPostfix</a>, OutputPostfixClear, and <a class="el" href="jambase_rules.html#rule_OutputSuffix">OutputSuffix</a>.</li><li>For Visual Studio 2005, made the Microsoft .NET SDK include and library paths available.</li><li>WINDOWS was not a side-by-side define with WIN32. Fixed.</li><li>Attempt to load a Jamrules-style file called .jamrules.</li><li>Fix import library dependencies for DLLs.</li><li>Allow an additional optional <a class="el" href="jambase_rules.html#rule_SubDir">SubDir</a> parameter denoting a 'target' in the grist. LOCATE_SOURCE, LOCATE_TARGET, and SOURCE_GRIST all append it.</li><li><a class="el" href="jambase_rules.html#rule_IncludeModule">IncludeModule</a>: Modules can only be included once.</li><li>Added ReferenceDirectories for .NET references.</li><li>Added BatchCompileGroupSize. The default batch compilation group size is unlimited.</li><li>Fixed precompiled header support to allow precompiled header .cpp files with relative paths attached to the name. Uses the <a class="el" href="builtin_variables.html#built_in_variables_binding_binding_search_locate">BINDING</a> to control the output location.</li><li>Assign <code>LINK_TARGET</code> variable to the <code>TARGET</code> when setting up an executable or shared library link, so later post-build steps can get access to the binary without a complex look up.</li><li><a class="el" href="jambase_rules.html#rule_Library">Library's</a> <code>OPTIONS</code> now accepts 'noexportlib'.</li><li>Re-added <a class="el" href="jambase_rules.html#rule_ObjectCFlags">ObjectCFlags</a> and rule_ObjectC++Flags "ObjectC++Flags".</li><li>Added <code>rule_FGristDirectories</code> "FGristDirectories" rule.</li><li><a class="el" href="jambase_rules.html#rule_Lump">Lump</a> rule handles .cxx.</li><li><a class="el" href="jambase_rules.html#rule_PrecompiledHeader">PrecompiledHeader</a> rule accepts a shortened version where the .cpp and .h are determined by a single parameter.</li><li>Optimization - Don't scan inside .lib files, since the .obj files are present by default.</li><li>Major C/C++ compilation optimizations.</li><li>Fix support for .c precompiled headers.</li><li>Add <a class="el" href="jambase_rules.html#rule_CRuntimeType">CRuntimeType</a> to change between statically linked and dynamically linked C runtimes for Visual C++.</li><li>Remove VC5 support, since I have no way of testing it.</li><li>Change grists to be project level and not subdirectory level.</li><li>LINKDIRECTORIES was set up wrong and put in the global variable list. This is corrected now, and the initial LINKDIRECTORIES is assigned to *.</li><li>Moved <code>DEFINES</code> down with the platform they represent.</li><li>Change &lt;dir&gt; grist to &lt;!dir!&gt;.</li><li>Minor clean up for calculation of <code>MSVCNT</code> and <code>MSVCNT_PATH</code>.</li><li>Moved the <code>MSVCNT_PATH</code> first in the <code>PATH</code>.</li><li>Get rid of top-level dependencies that don't mean anything.</li><li>Removed unused script and targets.</li></ul>
+<p>
+<h3>Jam Modules:</h3>
+<p>
+<ul>
+<li>MFC module: Removed automatic ATL and MFC include and library paths. <a class="el" href="jambase_rules.html#rule_IncludeModule">IncludeModule</a> <code>MFC</code> to access the paths and apply ATL/MFC support to a target.</li><li>DirectX module: Removed automatic DirectX include and library paths and added DirectX module. <a class="el" href="jambase_rules.html#rule_IncludeModule">IncludeModule</a> <code>DirectX</code> to apply DirectX support to a target.</li><li>wxWidgets module: Minor fix when generating the target name.</li><li>wxWidgets module: Added contrib libraries support. Only supports stc for now.</li><li>DotNet module: Add <code>StrongName</code> rule.</li><li>CopyDirectory and CopyFile modules: When generating a workspace that uses CopyDirectory and CopyFile, files would get copied. Both rules now guard against that during workspace generation.</li></ul>
+<p>
+<h3>JamToWorkspace:</h3>
+<p>
+<ul>
+<li>For the source Jamfile path, handle the case where Jamfile.jam is not specified.</li><li>When a project is specified as existing in a workspace but has not been defined, pop up an error message instead of crashing.</li><li>Handle quotes inside the preprocessor defines.</li><li>Fix JamToWorkspace conversion when the target name is implicit and specified through ActiveProject.</li></ul>
+<p>
+<h3>Samples:</h3>
+<p>
+<ul>
+<li>Make the batch maxtargets sample a little more clear.</li><li>helloworld test that is slightly more complicated than the helloworld sample app.</li><li>Add md5test.jam in tests/md5/.</li><li>Add tests/expand/expandtests.jam.</li><li>Very simple generatedheader test added.</li><li>tests/source_and_jamfiles_separate example added.</li><li>Batch file in samples/sharedlib/ to create a CodeBlocks MinGW project.</li><li>Lua parsing phase examples in tests/lua/testluaparser.jam and tests/lua/testluaparser.jam.lua</li><li>Added tutorial 02-helloworld-static.</li><li>Useful output in the filecache_luamd5callback test.</li><li>tests/compile_outputastree/ - Fix obj/ output location.</li><li>Add .fx compilation sample.</li></ul>
+<p>
+<hr>
+ <h2><a class="anchor" name="version0_1">
+Version 0.1</a></h2>
+<ul>
+<li>Initial release. </li></ul>
+</div>
+<hr size="1"><address style="text-align: right;"><small>Generated on Tue Nov 18 20:27:35 2008 for JamPlus manual by&nbsp;
+<a href="http://www.doxygen.org/index.html">
+<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.7 </small></address>
+</body>
+</html>
@@ -38,7 +38,7 @@ <h1><a class="anchor" name="dependency_cache">Dependency Cache </a></h1><h2><a c
<li>Each cache entry is given an "age" which is the maximum number of times a given header cache entry can go unused before it is purged from the cache. This helps clean up old entries in the .jamdeps file when files move around or are removed from your project.</li></ul>
<p>
You control the maximum age with the DEPCACHEMAXAGE variable. If set to 0, no cache aging is performed. Otherwise it is the number of times <b>Jam</b> must be run before an unused cache entry is purged. The default for DEPCACHEMAXAGE if left unset is 100. </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Sat Nov 15 01:51:59 2008 for JamPlus manual by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Tue Nov 18 20:27:35 2008 for JamPlus manual by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.7 </small></address>
</body>
@@ -83,7 +83,7 @@ <h2><a class="anchor" name="file_cache_content_md5sums">
return md5sum:digest(true)
end
</pre></div> </div>
-<hr size="1"><address style="text-align: right;"><small>Generated on Sat Nov 15 00:36:26 2008 for JamPlus manual by&nbsp;
+<hr size="1"><address style="text-align: right;"><small>Generated on Tue Nov 18 20:27:35 2008 for JamPlus manual by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.7 </small></address>
</body>
Oops, something went wrong.

0 comments on commit c115f70

Please sign in to comment.