]> code.delx.au - gnu-emacs-elpa/blobdiff - packages/js2-mode-readme.txt
* admin/archive-contents.el: New file.
[gnu-emacs-elpa] / packages / js2-mode-readme.txt
index e87b410f9df73a7838cea4fbf2e094f391185ef5..5da80505dfc07ee441019758cadba6cd14923936 100644 (file)
@@ -1,34 +1,36 @@
 This JavaScript editing mode supports:
 
 - strict recognition of the Ecma-262 language standard
 - support for most Rhino and SpiderMonkey extensions from 1.5 to 1.8
 - parsing support for ECMAScript for XML (E4X, ECMA-357)
 - accurate syntax highlighting using a recursive-descent parser
 - on-the-fly reporting of syntax errors and strict-mode warnings
 - undeclared-variable warnings using a configurable externs framework
 - "bouncing" line indentation to choose among alternate indentation points
 - smart line-wrapping within comments and strings
 - code folding:
-    - show some or all function bodies as {...}
-    - show some or all block comments as /*...*/
 - context-sensitive menu bar and popup menus
 - code browsing using the `imenu' package
 - typing helpers such as automatic insertion of matching braces/parens
 - many customization options
+ - strict recognition of the Ecma-262 language standard
+ - support for most Rhino and SpiderMonkey extensions from 1.5 to 1.8
+ - parsing support for ECMAScript for XML (E4X, ECMA-357)
+ - accurate syntax highlighting using a recursive-descent parser
+ - on-the-fly reporting of syntax errors and strict-mode warnings
+ - undeclared-variable warnings using a configurable externs framework
+ - "bouncing" line indentation to choose among alternate indentation points
+ - smart line-wrapping within comments and strings
+ - code folding:
+   - show some or all function bodies as {...}
+   - show some or all block comments as /*...*/
+ - context-sensitive menu bar and popup menus
+ - code browsing using the `imenu' package
+ - typing helpers such as automatic insertion of matching braces/parens
+ - many customization options
 
-The mode includes a port of Mozilla Rhino's scanner, parser and symbol
-table.  Ideally it should stay in sync with Rhino, keeping `js2-mode'
-current as the EcmaScript language standard evolves.
+To customize how it works:
+  M-x customize-group RET js2-mode RET
 
-Unlike cc-engine based language modes, js2-mode's line-indentation is
-not customizable.  It is a surprising amount of work to support
-customizable indentation.  The current compromise is that the tab key
-lets you cycle among various likely indentation points, similar to the
-behavior of python-mode.
+Notes:
+
+This mode includes a port of Mozilla Rhino's scanner, parser and
+symbol table.  Ideally it should stay in sync with Rhino, keeping
+`js2-mode' current as the EcmaScript language standard evolves.
+
+Unlike cc-engine based language modes, js2-mode's line-indentation is not
+customizable.  It is a surprising amount of work to support customizable
+indentation.  The current compromise is that the tab key lets you cycle among
+various likely indentation points, similar to the behavior of python-mode.
 
 This mode does not yet work with "multi-mode" modes such as `mmm-mode'
 and `mumamo', although it could be made to do so with some effort.
-This means that `js2-mode' is currently only useful for editing
-JavaScript files, and not for editing JavaScript within <script> tags
-or templates.
-
+This means that `js2-mode' is currently only useful for editing JavaScript
+files, and not for editing JavaScript within <script> tags or templates.