Updated README file with updated information for the Rake addtions

Also changed the default Rake task to "all" instead of "jquery"
to parallel the Makefile.
This commit is contained in:
Douglas Neiner 2010-06-14 11:17:13 -04:00 committed by wycats
parent ab2537a7ec
commit 4e337f504e
2 changed files with 45 additions and 18 deletions

View file

@ -7,52 +7,79 @@ What you need to build your own jQuery
If not, go to this page and download "Java Runtime Environment (JRE) 5.0" If not, go to this page and download "Java Runtime Environment (JRE) 5.0"
[http://java.sun.com/javase/downloads/index.jsp](http://java.sun.com/javase/downloads/index.jsp) [http://java.sun.com/javase/downloads/index.jsp](http://java.sun.com/javase/downloads/index.jsp)
* You now have two options for building jQuery, if you have access to common UNIX commands (like `make`, `mkdir`, `rm`, `cat`, and `echo`) then simply type `make` to build all the components. Build Options
--------------
* The other option is if you have Ant installed (or are on Windows and don't have access to make). You can download Ant from here: [http://ant.apache.org/bindownload.cgi](http://ant.apache.org/bindownload.cgi) You now have **three** options for building jQuery:
If you do have Ant, everytime (in this README) that I say 'make', do 'ant' instead - it works identically (for all intents and purposes).
* **`make`**: If you have access to common UNIX commands (like `make`, `mkdir`, `rm`, `cat`, and `echo`) then simply type `make` to build all the components.
* **`rake`**: If you have Ruby Rake installed, you can simply type `rake` to build all the components. This method works on both Windows and UNIX/Linux systems.
* **`ant`**: If you have Ant installed (or are on Windows and don't have access to make). You can download Ant from here: [http://ant.apache.org/bindownload.cgi](http://ant.apache.org/bindownload.cgi).
How to build your own jQuery How to build your own jQuery
----------------------------- -----------------------------
*Note: If you are using either `rake` or `ant`, substitute your chosen method in place of `make` in the examples below. They work identically for all intents and purposes. Quick reference is also available for `rake` by typing `rake -T` in the `jquery` directory.*
In the main directory of the distribution (the one that this file is in), type In the main directory of the distribution (the one that this file is in), type
the following to make all versions of jQuery: the following to make all versions of jQuery:
`make` make
Here are each of the individual items that are buildable from the Makefile. *Here are each of the individual items that are buildable from the Makefile:*
`make init` make init
Pull in all the external dependencies (QUnit, Sizzle) for the project. Pull in all the external dependencies (QUnit, Sizzle) for the project.
`make jquery` make jquery
The standard, uncompressed, jQuery code. The standard, uncompressed, jQuery code.
Makes: ./dist/jquery.js Makes: `./dist/jquery.js`
`make min` make min
A compressed version of jQuery (made the Closure Compiler). A compressed version of jQuery (made the Closure Compiler).
Makes: ./dist/jquery.min.js Makes: `./dist/jquery.min.js`
`make lint` make lint
Tests a build of jQuery against JSLint, looking for potential errors or bits of confusing code. Tests a build of jQuery against JSLint, looking for potential errors or bits of confusing code.
`make selector` make selector
Builds the selector library for jQuery from Sizzle. Builds the selector library for jQuery from Sizzle.
Makes: ./src/selector.js Makes: `./src/selector.js`
Finally, you can remove all the built files using the command: Finally, you can remove all the built files using the command:
`make clean` make clean
Additionally, if you want to install jQuery to a location that is not this Building to a different directory
directory, you can specify the PREFIX directory, for example: ----------------------------------
If you want to install jQuery to a location that is not this directory, you can...
**Make only:** Specify the PREFIX directory, for example:
`make PREFIX=/home/john/test/` make PREFIX=/home/john/test/ [command]
With this example, the output files would be contained in `/home/john/test/dist/`
**Rake only:** Define the DIST_DIR directory, for example:
rake DIST_DIR=/home/john/test/ [command]
With this example, the output files would be contained in `/home/john/test/`
*In both examples, `[command]` is optional.*
**Ant only:** You cannot currently build to another directory when using Ant.
Questions?
----------
If you have any questions, please feel free to ask them on the jQuery If you have any questions, please feel free to ask them on the jQuery
mailing list, which can be found here: mailing list, which can be found here:

View file

@ -34,7 +34,7 @@ minfier = "java -jar #{build_dir}/google-compiler-20091218.jar"
verbose(false) verbose(false)
# Tasks # Tasks
task :default => "jquery" task :default => "all"
desc "Builds jQuery; Tests with JSLint; Minifies jQuery" desc "Builds jQuery; Tests with JSLint; Minifies jQuery"
task :all => [:jquery, :lint, :min] do task :all => [:jquery, :lint, :min] do