--- books/www/corrections.html 2002/12/04 13:23:05 1.26
+++ books/www/corrections.html 2003/03/19 11:35:08 1.99
@@ -1,4 +1,9 @@
-Corrections
+
+
+
Corrections
This page contains a list of corrections to be made in the next printing of
the book. If you have suggestions for changes or find errors in the text,
@@ -6,83 +11,359 @@ feel free open a bug
section on the chapter pages, or send a message to the reviewers@mozdev.org mailing list.
+
Note: All errors in the text and examples are shown in red and all corrections are shown in blue.
-
+
Preface
-- In Preface (p xiv) 'http://www.oreilly.com/mozilla/' has been changed
-to 'http://www.oreilly.com/catalog/mozilla/'
+ - On page ix: 'other browsers such as Galeon and Chimera' has been changed to 'other browsers
+such as Galeon and Camino'
+
+ - On page xiv: 'http://www.oreilly.com/mozilla/' has been changed
+to 'http://www.oreilly.com/catalog/mozilla/'
+
+ - On page xvii: 'David McNamara, and Mark Hammond' has been changed to 'David
+McNamara, Mark Hammond, Gary Frederick, and Andreas Halter'
+
+ - On page xvii: 'David Hyatt and Mike Pinkerton for the Chimera browser' has been changed to 'David Hyatt and Mike Pinkerton for the Camino browser'
+
+ - On page xvii: 'including Kim Steckler, Rachel Oeschger, and Priscilla, Dylan, and Devon Collins' has been
+changed to 'including Kim Steckler, Rachel Oeschger, Marjana Molan, Lia Molan King, and Priscilla, Dylan, and Devon
+Collins'
-
+
Chapter 1
-- In Chapter 1 (p 7) 'applications web built using XPFE' has been
-changed to 'applications built using XPFE'
+ - On page 2: In sidebar 'like Chimera (an ultra-fast browser that works only on Mac OS X)' has been changed to
+'like Camino (an ultra-fast browser that works only on Mac OS X)'
+
+ - On page 7: In sidebar 'Another project, call m/b (short for mozilla/browser), addresses shortcomings' has
+been changed to 'The Phoenix project (http://www.mozilla.org/projects/phoenix/) also addresses
+shortcomings'
+
+ - On page 7: In sidebar 'Some examples include Chimera (http://chimera.mozdev.org)' has been changed to 'Some examples include Camino (http://www.mozilla.org/projects/camino/)'
+
+ - On page 7: 'applications web built using XPFE' has been
+changed to 'applications built using XPFE'
-
+
Chapter 2
-- In Chapter 2 (p 12) '<window
+
- On page 10: Added a new sentence to the end of the 2nd paragraph of the xFly examples sidebar: 'An installable version
+of the complete xFly application can be found at http://xfly.mozdev.org.'
+
+ - On page 12: '<window
xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"
-/>' has been changed to '<window
-xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">'
+/>' has been changed to '<window
+xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">'
+
+ - On page 14: In first code sample from Windows features section, 'xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">' has been changed to 'xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"'
+
+ - On page 17: 'selecting File > Open File > from' has been
+changed to 'selecting File > Open File from'
- - In Chapter 2 (p 14) Removed an extra '>' from example code
+ - On page 20: 'CenterWindoOnScreen( ) function' has been changed
+to 'CenterWindowOnScreen( ) function'
- - In Chapter 2 (p 17) 'selecting File > Open File > from' has been
-changed to 'selecting File > Open File from'
+ - On page 25: 'Under that directory, create the three new directories, content, locale, and skin, as
+shown in Figure 2-5.' has been changed to 'Under that directory, create the three new directories, content,
+locale, and skin, as shown in Figure 2-5. The locale directory will have the default 'en-US' language pack
+structure.'
- - In Chapter 2 (p 20) 'CenterWindoOnScreen( ) function' has been changed
-to 'CenterWindowOnScreen( ) function'
+ - On page 31: In Example 2-14 'locale/' has been changed to 'locale/en-US/'
+
+ - On page 32: In Example 2-15 'locale,install,url,resource:/chrome/xfly/locale/' has been changed to 'locale,install,url,resource:/chrome/xfly/locale/en-US/'
-
+
Chapter 3
-- In Chapter 3 (p 40) '<toolbarbutton id="printBtn" label="Open"
-oncommand="doPrint( );" />' has been changed to '<toolbarbutton
-id="printBtn" label="Print" oncommand="doPrint( );" >'
+ - On page 34: 'We've packed a lot information in this chapter and it be a useful reference' has been changed
+to 'We've packed a lot of information in this chapter and it will be a useful reference'
+
+ - On page 35: 'secondLevelNodes[I] = docEl.childNodes[i];' has been changed to 'secondLevelNodes[I] = docEl.childNodes[I];'
+
+ - On page 38: In Example 3-3 the namespace declarations have been changed to (note the addition of quotes and the removal of italics)
+
+<![CDATA[
+ xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"
+ xmlns:nc="http://home.netscape.com/NC-rdf#">
+]]>
+
+
- On page 38: In Example 3-3 '<image src="page1.png">' has been changed to '<image
+src="page1.png"/>'
+
+ - On page 40: '<toolbarbutton id="printBtn" label="Open"
+oncommand="doPrint( );" />' has been changed to '<toolbarbutton
+id="printBtn" label="Print" oncommand="doPrint( );" >'
+
+ - On page 51: '<decription>The mozdev.org site [...] your own development project</decription>' has been
+changed to '<description>The mozdev.org site [...] your own development project</description>'
+
+ - On page 54: 'Clicking on the box sets the clicked attribute' has been
+changed to 'Clicking on the box sets the checked attribute'
+
+ - On pages 58 and 59: Example 3-15 has been changed to (note the addition of spaces to seperate values)
+
+<![CDATA[
+<?xml version="1.0"?>
+<window id="hello-goodbye"
+ title="Hello Goodbye"
+ xmlns:html="http://www.w3.org/1999/xhtml"
+ xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"
+ style="min-width:100px;min-height:100px;background-color:white;">
+ <broadcasterset id="broadcasterset">
+ <broadcaster id="cmd_hello" oncommand="alert('Hello There!');"/>
+ </broadcasterset>
+ <keyset id="keyset">
+ <key id="key_h" key="H" observes="cmd_hello" modifiers="accel,shift" />
+ <key id="key_g" key="G" command="cmd_goodbye" modifiers="accel,shift" />
+ </keyset>
+ <commandset id="commandset">
+ <command id="cmd_goodbye" oncommand="alert('Goodbye!');" />
+ </commandset>
+ <spacer flex="1"/>
+ <label value="hello/goodbye"/>
+ <textbox value="type ctl+shft+h"/>
+ <textbox value="type ctl+shft+g"/>
+ <spacer flex="1"/>
+</window>
+]]>
+
+
- On page 63: 'But there are also CSS versions of these properties that
+use the prefix box-pack becomes box-pack when it's defined in CSS, for example.' has been
+changed to 'But there are also CSS versions of these properties that
+use the prefix box-. pack becomes box-pack when it's defined in CSS, for example.'
-
+
+
+Chapter 4
+
+
+
+- On page 88: 'these are selectors are identical' has been changed to 'these selectors are
+identical'
+
+ - On page 109: 'The chome URL that the -moz-binding property points to' has been changed to 'The chrome URL that the -moz-binding property points to'
+
+
+
+
+
Chapter 5
- - In Chapter 5(p 120)
- <![CDATA[
- dump(l+'\n');
- ]]>
- has been changed to
- <![CDATA[
- dump(len+'\n');
- ]]>
-
+
+- On page 113: Javascript 1.5 reference link in footnote has been changed from
+'http://developer.netscape.com/docs/manuals/js/core/jsref15/contents.html' to
+'http://developer.netscape.com/docs/manuals/index.html?content=javascript.html'
+
+
+- On page 120: '</script.' has been changed to '</script>'
+
+
+- On page 120: 'dump(l+'\n');' has been changed to 'dump(len+'\n');'
+
+
+- On page 135: Example 5-11 has been changed to
+<![CDATA[
+ <head>
+ <title>Sound Service Play Example</title>
+ <script>
+ function play() {
+ netscape.security.PrivilegeManager.enablePrivilege("UniversalXPConnect");
+ var sample = Components.classes["@mozilla.org/sound;1"].createInstance();
+ sample = sample.QueryInterface(Components.interfaces.nsISound);
+ const SND_NETWORK_STD_CID = "@mozilla.org/network/standard-url;1";
+ const SND_I_URL = "nsIURL";
+ const SND_URL = new C.Constructor(SND_NETWORK_STD_CID, SND_I_URL);
+ var url = new SND_URL();
+ url.spec = 'http://jslib.mozdev.org/test.wav';
+ sample.play(url);
+ }
+ </script>
+ </head>
+
+ <form name="form">
+ <input type="button" value="Play Sound" onclick="play();">
+ </form>
+]]>
+
+
- On page 137: 'var connection = Components.classes ["@mozilla.org/network/ldap-connection;1";'
+ has been changed to
+'var connection = Components.classes ["@mozilla.org/network/ldap-connection;1"];'
+
+
+- On page 140: 'js> load(`chrome/jslib/jslib.js');' has been changed to 'js>
+load('chrome/jslib/jslib.js');'
+
+
+
+
+
+Chapter 6
+
+
+
+- On page 145: Example 6-1 has been changed to
+
+<![CDATA[
+var myFile = "xFly.jar";
+initInstall( // initialize the installation
+ "Install xFly", // display name of installation
+ "xFly", // package name
+ "0.0.1", // version of install
+ 1); // flags - an optional argument,
+ // reserved for future use
+f = getFolder("Chrome"); // specify a target directory
+setPackageFolder(f);
+addFile(myFile); // add software to the installation
+registerChrome(
+ PACKAGE | DELAYED_CHROME, // chrome switch (i.e., type)
+ getFolder("Chrome","xFly.jar"), // destination of package
+ "content/xFly/"); // location of manifest in package
+if (0 == getLastError( )) // if there have been no errors:
+ performInstall( ); // install "xfly.jar"
+else // otherwise
+ cancelInstall( ); // cancel the installation.
+]]>
+
-
+
+Chapter 7
+
+
+
+- On page 181: There are 3 errors in Figure 7-2 ...
+
+1) In the XUL box, 'klabel="Input Field"' should be 'label="Input Field"'
+
+2) In the XBL box, '<binding id+"inputfield">' should be '<binding id="inputfield">'
+
+3) In the XBL box, '<xul:label xbl:inherits="value+label"?>' should be '<xul:label xbl:inherits="value=label"/>'
+
+Here is a correct image (Click for bigger version):
+
+
+
+
+
+
+
+
+
+
Chapter 8
-- In Chapter 8 (p 239) Example 8-15 has been changed to
-<![CDATA[
+<li>On page 211: In 2nd sentence of paragraph '<b class="broken">QueryInterace</b>' has been
+changed to '<b class="fixed">QueryInterface</b>'<br><br></li>
+
+<li>On page 222: In Example 8-4 has been changed to:
+
+<xmp class="fixed">
+function SimpleComponent(){}
+
+SimpleComponent.prototype = {
+
+ get yourName() { return this.mName; },
+ set yourName(aName) { return this.mName = aName; },
+
+ write: function () { dump("Hello " + this.mName + "\n"); },
+ change: function (aValue) { this.mName = aValue; },
+ mName: "a default value",
+
+ QueryInterface: function (iid) {
+ if (!iid.equals(Components.interfaces.nsISimple)
+ && !iid.equals(Components.interfaces.nsISupports))
+ {
+ throw Components.results.NS_ERROR_NO_INTERFACE;
+ }
+ return this;
+ }
+}
+
+var Module = {
+ firstTime: true,
+
+ registerSelf: function (compMgr, fileSpec, location, type) {
+ if (this.firstTime) {
+ dump("*** Deferring registration of simple JS components\n");
+ this.firstTime = false;
+ throw Components.results.NS_ERROR_FACTORY_REGISTER_AGAIN;
+ }
+ debug("*** Registering sample JS components\n");
+ compMgr =
+compMgr.QueryInterface(Components.interfaces.nsIComponentRegistrar);
+ compMgr.registerFactoryLocation(this.myCID,
+ "Simple JS Component",
+ this.myProgID,
+ fileSpec,
+ location,
+ type);
+ },
+
+ getClassObject : function (compMgr, cid, iid) {
+ if (!cid.equals(this.myCID))
+ throw Components.results.NS_ERROR_NO_INTERFACE
+ if (!iid.equals(Components.interfaces.nsIFactory))
+ throw Components.results.NS_ERROR_NOT_IMPLEMENTED;
+ return this.myFactory;
+ },
+
+ myCID: Components.ID("{98aa9afd-8b08-415b-91ed-01916a130d16}"),
+ myProgID: "@mozilla.org/js_simple_component;1",
+
+ myFactory: {
+ createInstance: function (outer, iid) {
+ dump("CI: " + iid + "\n");
+ if (outer != null)
+ throw Components.results.NS_ERROR_NO_AGGREGATION;
+ return (new SimpleComponent()).QueryInterface(iid);
+ }
+ },
+
+ canUnload: function(compMgr) {
+ dump("****** Unloading: Simple JS component! ****** \n");
+ return true;
+ }
+}; // END Module
+
+function NSGetModule(compMgr, fileSpec) { return Module; }
+]]>
+
+
+- On page 239: Example 8-15 has been changed to
+
+<![CDATA[
DEPTH = ../../..
topsrcdir = ../../..
srcdir = .
@@ -120,42 +401,108 @@ EXTRA_DSO_LDOPTS += $(MOZ_COMPONENT_LIBS
install:: $(TARGETS)
]]>
-
+
+Chapter 9
+
+
+
+
Chapter 10
-- In Chapter 10 (p 297) 'http://www.jslib.mozdev.org' has been changed
-to 'http://jslib.mozdev.org'
+
+- On page 280: In Table 10-3 'Mostly used for retrieving, datasources, resources, and literals.' has been
+changed to 'Mostly used for retrieving datasources, resources, and literals.'
+
+ - On page 297: 'http://www.jslib.mozdev.org' has been changed to 'http://jslib.mozdev.org'
+
-
+
+Chapter 11
+
+
+- On page 314: In Example 11-5 and Example 11-6 'var linetext =
+document.createTextNode(messageParagraphs[i]);' has been changed to 'var linetext =
+document.createTextNode(lines[i]);'
+
+
+
+
Chapter 12
-- In Chapter 12 (p 339) A new 'Certificate Authorities and Digital
+
- On page 336: In Example 12-6
+
+<![CDATA[
+ print ` <checkbox label="%s" />' % form['op1'].value
+ print ` <checkbox label="%s" />' % form['op2'].value
+ print ` <checkbox label="%s" />' % form['op3'].value
+]]>
+
+has been changed to (note the difference in indentation and in using a single quote versus a backtick)
+
+<![CDATA[
+ print ' <checkbox label="%s" />' % form['op1'].value
+ print ' <checkbox label="%s" />' % form['op2'].value
+ print ' <checkbox label="%s" />' % form['op3'].value
+]]>
+
+
-
+
Appendix A
-- In Appendix A (p 365) 'http://www.mozilla.org/source.tml' has been
-changed to 'http://www.mozilla.org/source.html'
+ - On page 365: 'http://www.mozilla.org/source.tml' has been changed to 'http://www.mozilla.org/source.html'
+
+
+Index
+
+
+
+- On page 437: 'Chimera, 2' has been changed to 'Camino, 2'
+
+
+
+
+
+