aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorDouglas Neiner <doug@pixelgraphics.us>2010-06-14 11:17:13 -0400
committerwycats <wycats@gmail.com>2010-06-19 22:29:49 -0700
commit4e337f504e623646f36785b25222b7f7392fbd46 (patch)
treef5e0cfc7ad670301c900c89e7029b5304bcb2f41 /README.md
parentab2537a7ec3c856df1a6192ff72e556c4a22db0e (diff)
downloadjquery-4e337f504e623646f36785b25222b7f7392fbd46.tar.gz
jquery-4e337f504e623646f36785b25222b7f7392fbd46.zip
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.
Diffstat (limited to 'README.md')
-rw-r--r--README.md61
1 files changed, 44 insertions, 17 deletions
diff --git a/README.md b/README.md
index 7b794af6a..3f4f258b6 100644
--- a/README.md
+++ b/README.md
@@ -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"
[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)
-If you do have Ant, everytime (in this README) that I say 'make', do 'ant' instead - it works identically (for all intents and purposes).
+You now have **three** options for building jQuery:
+
+* **`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
-----------------------------
+*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
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.
-`make jquery`
+ make jquery
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).
-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.
-`make selector`
+ make selector
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:
-`make clean`
+ make clean
+
+Building to a different directory
+----------------------------------
+
+If you want to install jQuery to a location that is not this directory, you can...
-Additionally, if you want to install jQuery to a location that is not this
-directory, you can specify the PREFIX directory, for example:
+**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
mailing list, which can be found here: