42169367679f8a8a7951b743e5996b8354d8e1c6
[jquery.git] / README
1
2 --------------------------------
3 jQuery - New Wave Javascript
4 http://jquery.com/
5 --------------------------------
6
7 What you need to build your own jQuery:
8  - Make sure that you have Java installed (if you want to build a minified or 'lite' version of jQuery).
9
10    If not, go to this page and download "Java Runtime Environment (JRE) 5.0"
11    http://java.sun.com/javase/downloads/index.jsp
12
13  - You now have two options for building jQuery, if you have access to
14    common UNIX commands (like 'make', 'mkdir', 'rm', 'cat', and 'echo')
15    then simply type 'make' to build all the components.
16
17  - The other option is if you have Ant installed (or are on Windows and
18    don't have access to make). You can download Ant from here:
19    http://ant.apache.org/bindownload.cgi
20
21    If you do have Ant, everytime (in this README) that I say 'make', do
22    'ant' instead - it works identically (for all intents and purposes).
23
24 How to build your own jQuery:
25
26 In the main directory of the distribution (the one that this file is in), type
27 the following to make all versions of jQuery, the documentation, and the test suite:
28   make
29
30 Here are each of the individual items that are buildable from the Makefile.
31
32 make jquery
33   The standard, uncompressed, jQuery code.
34   Makes: ./dist/jquery.js
35
36 make lite
37   jQuery without all the additional inline documentation and test cases.
38   Makes: ./dist/jquery.lite.js
39
40 make min
41   A compressed version of jQuery (made the YUI Minifier).
42   Makes: ./dist/jquery.min.js
43
44 make test
45   Makes sure that the QUnit submodule is properly checked out.
46   Open this file in your browser:
47     ./test/index.html
48
49 Finally, you can remove all the built files using the command:
50   make clean
51
52 Additionally, if you want to install jQuery to a location that is not this
53 directory, you can specify the PREFIX directory, for example:
54   make PREFIX=/home/john/test/
55 OR
56   make PREFIX=~/www/ docs
57
58 If you have any questions, please feel free to ask them on the jQuery
59 mailing list, which can be found here:
60   http://docs.jquery.com/Discussion