Subversion Repositories FAQs

Compare Revisions

Last modification

Regard whitespace Rev 8 → Rev 9

/trunk/cljs/index.xml
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='&amp;quot;Posting Questions and Replies to comp.lang.javascript&amp;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
&quot;<URL LINKTEXT="Posting Questions and Replies to comp.lang.javascript">notes/posting/</URL>&quot;.</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&amp;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>