<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="content-type" content="text/html;charset=iso-8859-1">
<title>The OMake CHANGELOG</title>
</head>
<body bgcolor="#ffffff" text="#000000">
<table><tr><td><img src="images/omake.gif" alt="" width="300" height="137" border="0"></td>
<td width="50px" valign="top"></td>
<td valign="top">
<a href="index.html">OMake Home</a><br>
<a href="omake.html">Documentation</a><br>
<a href="download.html">Download</a><br>
<a href="omake_papers.html">Publications</a></br>
<a href="omake_lists.html">Mailing lists</a><br>
<a href="omake_users.html">Users and projects</a><br>
<a href="http://bugzilla.metaprl.org/">Bugzilla</a><br>
<a href="http://svn.metaprl.org/viewcvs/mojave/omake-branches/0.9.8.x/">Browse sources</a><br>
Changelog
<a
href="http://svn.metaprl.org/viewcvs/*checkout*/mojave/omake-branches/0.9.8.x/CHANGELOG.txt">summary</a>,
<u>verbose</u>
</td>
</tr></table>
<h2> OMake Change Log</h2>
<p>Jump to version
<a href="#0.9.8.5">0.9.8.5</a>,
<a href="#0.9.8.4">0.9.8.4</a>,
<a href="#0.9.8.3">0.9.8.3</a>,
<a href="#0.9.8.1">0.9.8.1</a>,
<a href="#0.9.8">0.9.8</a>,
<a href="#0.9.6.9">0.9.6.9</a>,
<a href="#0.9.6.8">0.9.6.8</a>,
<a href="#0.9.6.7">0.9.6.7</a>,
<a href="#0.9.6.6">0.9.6.6</a>,
<a href="#0.9.6.5">0.9.6.5</a>,
<a href="#0.9.6">0.9.6</a>,
<a href="#0.9.4">0.9.4</a>,
<a href="#0.9.3">0.9.3</a>,
<a href="#0.9.2">0.9.2</a>.
<p>See also <a
href="http://svn.metaprl.org/viewcvs/*checkout*/mojave/omake-branches/0.9.8.x/CHANGELOG.txt">the
brief summary change log</a>.
<!--
<li><b>[Experimental]</b> Object methods can now export their fields back into the parent object.
For example, <pre>
Z. =
x = 1
f() =
x = 2
export
Z.f()
echo $(Z.x)
# Prints "2"
</pre> This works with arbitrary levels of nesting.
-->
<h3><a name="0.9.8.5">Version 0.9.8.5 (August 7, 2007)</a></h3>
This is a somehat major feature enhancement release
<ul>
<li>Made sure that Ctrl-C would correctly stop OMake on Windows, making it
much easier to use <tt>-p</tt> and <tt>-P</tt> on Windows.
<li>Added <tt>export</tt> sections.
<ul>
<li>Exports take effect for all sections within their static scope. For
example, <pre>
section
export
section
public.X = 1
println($X) # Prints 1
</pre>
<li>In addition, exports augment any existing exports. For example,
<pre>
section
public.X = 1
public.Y = 2
export X
section
X = 3
Y = 4
export Y
# X is 3
# Y is 2
</pre>
<li>Variable definitions also allow exports. For example, <pre>
public.X = 1
public.f() =
X = 2
export
public.Y = $f
# X is 2
# Y is 2
</pre>
Note: this is, of course, not the same as imperative programming, because
functions can always choose not to export. In particular, the string
"functions" do not export. <pre>
public.X = 1
export X
public.f() =
X = 2
Y = $"$f"
# X = 1
# Y = 2
</pre>
</ul>
<li>Added <tt>.STATIC</tt> and <tt>.MEMO</tt> rules - an enhanced, yet lazy
(delayed) version of the <tt>static.</tt> sections.
<ul>
<li>Basic usage: <pre>
.STATIC:
println(foo)
X = 1
Y = $X
</pre>
The variable <tt>X</tt> is exported, with a "delayed" value. The rule is
only evaluated if the value for <tt>$X</tt> is needed, but it is lazy. The definition of Y does not force evaluation.
<li><tt>.STATIC</tt> rules allow dependencies, for example:<pre>
.STATIC: x.input
X = $(expensive-function x.input)
</pre> This is be evaluated if <tt>x.input</tt> changes and <tt>X</tt> is forced.
<li><tt>.STATIC</tt> rules also allow explicitly specifying which
variables are exported, for example: <pre>
.STATIC: X: x.input
Y = 1
X = $Y
</pre>Here, <tt>Y</tt> is not exported from the section.
<li>By default, if a <tt>.STATIC</tt> rule is evaluated several times (for example,
if the <tt>.STATIC</tt> rule is present inside a body of a function that is
called several times), the result is the <em>same</em> set of delayed
variables.
<li><tt>.STATIC</tt> rules can have <tt>:key:</tt> dependency that
specify whether we are getting the same set of delayed variables or not, when
re-executing the same <tt>.STATIC</tt> rule. For example, <pre>
g(x) =
eprintln($"g($x)")
add($x, 1)
f(x) =
.STATIC: :key: $x
y = $(g $x)
value $y
println($(f 1))
println($(f 2))
println($(f 1))
</pre> will call function <tt>g</tt> twice - only once for each argument,
printing: <pre>
g(1)
2
g(2)
3
2</pre>
<li><tt>.STATIC</tt> rules have their values are stored in <tt>.omakedb</tt>, not in <tt>.omc</tt>, so
they are distinct between different projects (while the <tt>static.</tt>
sections in common library files are shared between projects).
<li>The <tt>.MEMO</tt> rules are very similar to the <tt>.STATIC</tt>,
except the <tt>.MEMO</tt> values are <em>not</em> preserved across runs of
OMake. They are, however, preserved for the duration of OMake session.
</ul>
<li>Fields in sub-objects can now be referenced directly using the
<tt>$(X.Y.Z)</tt> form (<a
href="http://bugzilla.metaprl.org/show_bug.cgi?id=580">bug 580</a>). For example, <pre>
X. =
Y. =
Z. =
x = 1
X.Y.Z.y = 2
X.Y.Z.f() =
value $(add $x, $y)
echo $(X.Y.Z.f)
# prints "3"</pre>
<li>Allow functions to take their bodies as array arguments (<a
href="http://bugzilla.metaprl.org/show_bug.cgi?id=645">bug 645</a>). The
<tt>[...]</tt> argument to a function call stands for an array body and
<tt>...</tt> stands for a normal body argument. For example,<pre>
X =
file([...])
a
b
c
- : <array
/Users/jyh/projects/omake/0.9.8.x/a : File
/Users/jyh/projects/omake/0.9.8.x/b : File
/Users/jyh/projects/omake/0.9.8.x/c : File>
: Array
</pre>
<li>Corrected several cases where the <tt>exit</tt> shell alias would not
do the right thing. For example, pipelines like <tt>false || exit 5</tt> will
now return the correct exit code.
<li>Added a <tt>build</tt> function, so that builds can be performed from
<tt>osh</tt> scripts (the function may be called only from <tt>osh</tt>).
<li><tt>build/C.om</tt>: new functions for building DLLs:
<tt>DynamicCLibrary</tt>, <tt>DynamicCLibraryCopy</tt>,
<tt>DynamicCLibraryInstall</tt>, <tt>DynamicCXXLibrary</tt>,
<tt>DynamicCXXLibraryCXXopy</tt>, <tt>DynamicCXXLibraryInstall</tt>.
<li>New built-in functions: <tt>sort</tt> (AKA <tt>Sequence.sort</tt>), <tt>replace-nth</tt>,
<tt>input-line</tt> (AKA <tt>InChannel.readln</tt>), <tt>channel-name</tt>
(AKA <tt>Channel.name</tt>), <tt>sequence-sub</tt> (AKA <tt>Sequence.sub</tt>).
<li>New <tt>Shell</tt> alias: <tt>Shell.pwd</tt>
<li>The <tt>defined</tt>, <tt>getvar</tt>, <tt>setvar</tt> now allow
qualified names (<em>e.g</em> <tt>public.x</tt> or <tt>private.y</tt>).
<li>Built-in <tt>awk</tt> will now set the <tt>FILENAME</tt> and
<tt>FNR</tt> ("line number") variables when evaluating its body.
<li>The run-time is now included in <tt>- exit</tt> messages (<em>e.g.</em>
when
<tt>--print-exit</tt> is enabled) - <a
href="http://bugzilla.metaprl.org/show_bug.cgi?id=680">bug 680</a>. Note that
this only indicates when OMake <em>have noticed</em> that the command have
finished, which may be quite inaccurate in parallel builds (where OMake may be
busy setting up parallel jobs and not paying attention).
<li>Significant code reorganization in preparation for OMake 0.9.9, should
be largely transparent to the end-users
</ul>
<h3><a name="0.9.8.4">Version 0.9.8.4 (June 4, 2007)</a></h3>
<ul>
<li>Fixed a file descriptor leak
<li>Fixed: <tt>$(OCAMLDEPFLAGS)</tt> should be passed to "ocamldep -modules"
<li>Other minor bug fixes
</ul>
<h3><a name="0.9.8.3">Version 0.9.8.3 (June 1, 2007)</a></h3>
<ul>
<li>The 3-place rules are now considered implicit and will be inherited by
subdirectories. This makes it easier to declare default rules for common
targets, such as<pre>
clean: %:
rm -f ...
</pre>
<li>Allow <tt>.PHONY</tt> sections to have a body. A <tt>.PHONY</tt>
declaration with a body would create a default (implicit) rule for the newly
created phony target(s).
<li>Detect case-insensitive filesystems on Unix-like operating systems
(especially common under Mac OS X). This should make it possible to use
<tt>OCAMLDEP_MODULES_ENABLED=true</tt> under Unix-like operating systems
with case-insensitive filesystems.
<li>Changed the default value for the <tt>OCAMLDEP_MODULES_ENABLED</tt> to
<tt>$(OCAMLDEP_MODULES_AVAILABLE)</tt>. In other words, <tt>ocamldep
-modules</tt> will be used whenever it is available (e.g. under OCaml 3.10
or if the bytecode executable distributed with OMake can be used).
<li>A number of performance improvements. In particular, the size of the
.omakedb should now be significantly smaller.
<li>Documentation improvements
</ul>
<h3>Version 0.9.8.2</h3>
The version number 0.9.8.2 was skipped.
<h3><a name="0.9.8.1">Version 0.9.8.1 (March 16, 2007)</a></h3>
<ul>
<li>Additional “autoconfiguration” functionality:
<ul>
<li>New functions in <tt>configure/Configure.om</tt>, including
<tt>ConfMsgChecking</tt>, <tt>ConfMsgResult</tt>, <tt>ConfMsgYesNo</tt>,
<tt>ConfMsgWarn</tt>, <tt>ConfMsgError</tt>, <tt>ConfMsgFound</tt>,
<tt>TryCompileC</tt>, <tt>TryLinkC</tt>, <tt>TryRunC</tt>,
<tt>RunCProg</tt>.
<li>Added <tt>configure/X.om</tt> with some basic tests for X
(experimental, not very well tested).
</ul>
<li>A number of new built-in and standard library functions: <tt>join</tt>,
<tt>min</tt>, <tt>max</tt>, <tt>Map.keys</tt>, <tt>Map.values</tt>,
<tt>getpwnam<tt>, <tt>getpwuid</tt>, <tt>getpwents</tt>, <tt>getgrnam</tt>,
<tt>getgrgid</tt>, <tt>tgetstr</tt>, <tt>xterm-escape</tt>, <tt>prompt-invisible</tt>
<li>Improvements in <tt>-p</tt>/<tt>-P</tt> (“poll”) mode:
<ul>
<li>Various errors in <tt>OMakefile</tt>s will now cause OMake to poll for
<tt>OMakefile</tt> changes after reporting the error, instead of aborting.
<li>Will watch “<tt>:optional:</tt>” and
“<tt>:exists:</tt>” dependencies (but will still ignore
“<tt>Delete</tt>” events for them).
</ul>
<li>In implicit rules, allow the source files to contain more than one
instance of the <tt>%</tt> “wildcard” character.
<li>Significant improvements in the command line completion in the
interactive <tt>osh</tt> shell.
<li><tt>build/C.om</tt>:
<ul>
<li>Added <tt>StaticCXXLibrary</tt> function;
<li>Use <tt>/Fo</tt> and <tt>/Fe</tt> flags in place of <tt>-o</tt> on
Windows.
</ul>
<li><tt>build/LaTeX.om</tt>: added some support for MikTeX.
<li>A number of documentation improvements.
<li>A number of other improvements and bugfixes.
</ul>
<h3><a name="0.9.8">Version 0.9.8 (December 11, 2006)</a></h3>
<ul>
<li>The main change in this release is that the OMake values will now be
converted into the shell command lines directly (all the previous versions
of OMake should first "flatten" the value into a string and then perform
<tt>sh</tt>-like parsing of the resulting string). In particular, this means
that:
<ul>
<li>All the special symbols in files and directory values will be
preserved.
<li>All the spaces inside the array elements will be preserved.
<li>All the special symbols in OMake-quoted values
(<tt>$"</tt>...<tt>"</tt> and <tt>$'</tt>...<tt>'</tt>) will be preserved.
<li>If the first element of the command line is a file value, neither
PATH- nor alias-expansion will be performed. Note - there will also be no
alias-expansion if the executable value contains quoted parts or starts
with a <tt>\</tt>.
<li>The <tt>Shell.</tt> aliases will now receive the values passed on the
shell command line as is, not the string-expanded version. Also, if some
of the arguments are the result of a glob-expansion, the alias function
will receive the appropriate file values, not the strings.
<li>OMake 0.9.8 <b>will not be fully backwards-compatible</b> with the earlier
releases.
</ul>
<li>Major redesign of the OMake documentation (using <a
href="http://pauillac.inria.fr/~maranget/hevea/">H<FONT
SIZE="-1"><sup>E</sup></FONT>V<FONT SIZE="-1"><sup>E</sup></FONT>A</a>).
<ul>
<li>The documentation is significantly expanded, examples added, bugs
fixed.
<li>There are now a number of indices, including a index of variables, an
index of functions, and an overall index.
</ul>
<li><tt>OCaml.om</tt> improvements:
<ul>
<li>Implemented a new approach to computing the dependencies in OCaml
projects in OMake. In this approach a special version of <tt>ocamldep</tt>
is used to only extract the list of the external modules a file depends on
and then OMake is used to map those modules to files in the include path.
This eliminates the "standard" deficiency of having to generate all the
relevant OCaml source files before <tt>ocamldep</tt> is called. This
feature is considered highly experimental and is disabled by default. Use
the <tt>OCAMLDEP_MODULES_ENABLED</tt> variable to enable.
<li>Added support for the Menhir parser-generator (experimental).
</ul>
<li><tt>C.om</tt> improvements:
<ul>
<li>Changed the <tt>CProgram</tt> function to consider <tt>LIBS</tt> to be the actual
library files (_without_ the extension) that need to be linked in.
<li>Improved the C scanner rule on Windows.
</ul>
<li><tt>LaTeX.om</tt> improvements:
<ul><li><tt>BSTINPUTS</tt> environment variable joins <tt>TEXINPUTS</tt> and
<tt>BIBINPUTS</tt> in the list of variables initialized from the OMake's
<tt>TEXINPUTS</tt> variable.
<li>The list of such variables is now configurable (<tt>TEXVARS</tt> variable
contains an array of names).</ul>
<li>More control over the OMake output and verbosity.
<ul>
<li>By default, OMake is now much more silent ("<tt>-S
--progress</tt>" is enabled by default when it outputs to a terminal,
and "<tt>-S</tt>" is enabled in all other cases).
<li>Added a
<tt>--verbose</tt> option that would make OMake very verbose, when needed.
<li>Added an ability to postpone and/or repeat the rule execution output (so that, for example,
only the output of the rules that fail is printed, or the output of the
rules that failed is repeated at the end of the <tt>omake -k</tt>
execution). This feature is somewhat experimental and might change in the
future versions of OMake.
<li>Added the <tt>-o</tt> option for better control of OMake verbosity.
</ul>
<li>Added three special <tt>.PHONY</tt> targets: <tt>.BUILD_BEGIN</tt>,
<tt>.BUILD_SUCCESS</tt>, and <tt>.BUILD_FAILURE</tt>.
<tt>.BUILD_BEGIN</tt> is built before anything else in your project. One
of <tt>.BUILD_SUCCESS</tt> or <tt>.BUILD_FAILURE</tt> is built when the
build for your project terminates.<br>
Note:
<ul>
<li>This feature is experimental and is likely to change in the
future versions of OMake.
<li>If you want to use these targets, you should probably add them to
your <tt>~/.omakerc</tt>, rather than adding them directly to each of
the projects you work on.
</ul>
<li>OMake will now save the <tt>.omakedb</tt> periodically, preventing the
state loss in case the OMake process dies unexpectedly (for example, when Cygwin
kills OMake after user presses Ctrl-C). The checkpointing interval may be
configured both at compile time and via the command line.
<li>The variables such as <tt>$<</tt> and <tt>$@</tt> in rules and
<tt>%</tt> in implicit rules will no longer be expanded to strings; instead
they will be passed as <tt>Node</tt> ("file") values.
<li>Much better handling of the <tt>exit</tt> function, a number of bugs fixed.
<li>Implicit rules can no longer have target patterns referring to another
directories. See <a
href="http://bugzilla.metaprl.org/show_bug.cgi?id=456">bug #456</a> for
detail.
<li>New functions: <tt>Shell.ln-or-cp</tt>, <tt>html-escaped</tt>,
<tt>string-escaped</tt>, <tt>encode-uri</tt>, <tt>decode-uri</tt>,
<tt>random</tt>, <tt>find-targets-in-path</tt>.
<li>Added an ability to turn a string into an input channel. This allows,
for example, to use an OMake variable as an input to built-in <tt>awk</tt> without having to
write it to a temporary file first.
<li>New flags added to built-in <tt>awk</tt> and <tt>grep</tt>.
<li>A large number of other bug fixes and improvements.
</ul>
<h3><a name="0.9.6.9">Version 0.9.6.9 (April 11, 2006)</a></h3>
<ul>
<li>Standard library improvements:
<ul>
<li>Implemented Erick Tryzelaar's idea of having <tt>*Program</tt> and
<tt>*Library</tt> functions return the array with all the targets that it
have defined the rules for.
<li>Improved C++ support:
<ul>
<li>Use <tt>g++</tt> (when present) instead of <tt>gcc</tt> as
<tt>CXX</tt>.
<li>Allow <tt>.cc</tt> and <tt>.c++</tt> extensions in addition to
<tt>.cpp</tt>
<li>Added <tt>CXXProgram</tt> and <tt>CXXProgramInstall</tt> functions.
</ul>
<li>Improved OCaml support:
<ul>
<li>Changed <tt>USE_OCAMLFIND</tt> to be always false by default.
<li>Added <tt>OCAMLC_EXISTS</tt> variable.
</ul>
<li><tt>Pervasives.om</tt>: use the built-in <tt>cat</tt> by default.
<li>Added a <tt>PID</tt> built-in variable.
</ul>
<li>Bug fixes and improvements:
<ul>
<li>Fixed problems with <tt>:value:</tt> dependencies in <tt>.INCLUDE</tt>
rules and <tt>:squash:</tt> dependencies in implicit rules.
<li>Added auto-rehashing on relative names in the <tt>PATH</tt>. In
addition, you can define <tt>AUTO_REHASH = true</tt> if
you want to auto-rehash on all directories in the path.
<li>Comments in OMakefiles are now parsed more consistently.
<li>Significantly improved the performance of the built-in <tt>find</tt>
command.
</ul>
<li>Updated the default (sample) <tt>OMakefile</tt>.
<li>A number of documentation fixes and improvements.
</ul>
<h3><a name="0.9.6.8">Version 0.9.6.8 (January 23, 2006)</a></h3>
<ul>
<li>Improved the handling of the ".PHONY" nodes, fixing a few bugs where a
".PHONY" node was used in place of a file with the same name.
<li>Fixed a bug with PATH-expansion for pipelines being performed too early.
<li>Added a <tt>remove-project-directories</tt> function, which will prevent
the directories from being included even if there is a <tt>.SUBDIRS</tt>
command for any of them.
<li><tt>OCaml.om</tt>: fixed the installation of <tt>.mli</tt>, <tt>.cmi</tt> files
(which is performed by the <tt>OCamlLibraryCopy</tt> function when
<tt>INSTALL_INTERFACES</tt> is enabled).
<li>A number of documentation fixes and other improvements.
</ul>
<h3><a name="0.9.6.7">Version 0.9.6.7 (December 28, 2005)</a></h3>
<ul>
<li>Added basic support for C++ (<a
href="http://bugzilla.metaprl.org/show_bug.cgi?id=389">Issue 389</a>)
<li>Portability improvements:
<ul>
<li>More portable bootstrapping <tt>Makefile</tt>
<li> When lockf is not supported and we fail to lock the project because
of that, print a warning message and keep going (this is fairly safe). We
used to go into an infinite loop before.
</ul>
<li><tt>OCaml.om</tt> improvements:
<ul>
<li>Added an <tt>OCAMLOPT_FOUND</tt> variable that can be used to tell whether
<tt>OCAMLOPT</tt> exists.
<li>Now by default, <tt>NATIVE_ENABLED</tt> and <tt>BYTE_ENABLED</tt>
variables will be set to enable the "best available" compilation mode:
<ul>
<li>When <tt>OCAMLOPT</tt> is fould, the defaults are <tt>
<br>NATIVE_ENABLED=true
<br>BYTE_ENABLED=false</tt>
<br> as before.
<li>Otherwise, the values are swapped.
</ul>
<li>Allow the usage of <tt>OCamlLibraryInstall</tt> and
<tt>OCamlLibraryCopy</tt> when the destination directory is the same as
the source one.
</ul>
<li> Fixed a (somewhat recently introduced) problem with OMake failing to
properly restart when the "<tt>-p</tt>"/"<tt>-P</tt>" filesystem watch is
used and OMake detects that one of the relevant OMake file have changed.
<li>Couple of "<tt>-w</tt>" option improvements.
<li>A number of minor documentation fixes.
</ul>
<h3><a name="0.9.6.6">Version 0.9.6.6 (November 5, 2005)</a></h3>
<ul>
<li>Made sure OMake compiles fine with both OCaml 3.08 and 3.09.
<li>A few minor bugfixes and improvements:
<ul>
<li>Avoid giving bogus "These file are targeted separately, but appear
as effects of a single rule." warnings (thanks to Florian Hars for
reporting the problem).
<li>LaTeX rules: do not assume that .aux will always be created (based on
a patch by Cristian Tapus).
<li>Fixed ocamlfind support (based on a patch by Peter Jolly).
</ul>
</ul>
<h3><a name="0.9.6.5">Version 0.9.6.5 (September 14, 2005)</a></h3>
<ul>
<li>Improved support for configure-style scripts in OMake (using the
run-once <tt>static.</tt> sections). OMake installation now includes a small
library of useful helpful configure functions and a number of examples
(<tt>ncurses</tt>, <tt>readline</tt>, <tt>fam</tt>).
<li>LaTeX rules improvements, including support for TeTeX v.3 and better
pdflatex support.
<li>The <tt>which</tt> function should now work correctly in Cygwin. Fixed
a number of issues related to using <tt>ocamlfind</tt> under Cygwin and
Windows.
<li>Fixed a number of bugs related to execution of complex shell
pipelines.
<li>New built-in functions: <tt>get-registry</tt> (Windows-only),
<tt>removeprefix</tt>, <tt>html-string</tt>.
<li>Fixed a problem with interactive <tt>osh</tt> sessions not handling the
<tt>return</tt> operator correctly.
<li>Improved handling of implicit <tt>:value:</tt> dependencies (implicit
value dependencies are added for all the “free”variables in
<tt>section eval</tt>). The free variable computation is more precise, and
the implicit dependencies are now allowed to contain undefined variables.
<li>The <tt>include foo</tt> directive will now try opening <tt>foo.om</tt>
before trying to open <tt>foo</tt>. Same is true for the <tt>.INCLUDE</tt>
rules.
<li>A number of documentation fixes.
<li>Significant changes in the setup for compiling OMake. No more autoconf,
bootstapping uses make to build a feature-limited bootstrapping binary and
the normal version of OMake is compiled using OMake itself. Makefiles are
now generated by OMake.
<li>Significant reorganization of the source three. Now the source three
has a reasonable directory structure, instead of a single flat directory
with all the files.
<li>A number of other improvements and bug fixes.
</ul>
<h3><a name="0.9.6">Version 0.9.6 (July 17, 2005)</a></h3>
<ul>
<li> Added "static" sections that are evaluated once. Values defined
in static sections are persistent across runs of omake. This is
convenient for implementing configure-style tests in omake files.
<li>Added <tt>:value:</tt> dependencies.
<p>Value dependencies are specified using the :value: option in rules.
<pre>
a: b c :value: $(X)
...</pre>
<p>This rule specifies that "a" should be recompiled if the value of
<tt>$(X)</tt> changes (X does not have to be a filename). This is intended
to allow greater control over dependencies.
In addition, it can be used in place of other kinds of dependencies.
For example, the following rule:
<pre>
a: b :exists: c
commands</pre>
is the same as
<pre>
a: b :value: $(target-exists c)
commands</pre>
<p>Notes:
<ul>
<li> The values are arbitrary (they are not limited to variables)
<li> The values are evaluated at rule expansion time, so variables
like <tt>$@</tt>, <tt>$^</tt>, etc are legal.
</ul>
<p>One other significant difference is that the rule cache now uses a
digest of the rule commands text, not the text itself. This has an
impact on initial omake speed (I am not sure how significant it is)
but the cache is smaller. Also, "<tt>section eval</tt>" should now be
handled correctly.</li>
<li> Significantly changed the meaning of the <tt>.SCANNER</tt> rules. Now the
<tt>.SCANNER</tt> rules are treated much more like normal rules.
<p>Externally, a <tt>.SCANNER</tt> rule has the usual rule form:
<pre>
.SCANNER: target: dependencies...
...scanner commands...</pre>
<p>However, the scanner target is now decoupled from the
build target, allowing a scanner result to be used for multiple
build targets. For example, ocamldep produces dependencies
for .cmo and .cmx files simultaneously. They can share
the scanner rule by specifying an explicit :scanner: dependency.
<pre>
.SCANNER: scan-ocaml-%.ml: %.ml
ocamldep $lt;
%.cmo: %.ml :scanner: scan-ocaml-%.ml
$(OCAMLC) ...
%.cmx %.o: %.ml :scanner: scan-ocaml-%.ml
$(OCAMLOPT) ...</pre>
<p>The current convention is that scanner targets should be named
<tt>scan-<language>-<source-file></tt>.
<ul>
<li> If a rule has multiple <tt>:scanner:</tt> dependencies, the actual
dependencies will be the union of the scanner results.
<li> The <tt>.SCANNER</tt> targets use a different namespace than
normal targets, so it is valid to have overlapping rules.
<pre>
.SCANNER: foo:
echo "foo: boo"
foo: :scanner: foo
...</pre>
<li> For backwards compatibility, if a rule has no :scanner:
dependencies, then omake will try to find a scanner with
the same name as the target. So in the example above,
the <tt>:scanner:</tt> foo is actually unnecessary.
</ul>
</li>
<li> Added file locking for the <tt>.omakedb</tt> and <tt>.omc</tt> files, so that multiple processes
can be run simultaneously.
<li> Fixed issues where files were being expanded during the string to array
conversion.
<li> Better accessibility of the build rules and dependencies from OMake scripts.
<p> See documentation for the <a
href="http://omake.metaprl.org/omake-pervasives.html#section_12"><tt>Target</tt>
object</a> and the <a
href="http://omake.metaprl.org/omake-doc.html#section_288">"Examining
the dependency graph" Section</a> of the OMake Documentation for
more information.
<li> Improved the latex-related rules.
<li> Rule execution now fails when any shell command fails, even those in
nested sections.
<li> Regular expressions now handle \(...\) arguments correctly. Also, the
lexer has better performance, searching is now roughly linear time.
<li> Added <tt>.SUBDIRS</tt> bodies. If you don't want to write an
<tt>OMakefile</tt> for each subdirectory, you can define a <tt>.SUBDIRS</tt>
body that defines the it instead.
<pre>
.SUBDIRS: foo boo
println(Current directory is $(CWD))
...normal configuration...</pre>
<li> Added the <tt>vmount</tt> function to define a "virtual mount" of one directory
over another. This adds a fairly simple way to define multiple versions
of a project. Suppose your source files are in a directory src/. Then
one easy way to compile a version of the project is the following.
<pre>
vmount(-l, src, x86)
.SUBDIRS: x86</pre>
<p>Files from the src directory are now automatically linked into the
x86 directory as needed. If you want to have multiple versions,
you can use multiple directories (and multiple vmounts).
<li> The Map object is now completely changed.
<p>The keys are now "simple" values, not just strings. Simple
values include integers, floats, strings, arrays of simple
values, files, and directories.
<p>Only the Map class has the map functions defined. If you want
to have, say, a File that also includes a Map, create a
subclass that extends both File and Map.
<p>Literal string keys can be written in the form <tt>$|key...|</tt>.
This works both for definitions and uses. The usual modifiers
are allowed <tt>$,|key|</tt> and <tt>$`|key|</tt>.
<pre>
X. =
extends $(Map)
$|key 1| = 1
$|key 2| = $|key 1| boo
$|key 2| += foo</pre>
</li>
<li>Bugs fixed: <a
href="http://bugzilla.metaprl.org/buglist.cgi?bug_id=158,299,315,335,338,359,376,377,379,387,393,394,397,402,403,423,425,427,428,431,441,443,445,446,447,449,452,453,454,459,462,463,464,465,466,470,471,472,473,476,477,478,480,481,482,483,487,488,489,493">158,
299, 315, 335, 338, 359, 376, 377, 379, 387, 393, 394, 397, 402, 403, 423,
425, 427, 428, 431, 441, 443, 445, 446, 447, 449, 452, 453, 454, 459, 462,
463, 464, 465, 466, 470, 471, 472, 473, 476, 477, 478, 480, 481, 482, 483,
487, 488, 489, 493</a>
<li>Numerous other improvements.
</ul>
<h3>OMake 0.9.5</h3>
The version number 0.9.5 was skipped.
<h3><a name="0.9.4">OMake 0.9.4 (January 4, 2005)</a></h3>
<ul>
<li> Portability improvements. OMake should now compile and work under Windows
2000, Windows NT and FreeBSD. A number of Windows-specific bugs are fixed.
A Windows installer is added.
<li> OMake now uses the built-in versions of the following commands:
<tt>cp</tt>, <tt>mv</tt>, <tt>mkdir</tt>, <tt>rm</tt>, <tt>rmdir</tt>,
<tt>chmod</tt>
<li> Improvements to the filesystem watch functionality. In particular,
the build will now restart if a change to one of the OMakefiles is
detected.
<li> Added a <tt>USE_OCAMLFIND</tt> variable that can be used to force or prohibit the
usage of ocamlfind in a project (by default <tt>USE_OCAMLFIND</tt> is set to true
iff the ocamlfind executable is found in path).
<li> Added a <tt>--force-dotomake</tt> option to create all <tt>.omc</tt>
and <tt>.omo</tt> files under <tt>$HOME/.omake/cache</tt> and a
<tt>--dotomake</tt> option to specify an alternative to
<tt>$HOME/.omake</tt>
<li> Added <tt>:squash:</tt> dependencies (that specify that the dependency must be
built, but when the dependency changes, it does not cause the target to be
rebuilt).
<li> OMake will now read <tt>~/.omakeinit</tt> and <tt>~/.omakerc</tt> files on startup.
<li> Improved the latex-related rules.
<li> Documentation improvements.
<li> Bugs fixed: <a
href="http://bugzilla.metaprl.org/buglist.cgi?bug_id=142,153,311,313,314,316,332,333,339,350,360,361,366,367,368,374,375">142, 153, 311, 313, 314, 316, 332, 333, 339, 350, 360, 361,
366, 367, 368, 374, 375</a>.
</ul>
<h3><a name="0.9.3">OMake 0.9.3 (October 18, 2004)</a></h3>
<ul>
<li> OMake now supports ocamlfind in its default configuration file
(thanks to Bardur Arantsson for the initial patch).
<li> OMake should now also work with OCaml 3.07 (in addition to 3.08).
<li> A large number of bug fixes, including:<ul>
<li> OMake should now compile correctly under Cygwin (thanks to
Peter Jolly who provided the patch),
<li> "double-colon" rules (that allow specifying multiple rules for
the same target) should now work correctly,
<li> kqueue-based file system monitoring (Mac OS X, FreeBSD) should
now work correctly
<li> array definitions should now work better.
</ul>
<li> Added a work around for the command line length limitation of
<tt>lib.exe</tt> on Windows
<li> Filesystem monitoring functionality now provides a choice whether
to continue monitoring once the project is built successfully.
</ul>
<h3><a name="0.9.2">OMake 0.9.2 (September 8, 2004)</a></h3>
<ul>
<li> Bugs fixed:<ul>
<li> "<tt>make install</tt>" will no longer create <tt>$HOME/.omake</tt> as root;
<li> the <tt>-custom</tt> option is now a part of
<tt>OCAML_BYTE_LINK_FLAGS</tt> and
can be easily disabled;
<li> omake should now allow specifying dependencies for the same file
more than once.
</ul>
<li> The <tt>OMakeroot.src</tt>, <tt>OMakeroot.default</tt> and
<tt>OMakefile.default</tt> are now
under MIT license to allow users to freely borrow from them into their
own omake build files. (The rest of OMake is still under GPL).
<li> Fixed a number of typos and formatting errors in documentation.
</ul>
</body>
</html>
distrib
>
Momonga
>
development
>
i686
>
media
>
os
>
by-pkgid
>
b116aa3246dedf582873f3e6cb5b1ac1
>
files
>
35
