jQuery JavaScript Library

Find a file

Dave Methvin b8931f7448 Test for standard createEvent before IE-specific click method. Don't fallback to fake click; let's see which browsers fail, if any.		2010-12-27 12:43:48 -05:00
build	Handle the case where JSLint complains about arguments in try/catch already being defined (we use the name 'e' consistently for catch(e) - will work to standardize on that now).	2010-10-17 10:50:17 -04:00
speed	Adding some rooted-find perf tests.	2010-10-10 16:06:33 -04:00
src	Simplify the check for isDefaultPrevented.	2010-12-24 09:53:39 -05:00
test	Test for standard createEvent before IE-specific click method.	2010-12-27 12:43:48 -05:00
.gitattributes	Mark *.jar files as binary.	2010-11-12 07:41:44 +02:00
.gitignore	Adding .DS_Store to Git ignore.	2009-12-09 23:49:13 -08:00
build.xml	Added the regexp to remove module closures to the ant build file to be on par with the Makefile.	2010-12-11 01:56:29 +01:00
GPL-LICENSE.txt	Updated the licensing information.	2006-08-21 19:36:44 +00:00
Makefile	Replaced spaces with a tab in Makefile.	2010-12-10 02:55:43 +01:00
MIT-LICENSE.txt	Updating the date in MIT-LICENSE.txt. Thanks @mathias for the heads-up.	2010-01-21 09:07:19 -05:00
Rakefile	Added xhr.js and transports/*.js to Rakefile and build.xml (in sync with Makefile).	2010-12-10 02:43:41 +01:00
README.md	Updated the Questions? section with the forum information.	2010-09-17 12:40:04 -07:00
version.txt	Updating the source version to 1.4.5pre.	2010-11-11 19:05:10 -05:00

README.md

jQuery - New Wave Javascript

What you need to build your own jQuery

Make sure that you have Java installed (if you want to build a minified version of jQuery).
If not, go to this page and download "Java Runtime Environment (JRE) 5.0"

Build Options

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 (on either Windows or UNIX/Linux), you can simply type rake to build all the components.
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].

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

Here are the individual items that are buildable from the Makefile:

make init

Pull in all the external dependencies (QUnit, Sizzle) for the project.

make jquery

The standard, uncompressed, jQuery code.
Makes: ./dist/jquery.js

make min

A compressed version of jQuery (made the Closure Compiler).
Makes: ./dist/jquery.min.js

make lint

Tests a build of jQuery against JSLint, looking for potential errors or bits of confusing code.

make selector

Builds the selector library for jQuery from Sizzle.
Makes: ./src/selector.js

Finally, you can remove all the built files using the command:

make clean

Building to a different directory

If you want to build jQuery to a directory that is different from the default location, you can...

Make only: Specify the PREFIX directory, for example:

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 Developing jQuery Core forum, which can be found here:
http://forum.jquery.com/developing-jquery-core