============================================================================== YUI Compressor ============================================================================== NAME YUI Compressor - The Yahoo! JavaScript and CSS Compressor SYNOPSIS Usage: java -jar yuicompressor-x.y.z.jar [options] [input file] Global Options -h, --help Displays this information --type Specifies the type of the input file --charset Read the input file using --line-break Insert a line break after the specified column number -o Place the output into . Defaults to stdout. JavaScript Options --warn Display possible errors in the code --nomunge Minify only, do not obfuscate --preserve-semi Preserve all semicolons --preserve-strings Do not merge concatenated string literals DESCRIPTION The YUI Compressor is a JavaScript compressor which, in addition to removing comments and white-spaces, obfuscates local variables using the smallest possible variable name. This obfuscation is safe, even when using constructs such as 'eval' or 'with' (although the compression is not optimal is those cases) Compared to jsmin, the average savings is around 20%. The YUI Compressor is also able to safely compress CSS files. The decision on which compressor is being used is made on the file extension (js or css) GLOBAL OPTIONS -h, --help Prints help on how to use the YUI Compressor --line-break Some source control tools don't like files containing lines longer than, say 8000 characters. The linebreak option is used in that case to split long lines after a specific column. It can also be used to make the code more readable, easier to debug (especially with the MS Script Debugger) Specify 0 to get a line break after each semi-colon in JavaScript, and after each rule in CSS. --type js|css The type of compressor (JavaScript or CSS) is chosen based on the extension of the input file name (.js or .css) This option is required if no input file has been specified. Otherwise, this option is only required if the input file extension is neither 'js' nor 'css'. --charset character-set If a supported character set is specified, the YUI Compressor will use it to read the input file. Otherwise, it will assume that the platform's default character set is being used. The output file is encoded using the same character set. -o outfile Place output in file outfile. If not specified, the YUI Compressor will default to the standard output, which you can redirect to a file. JAVASCRIPT ONLY OPTIONS --nomunge Minify only. Do not obfuscate local symbols. --warn Prints additional warnings such as duplicate variable declarations, missing variable declaration, unrecommended practices, etc. --preserve-semi Preserve unnecessary semicolons (such as right before a '}') This option is useful when compressed code has to be run through JSLint (which is the case of YUI for example) --preserve-strings Use this option to specify that concatenated string literals should never be merged. NOTES + If no input file is specified, it defaults to stdin. + The YUI Compressor requires Java version >= 1.4. AUTHOR The YUI Compressor was written and is maintained by: Julien Lecomte The CSS portion is a port of Isaac Schlueter's cssmin utility. COPYRIGHT Copyright (c) 2007, Yahoo! Inc. All rights reserved. Code licensed under the BSD License: http://developer.yahoo.net/yui/license.txt