22,6 → 22,7 |
Code examples in this FAQ use <URL LINKTEXT="JSDoc Toolkit" |
>http://jsdoctoolkit.org/</URL> comments. |
</P> |
|
<CONTENT TITLE="Which newsgroups deal with javascript?" ID="newsgroups" NUMID="2_1"> |
<P> |
The official Big 8 Usenet newsgroup dealing with javascript is |
32,6 → 33,7 |
c.l.js is an unmoderated newsgroup. |
</P> |
</CONTENT> |
|
<CONTENT TITLE="What questions are on-topic for comp.lang.javascript?" ID="appropriateQuestions" NUMID="2_2"> |
<P> |
The comp.lang.javascript newsgroup deals with ECMAScript |
72,42 → 74,27 |
<URL>faq_notes/cljs_charter.html</URL>. |
</P> |
</CONTENT> |
|
<CONTENT TITLE="What should I do before posting to comp.lang.javascript?" ID="posting" NUMID="2_3"> |
|
<P> |
Before posting to c.l.js, you should read this document. |
You should also check the <URL LINKTEXT="Resources section">#onlineResources</URL>. |
</P> |
<LIST TYPE="UL" TITLE="How to Ask a Question" ID="ask"> |
<LI> |
State your question clearly and concisely. |
</LI> |
<LI> |
Use the Subject: line to show the type of problem you have but |
include the question in the body as well. |
</LI> |
<LI> |
For a more detailed explanation of formatting, see |
<URL |
LINKTEXT='&quot;Posting Questions and Replies to comp.lang.javascript&quot;'>notes/posting/</URL>. |
</LI> |
<LI>State your question clearly and concisely.</LI> |
<LI>Use the Subject: line to show the type of problem you have but |
include the question in the body as well.</LI> |
<LI>For a more detailed explanation of formatting, see |
"<URL LINKTEXT="Posting Questions and Replies to comp.lang.javascript">notes/posting/</URL>".</LI> |
</LIST> |
|
<LIST TYPE="UL" TITLE="Replying" ID="reply"> |
<LI> |
Quote only relevant parts of earlier messages, and add your |
<LI>Quote only relevant parts of earlier messages, and add your |
comments below each quoted section |
(<URL LINKTEXT="FYI28/RFC1855">http://www.ietf.org/rfc/rfc1855.txt</URL>). |
</LI> |
<LI> |
Link to specific sections of the FAQ that are relevant. |
</LI> |
<LI> |
Avoid being unnecessarily rude, but do not complain about other rude posts. |
</LI> |
<LI> |
Don't quote signatures. |
</LI> |
(<URL LINKTEXT="FYI28/RFC1855">http://www.ietf.org/rfc/rfc1855.txt</URL>).</LI> |
<LI>Link to specific sections of the FAQ that are relevant.</LI> |
<LI>Avoid being unnecessarily rude, but do not complain about other rude posts.</LI> |
<LI>Don't quote signatures.</LI> |
</LIST> |
|
<LIST TYPE="UL" TITLE="Posting Code" ID="postCode"> |
115,45 → 102,23 |
Remove everything that does not contribute to the problem (images, |
markup, other scripts, etc). |
</LI> |
<LI> |
Validate the HTML and CSS <URL>http://validator.w3.org/</URL>, <URL>http://jigsaw.w3.org/css-validator/</URL>. |
</LI> |
<LI> |
Make sure the code is executable as transmitted. |
</LI> |
<LI> |
Format lines to 72 characters; indent with 2-4 spaces (not tabs). |
</LI> |
<LI> |
State what you expect the code to do. |
</LI> |
<LI> |
Mention the platforms, browsers, and versions. |
</LI> |
<LI> |
See also the <URL LINKTEXT="FAQ section on debugging" |
>#debugging</URL>. |
</LI> |
<LI> |
Post in plain-text only. Do not encode it. Do not attach files. |
</LI> |
<LI> |
If the code is more than about 100 lines, provide a URL in addition. |
</LI> |
<LI> |
Do not multi-post; cross-post if necessary |
(<URL LINKTEXT="Wikipedia description">http://en.wikipedia.org/wiki/Cross-post</URL>). |
</LI> |
<LI>Validate the HTML and CSS <URL>http://validator.w3.org/</URL>, |
<URL>http://jigsaw.w3.org/css-validator/</URL>.</LI> |
<LI>Make sure the code is executable as transmitted.</LI> |
<LI>Format lines to 72 characters; indent with 2-4 spaces (not tabs).</LI> |
<LI>State what you expect the code to do.</LI> |
<LI>Mention the platforms, browsers, and versions.</LI> |
<LI>See also the <URL LINKTEXT="FAQ section on debugging">#debugging</URL>.</LI> |
<LI>Post in plain-text only. Do not encode it. Do not attach files.</LI> |
<LI>If the code is more than about 100 lines, provide a URL in addition.</LI> |
<LI>Do not multi-post; cross-post if necessary |
(<URL LINKTEXT="Wikipedia description">http://en.wikipedia.org/wiki/Cross-post</URL>).</LI> |
</LIST> |
<LIST TYPE="UL" TITLE="What Not to Post" ID="doNotPost"> |
<LI> |
Do not post job postings. Job postings should go to |
an appropriate regional jobs group. |
</LI> |
<LI> |
Do not post copyright material without permission |
from the copyright holder. |
</LI> |
<LI>Do not post job postings. Job postings should go to |
an appropriate regional jobs group.</LI> |
<LI>Do not post copyright material without permission |
from the copyright holder.</LI> |
</LIST> |
<P> |
Relevant announcements are welcome, but no more often than once |
160,53 → 125,38 |
per major release, as a short link to the product's webpage. |
</P> |
</CONTENT> |
|
<CONTENT TITLE="Why was my post not answered?" ID="noAnswer" NUMID="2_4"> |
<P> |
This could be for several reasons: |
<P>This could be for several reasons:</P> |
<UL> |
<LI> |
It was a variation of a frequently asked question and was |
therefore ignored by everyone. |
</LI> |
<LI> |
Nobody knows the answer. |
</LI> |
<LI> |
The person with the answer has not seen the post. |
</LI> |
<LI> |
It might not be possible to do what you want to do but perhaps |
<LI>It was a variation of a frequently asked question and was |
therefore ignored by everyone.</LI> |
<LI>Nobody knows the answer.</LI> |
<LI>The person with the answer has not seen the post.</LI> |
<LI>It might not be possible to do what you want to do but perhaps |
readers of c.l.js are reluctant to answer your post in the negative |
when they are not convinced that it cannot be done. |
</LI> |
<LI> |
The question was not asked clearly enough, or did not included |
enough information to be answered. |
</LI> |
<LI> |
The questioner did not realise the need to read the group, for a |
few days, to see the answers posted there. |
</LI> |
<LI>You ignored the <URL LINKTEXT="section on posting" |
>#posting</URL> |
</LI> |
when they are not convinced that it cannot be done.</LI> |
<LI>The question was not asked clearly enough, or did not included |
enough information to be answered.</LI> |
<LI>The questioner did not realise the need to read the group, for a |
few days, to see the answers posted there.</LI> |
<LI>You ignored the <URL LINKTEXT="section on posting">#posting</URL></LI> |
</UL> |
If it is not one of these, then after a few days consider |
reposting after checking <URL>http://groups.google.com/group/comp.lang.javascript/topics</URL> |
|
<p>If it is not one of these, then after a few days consider |
reposting after checking |
<URL>http://groups.google.com/group/comp.lang.javascript/topics</URL> |
for replies. Make sure the post is phrased well, and everything |
needed to answer is correct, and the subject is appropriate. |
</P> |
needed to answer is correct, and the subject is appropriate.</p> |
</CONTENT> |
</CONTENT> |
|
<CONTENT TITLE="Language Overview" ID="tips" NUMID="2"> |
|
<CONTENT TITLE="What is ECMAScript?" ID="ecma" NUMID="2_6"> |
<P> |
|
<URL LINKTEXT="ECMA-262">http://www.ecma-international.org/publications/standards/Ecma-262.htm</URL> |
is the international standard that current language implementations |
(JavaScript&trade;, JScript etc.) are based on. |
|
</P> |
<P> |
<URL LINKTEXT="ECMA-262">http://www.ecma-international.org/publications/standards/Ecma-262.htm</URL> |
213,7 → 163,8 |
defines the language Syntax, Types, Keywords, Operators, and built-in |
objects. The ECMAScript specification is the reference to determine the |
expected behavior of a program. ECMAScript does not define any host |
objects, such as <ICODE>document</ICODE>, <ICODE>window</ICODE>, or <ICODE>ActiveXObject</ICODE>. |
objects, such as <ICODE>document</ICODE>, <ICODE>window</ICODE>, or |
<ICODE>ActiveXObject</ICODE>. |
</P> |
<P> |
ECMA-327 defines the Compact Profile of ECMAScript by |
239,7 → 190,6 |
be appropriately asked at: |
<NEWSGROUP>microsoft.public.scripting.jscript</NEWSGROUP>. |
</P> |
|
</CONTENT> |
<CONTENT TITLE="What is the Document Object Model (DOM)?" ID="dom" NUMID="2_9"> |
<P> |
259,6 → 209,7 |
</P> |
<P> |
Also see the section on <URL LINKTEXT="DOM and Forms">#domRef</URL>. |
</P> |
<MOREINFO> |
<URL LINKTEXT="c.l.js DOM Resources">#onlineResources</URL> |
<URL LINKTEXT="W3C DOM FAQ">http://www.w3.org/DOM/faq.html</URL> |
265,10 → 216,8 |
<URL LINKTEXT="W3C DOM ">http://www.w3.org/DOM/</URL> |
<URL LINKTEXT="MDC: What is the DOM?">https://developer.mozilla.org/en/Gecko_DOM_Reference/Introduction#What_is_the_DOM.3F</URL> |
</MOREINFO> |
</P> |
</CONTENT> |
<CONTENT TITLE="Internationalisation and Localisation in javascript" ID="localization" |
NUMID="2_10"> |
<CONTENT TITLE="Internationalisation and Localisation in javascript" ID="localization" NUMID="2_10"> |
<P> |
<DFN>Internationalisation</DFN> means using one form which is everywhere both |
acceptable and understood. Any international standard not supported by |
304,12 → 253,13 |
support in implementations released before approval date (JScript 5.8, |
JavaScript 1.8, JavaScriptCore). |
http://www.ecma-international.org/publications/standards/Ecma-262.htm |
</P> |
<MOREINFO> |
<URL>http://www.ecma-international.org/publications/standards/Ecma-262.htm</URL> |
</MOREINFO> |
</P> |
</CONTENT> |
</CONTENT> |
|
<CONTENT TITLE="Javascript Resources" ID="ecmascriptResources" NUMID="3"> |
<CONTENT TITLE="What books are recommended for javascript?" ID="books" NUMID="3_1"> |
<P> |
373,222 → 323,113 |
<URL LINKTEXT="Javascript library development" |
>http://groups.google.com/group/comp.lang.javascript/browse_thread/thread/acadf1b22b219433/4f69a95607d0b3ae#4f69a95607d0b3ae</URL> |
</LI> |
</UL></LI> |
</UL> |
</LI> |
</UL> |
</LI> |
</LIST> |
</CONTENT> |
|
</CONTENT> |
<CONTENT TITLE="What online resources are available?" ID="onlineResources" NUMID="3_2"> |
|
<LIST TITLE="ECMAScript" TYPE="DL" ID="ecmaResources"> |
<DT> |
The Official ECMAScript Specification |
</DT> |
<DD> |
<URL>[ECMA-262] http://www.ecma-international.org/publications/standards/Ecma-262-arch.htm</URL> |
</DD> |
<DT>The Official ECMAScript Specification</DT> |
<DD><URL>[ECMA-262] http://www.ecma-international.org/publications/standards/Ecma-262-arch.htm</URL></DD> |
|
<DT> |
[ISO16262] ISO/IEC 16262, Second Edition 2002-06-01 : ISO Standard matching |
ECMA-262 3rd Edition, with corrections. |
</DT> |
<DD> |
<URL>http://standards.iso.org/ittf/PubliclyAvailableStandards/c033835_ISO_IEC_16262_2002(E).zip</URL> |
</DD> |
<DT>[ISO16262] ISO/IEC 16262, Second Edition 2002-06-01 : ISO Standard matching |
ECMA-262 3rd Edition, with corrections.</DT> |
<DD><URL>http://standards.iso.org/ittf/PubliclyAvailableStandards/c033835_ISO_IEC_16262_2002(E).zip</URL></DD> |
|
<DT> |
[MS-ES3]: Internet Explorer ECMA-262 ECMAScript Language Specification Standards Support |
</DT> |
<DD> |
<URL>http://msdn.microsoft.com/en-us/library/ff520996%28VS.85%29.aspx</URL> |
</DD> |
<DT>[MS-ES3]: Internet Explorer ECMA-262 ECMAScript Language Specification Standards Support</DT> |
<DD><URL>http://msdn.microsoft.com/en-us/library/ff520996%28VS.85%29.aspx</URL></DD> |
<DD><URL>res/%5BMS-ES3%5D.pdf</URL> (local alias)</DD> |
|
<DT> |
[MS-ES3EX]: Microsoft JScript Extensions to the ECMAScript Language Specification Third Edition |
</DT> |
<DD> |
<URL>http://msdn.microsoft.com/en-us/library/ff521046%28VS.85%29.aspx</URL> |
</DD> |
<DT>[MS-ES3EX]: Microsoft JScript Extensions to the ECMAScript Language Specification Third Edition</DT> |
<DD><URL>http://msdn.microsoft.com/en-us/library/ff521046%28VS.85%29.aspx</URL></DD> |
<DD><URL>res/%5BMS-ES3EX%5D.pdf</URL> (local alias)</DD> |
|
<DT>ECMAScript on Wikipedia |
</DT> |
<DD> |
<URL>http://en.wikipedia.org/wiki/ECMAScript</URL> |
</DD> |
<DT>ECMAScript on Wikipedia</DT> |
<DD><URL>http://en.wikipedia.org/wiki/ECMAScript</URL></DD> |
</LIST> |
|
<LIST TITLE="W3C DOM" TYPE="DL" ID="domResources"> |
<DT> |
DOM Level 1 ECMAScript Binding |
</DT> |
<DD> |
<URL>http://www.w3.org/TR/REC-DOM-Level-1/ecma-script-language-binding.html</URL> |
</DD> |
<DT> |
DOM Level 2 ECMAScript Binding |
</DT> |
<DD> |
<URL>http://www.w3.org/TR/DOM-Level-2-HTML/ecma-script-binding.html</URL> |
</DD> |
<DT> |
DOM Level 2 Events |
</DT> |
<DD> |
<URL>http://www.w3.org/TR/DOM-Level-2-Events/events.html</URL> |
</DD> |
<DT>DOM Level 1 ECMAScript Binding</DT> |
<DD><URL>http://www.w3.org/TR/REC-DOM-Level-1/ecma-script-language-binding.html</URL></DD> |
|
<DT> |
DOM Level 2 Style |
</DT> |
<DD> |
<URL>http://www.w3.org/TR/DOM-Level-2-Style/</URL> |
</DD> |
<DT>DOM Level 2 ECMAScript Binding</DT> |
<DD><URL>http://www.w3.org/TR/DOM-Level-2-HTML/ecma-script-binding.html</URL></DD> |
|
<DT> |
DOM Level 3 ECMAScript Binding |
</DT> |
<DD> |
<URL>http://www.w3.org/TR/DOM-Level-3-Core/ecma-script-binding.html</URL> |
</DD> |
<DT>DOM Level 2 Events</DT> |
<DD><URL>http://www.w3.org/TR/DOM-Level-2-Events/events.html</URL></DD> |
|
<DT>DOM Level 2 Style</DT> |
<DD><URL>http://www.w3.org/TR/DOM-Level-2-Style/</URL></DD> |
|
<DT>DOM Level 3 ECMAScript Binding</DT> |
<DD><URL>http://www.w3.org/TR/DOM-Level-3-Core/ecma-script-binding.html</URL></DD> |
</LIST> |
|
<LIST TITLE="Browser Documentation" TYPE="DL" ID="browserResources"> |
<DT> |
Mozilla |
</DT> |
<DD>JavaScript: |
<URL>http://developer.mozilla.org/en/docs/JavaScript</URL> |
</DD> |
<DD>Gecko DOM Reference: |
<URL>http://developer.mozilla.org/en/docs/Gecko_DOM_Reference</URL> |
</DD> |
<DT> |
Microsoft |
</DT> |
<DD>HTML and DHTML Reference: |
<URL>http://msdn.microsoft.com/en-us/library/ms533050.aspx</URL> |
</DD> |
<DT>Mozilla</DT> |
<DD>JavaScript: <URL>http://developer.mozilla.org/en/docs/JavaScript</URL></DD> |
<DD>Gecko DOM Reference: <URL>http://developer.mozilla.org/en/docs/Gecko_DOM_Reference</URL></DD> |
|
<DD>JScript Language Reference: |
<URL>http://msdn.microsoft.com/en-us/library/hbxc2t98%28VS.85%29.aspx</URL> |
</DD> |
<DD>Scripting: |
<URL>http://msdn.microsoft.com/en-us/library/ms950396.aspx</URL> |
</DD> |
<DT>Microsoft</DT> |
<DD>HTML and DHTML Reference: <URL>http://msdn.microsoft.com/en-us/library/ms533050.aspx</URL></DD> |
<DD>JScript Language Reference:<URL>http://msdn.microsoft.com/en-us/library/hbxc2t98%28VS.85%29.aspx</URL></DD> |
<DD>Scripting: <URL>http://msdn.microsoft.com/en-us/library/ms950396.aspx</URL></DD> |
|
<DT> |
Opera |
</DT> |
<DD>Web Specifications Support: |
<URL>http://www.opera.com/docs/specs/#ecmascript</URL> |
</DD> |
<DT>Opera</DT> |
<DD>Web Specifications Support: <URL>http://www.opera.com/docs/specs/#ecmascript</URL></DD> |
|
<DD>JavaScript Support: |
<URL>http://www.opera.com/docs/specs/js/</URL> |
</DD> |
<DD>JavaScript Support: <URL>http://www.opera.com/docs/specs/js/</URL></DD> |
<DD>ECMAScript Support: <URL>http://www.opera.com/docs/specs/js/ecma</URL></DD> |
|
<DD>ECMAScript Support: |
<URL>http://www.opera.com/docs/specs/js/ecma</URL> |
</DD> |
<DT>BlackBerry JavaScript Reference</DT> |
<DD><URL>http://docs.blackberry.com/en/developers/deliverables/11849/</URL></DD> |
|
<DT> |
BlackBerry JavaScript Reference |
</DT> |
<DD> |
<URL>http://docs.blackberry.com/en/developers/deliverables/11849/</URL> |
</DD> |
<DT>ICab InScript</DT> |
<DD><URL>http://www.muchsoft.com/inscript/</URL></DD> |
|
<DT> |
ICab InScript |
</DT> |
<DD> |
<URL>http://www.muchsoft.com/inscript/</URL> |
</DD> |
|
<DT>Apple Safari</DT> |
<DD>Web Content Guide: |
<URL |
>http://developer.apple.com/safari/library/documentation/AppleApplications/Reference/SafariWebContent/Introduction/Introduction.html</URL> |
</DD> |
<DD>Web Content Guide: <URL>http://developer.apple.com/safari/library/documentation/AppleApplications/Reference/SafariWebContent/Introduction/Introduction.html</URL></DD> |
|
<DT> |
Webkit |
</DT> |
<DT>Webkit</DT> |
<DD>Project Site: <URL>http://webkit.org/</URL></DD> |
<DD> |
Wiki: <URL>http://trac.webkit.org/wiki</URL> |
</DD> |
<DD>DOM Reference: |
<URL |
>http://developer.apple.com/Mac/library/documentation/AppleApplications/Reference/WebKitDOMRef/index.html#//apple_ref/doc/uid/TP40006089</URL> |
</DD> |
<DT> |
Netscape 4 Client-Side JavaScript Reference |
</DT> |
<DD> |
<URL>http://docs.sun.com/source/816-6408-10/</URL> |
</DD> |
<DD>Wiki: <URL>http://trac.webkit.org/wiki</URL></DD> |
<DD>DOM Reference: <URL>http://developer.apple.com/Mac/library/documentation/AppleApplications/Reference/WebKitDOMRef/index.html#//apple_ref/doc/uid/TP40006089</URL></DD> |
|
<DT> |
Archived documentation for MSIE 3.x |
</DT> |
<DD> |
<URL>http://members.tripod.com/%7Ehousten/download/</URL> |
</DD> |
<DT>Netscape 4 Client-Side JavaScript Reference</DT> |
<DD><URL>http://docs.sun.com/source/816-6408-10/</URL></DD> |
|
<DT>Archived documentation for MSIE 3.x</DT> |
<DD><URL>http://members.tripod.com/%7Ehousten/download/</URL></DD> |
</LIST> |
|
<LIST TITLE="Standalone ECMAScript Implementations" TYPE="DL" ID="standaloneImplementations"> |
<DT> |
Rhino: An open-source implementation of JavaScript written in Java |
</DT> |
<DD> |
<URL>http://www.mozilla.org/rhino/</URL> |
</DD> |
<DT> |
Besen IDE: ECMAScript Edition 5 with IDE |
</DT> |
<DD> |
<URL>http://besen.sourceforge.net/</URL> |
</DD> |
<DT> |
V8: Google's open source JavaScript engine |
</DT> |
<DD> |
<URL>http://code.google.com/p/v8/</URL> |
</DD> |
<DT> |
SpiderMonkey: Mozilla's C implementation of JavaScript |
</DT> |
<DD> |
<URL>http://www.mozilla.org/js/spidermonkey/</URL> |
</DD> |
<DT> |
Digital Mars DMD Script, console and MS Active Script implementation of ECMAScript |
</DT> |
<DD> |
<URL>http://www.digitalmars.com/dscript/</URL> |
</DD> |
<DT>Rhino: An open-source implementation of JavaScript written in Java</DT> |
<DD><URL>http://www.mozilla.org/rhino/</URL></DD> |
|
<DT>Besen IDE: ECMAScript Edition 5 with IDE</DT> |
<DD><URL>http://besen.sourceforge.net/</URL></DD> |
|
<DT>V8: Google's open source JavaScript engine</DT> |
<DD><URL>http://code.google.com/p/v8/</URL></DD> |
|
<DT>SpiderMonkey: Mozilla's C implementation of JavaScript</DT> |
<DD><URL>http://www.mozilla.org/js/spidermonkey/</URL></DD> |
|
<DT>Digital Mars DMD Script, console and MS Active Script implementation of ECMAScript</DT> |
<DD><URL>http://www.digitalmars.com/dscript/</URL></DD> |
</LIST> |
|
<LIST TITLE="Other ECMAScript Implementations" TYPE="DL" ID="nonBrowserResources"> |
<DT> |
Developing Dashboard Widgets: Apple Developer Connection |
</DT> |
<DD> |
<URL>http://developer.apple.com/macosx/dashboard.html</URL> |
</DD> |
<DT> |
Whitebeam Apache Module: Server Side JavaScript in Apache |
</DT> |
<DD> |
<URL>http://www.whitebeam.org/</URL> |
</DD> |
<DT>Developing Dashboard Widgets: Apple Developer Connection</DT> |
<DD><URL>http://developer.apple.com/macosx/dashboard.html</URL></DD> |
|
<DT>Whitebeam Apache Module: Server Side JavaScript in Apache</DT> |
<DD><URL>http://www.whitebeam.org/</URL></DD> |
</LIST> |
</CONTENT> |
|
<CONTENT TITLE="Javascript Libraries" ID="libraryResources"> |
<P> |
No javascript libraries are endorsed by this group. If you want help |
595,8 → 436,8 |
with using a library, visit that library's discussion group instead. |
</P> |
</CONTENT> |
</CONTENT> |
|
</CONTENT> |
<CONTENT TITLE="Functions" ID="functions"> |
<CONTENT TITLE="What is (function(){ /*...*/ })() ?" ID="scope"> |
<P> |