README in rant-0.3.8 vs README in rant-0.4.0
- old
+ new
@@ -10,17 +10,19 @@
Rant currently features:
* Rantfiles are written in Ruby.
* Defining custom tasks
* Automated packaging, testing and RDoc generation for Ruby
applications and libraries.
+* The <em>rant-import</em> command creates a monolithic rant script,
+ so you don't depend on an rant installation anymore.
+* Creating gzipped tar and zip archives -- without installing
+ additional software.
* Primitive support for compiling C# sources portably with csc, cscc
and mcs.
* Dependency checking for C/C++ source files.
* A _configure_ plugin for easy environment and build-parameter
checking (but not like autoconf!) which saves data in a yaml file.
-* The <em>rant-import</em> command creates a monolithic rant script,
- so you don't depend on an rant installation anymore.
As programmers usually want to see code, here is a short and very
basic example of rant usage:
A file called +Rantfile+ contains the code:
@@ -35,11 +37,11 @@
cp data backup/data
will ensure that the "data" file in the "backup" directory is up to
date.
-This document was written for version 0.3.8 of Rant. Most things
+This document was written for version 0.4.0 of Rant. Most things
described here will work for older/newer versions of Rant, but look at
the README file in the Rant distribution you've installed for exact
documentation of your Rant version.
== Support
@@ -68,10 +70,12 @@
read doc/rubyproject.rdoc[link:files/doc/rubyproject_rdoc.html]
Independent from Rant? The <tt>rant-import</tt> command::
read doc/rant-import.rdoc[link:files/doc/rant-import_rdoc.html]
Advanced Rantfiles::
read doc/advanced.rdoc[link:files/doc/advanced_rdoc.html]
+Packaging (creating zip/tgz archives)::
+ read doc/package.rdoc[link:files/doc/package_rdoc.html]
Compiling C/C++::
read doc/c.rdoc[link:files/doc/c_rdoc.html]
Using the Configure plugin::
read doc/configure.rdoc[link:files/doc/configure_rdoc.html]
Compiling C#::
@@ -146,42 +150,42 @@
The file COPYING[link:../../COPYING] in the Rant package contains a
copy of the LGPL. Of course your Rantfiles don't need to be licenced
under the terms of the LGPL.
+---
+
+The file <tt>lib/rant/archive/minitar.rb</tt> is Copyright 2004
+Mauricio Julio Fernandez Pradier and Austin Ziegler. It is licensed
+under the GNU General Public Licence or Ruby's licence.
+
+The file <tt>lib/rant/archive/rubyzip.rb</tt> and the files in the
+<tt>lib/rant/archive/rubyzip</tt> directory were written by Thomas
+Sondergaard. They are distributed under the same license as ruby. See
+http://www.ruby-lang.org/en/LICENSE.txt.
+
== Other info
Rant was started in February 2005. It has been written and is
maintained by Stefan Lang (mailto:langstefan@gmx.at).
-=== Why did you write another build tool?
+=== Credits
-Because I wasn't satisfied by any other build tool. Before I started
-Rant, I had to write a program in C#. The program had to run under
-Windows, but I wanted to develop under Linux. Also I decided to write
-the documentation in Docbook.
-
-So there where quite a few problems arising:
-* I had to compile with cscc on Linux.
-* compile with csc on Windows.
-* automate PDF and HTML generation from Docbook
-
-_Nant_ would have been ok to compile the C# sources. But it isn't
-suited for more general tasks as clueing togheter other programs
-(needed for Docbook processing).
-
-Then I tried to use _Rake_ and it was the other way round. I liked the
-basic concept and syntax of Rake and of course I could have written
-code for Rake (e.g. with a so called _Tasklib_) to support portable C#
-compilation. But it was a bit quirky and because I like to work with
-Ruby, I decided to write my own build tool.
-
Rant has taken the basic syntax of a _task_ and some other concepts
from Rake.
So thanks to Jim Weirich, the author of
Rake[http://rubyforge.org/projects/rake].
+Rant comes with parts of archive-tar-minitar to create (gzipped) tar
+archives on platforms where no +tar+ command is available.
+archive-tar-minitar is developed by Mauricio Julio Fernandez Pradier
+and Austin Ziegler.
+
+Rant comes with parts of rubyzip to create zip archives on platforms
+where no +zip+ command is available. rubyzip is developed by Thomas
+Sondergaard.
+
=== Goals of Rant
* Most important is to be a very *flexible* build tool. This currently
means that you can run/use Rant in many different ways. E.g. you can
invoke it the conventional way like _make_, define tasks and run
@@ -210,5 +214,28 @@
It *should* run on most platforms where Ruby runs, but you never
know...
If you encounter problems with Rant on any platform (with Ruby 1.8.1
or higher) please write a bugreport!
+
+=== Why did you write another build tool?
+
+Because I wasn't satisfied by any other build tool. Before I started
+Rant, I had to write a program in C#. The program had to run under
+Windows, but I wanted to develop under Linux. Also I decided to write
+the documentation in Docbook.
+
+So there where quite a few problems arising:
+* I had to compile with cscc on Linux.
+* compile with csc on Windows.
+* automate PDF and HTML generation from Docbook
+
+_Nant_ would have been ok to compile the C# sources. But it isn't
+suited for more general tasks as clueing togheter other programs
+(needed for Docbook processing).
+
+Then I tried to use _Rake_ and it was the other way round. I liked the
+basic concept and syntax of Rake and of course I could have written
+code for Rake (e.g. with a so called _Tasklib_) to support portable C#
+compilation. But it was a bit quirky and because I like to work with
+Ruby, I decided to write my own build tool.
+