Notes on doc-needed bugs

  • Revision slug: Project:Notes_on_doc-needed_bugs
  • Revision title: Notes on doc-needed bugs
  • Revision id: 98032
  • Created:
  • Creator: jswisher
  • Is current revision? No
  • Comment 24 words added

Revision Content

The following list is based on dev-doc-needed+RESOLVED Bugzilla query. However, this list is manually maintained, and therefore may not be completely current. You can help by adding bugs that appear in the query but not in this list, with as much information as you can.

If you decide to work on one of these bugs, please add your name to the Doc Owner cell for that bug.

If you have questions about the documentation effort for any particular bug, you can add a comment to the bug, or ask in #devmo on irc.mozilla.org or the dev-mdc@lists.mozilla.org mailing list.

 Doc needed

Bug ID Title Doc Priority Doc Scope Doc Owner Notes
{{ Bug("59314") }} Alerts should be content-modal, not window-modal     Sheppy
Actively working, should be done soon (as of 2010-12-09)
{{ Bug("264308") }} Implement DOM Level 3 UserData API Low     Old bug, needs someone to figure out how it works. The spec is not very helpful. Needs to be scoped. Might need its own doc bug.
{{ Bug("321169") }} XUL templates need better logging capability      
Basically should amount to "how do you turn on and off logging of XUL templates". Add a link to https://developer.mozilla.org/en/XUL/Template_Guide for a "Debugging XUL templates" page.
{{ Bug("323810") }} [FIXr]Move forcing into tabs and current windows out of Gecko Low
Large
  For docs, see comment 13 and comment 14. The patch is very large and will take a while to go through to make sure nothing's missed. Mostly of interest to embedders, who tend to read the source anyway.
{{ Bug("368835") }} No focus events from xul tree table when a row is deleted       Need better docs of tree-related events.
{{ Bug("391829") }} Add support for container-live-role to object attributes   Easy  
Add container-live-role to 
{{ Bug("398776") }} (doorhanger) want mechanism for site-specific notification High     New API for creating doorhanger notifications. Needs sample code (based on tests?) and screenshots.
{{ Bug("399537") }} XPIDL documentation needs to be migrated and overhauled Medium     XPIDL is the language used when creating IDL files to define interfaces. Newcomers to the project need to know this.
{{ Bug("407963") }} [FUEL] Factor out generic toolkit aspects of FUEL into a reusable form Medium     FUEL is an abstraction layer between extensions and interfaces. Doc work may be done, or may be incomplete. Need to compare the state of the docs and the state of the code.
{{ Bug("412819") }} Mechanism for changing an extension GUID via updates High Small   Used by Add-on developers.  Basically changes the new Addon Manager API to let an extension being installed automatically uninstall an old one, so that an add-on that's changing its GUID can get rid of the old version automatically.
{{ Bug("427293") }} "Secure Connection Failed" makes it difficult to work in the web hosting industry Low Small   At most, this is documenting a preference that most users won't touch. Start a list of "super secret use-at-your-own-risk" preferences?
{{ Bug("431503") }} Create infrastructure to test processing of key events with different keyboard layouts Low Easy   Basically adds a single method to nsIDOMWindowUtils to let you programmatically inject keyboard events for testing. Only accessible from privileged code.
{{ Bug("433616") }} [FIX]Need facility for managing documents referenced via local URI references Medium Large   Needs research (probably more research than writing). Need to identify everything that gains cross-server support because of this change and update the relevant docs.
{{ Bug("435041") }} implement Cocoa NPAPI event model for Mac OS X High+Urgent Large   Massive update to the plugin developer docs for Mac OS X. To support 64-bit plugins, plugin developers need to switch to this new event model.
{{ Bug("451729") }} Allow runtime's security callbacks to be overridden by a context Medium     JS runtime docs changes. May have been started by jorendorff; unclear if it's finished.
{{ Bug("460882") }} setTimeout loses XPCNativeWrappers   Small   Need to find all the places to mention it. Need to check whether the API change is already documented.
{{ Bug("472529") }} (websocket) Support for Web sockets' HTML5 Draft Recommendation High Large   On hold pending spec changes. Document that it's disabled by default, and how to turn it on (at own risk). Point to the spec until further notice.
{{ Bug("480735") }} Startup timeline Low Easy   Only seriously deep core devs and testers will use it. Adds new API for logging during app startup.
{{ Bug("494345") }} Do not create accessibles for XUL label or description having a role of 'presentation'   Easy  
Small API change. Should only take minutes.
{{ Bug("501423") }} StorageEvent implementation does not match the spec High+Urgent     Needs to be done for Fx4. Update StorageEvent docs to match implementation (and spec).
{{ Bug("501490") }} Enable Taskbar Previews for Windows 7 Low     Reference stuff is mostly written, might need updating. To do: Make sure interface docs are up to date, then try to get a sample working.
{{ Bug("501925") }} Change cookie policy to relax the mailnews-specific APP_TYPE_MAIL requirement Medium for MozillaMessaging Unknown   Thunderbird-specific. Needs scoping.
{{ Bug("507012") }} Need an efficient and convenient execution tracing API for profiling Medium Easy   This will make it much easier for extension developers to find and fix their performance problems. API change for the JS runtime that lets you profile JS routines using a callback that gets run on function enter and exit. Should also get mentioned on the "Improving your extension's performance" page we need to write.
{{ Bug("507711") }} (callgraph) Produce mozilla-wide callgraph for static analyses Low     This is very important and useful to a very small number of people. We need to update our docs to provide information about where to get the callgraph generated by this project. There's initial documentation at https://developer.mozilla.org/en/Callgraph that need to be gone over to be sure it's current.
{{ Bug("511761") }} Only use compatibility.ini (not .autoreg, or stat()s) to invalidate fastloads and other caches Medium Unknown   See comments 43 and 54. Needs to be scoped. Pretty deep voodoo sounding stuff.
{{ Bug("512424") }} implement IAccessibleTable2   Easy   Use Trevor's API doc add-on to create interface reference docs (doesn't need more than that).
{{ Bug("513162") }} [Windows] Drawing in the Title Bar for the New Firefox Theme   Trivial   See comment 164; despite the huge bug ticket, the doc change is very minor.
{{ Bug("514120") }} Style resolution shows up as a serious cost when wrapping DOM nodes that have no frames   Moderate   This is a simple note that needs to be made, but figuring out where to put it will take some research.
{{ Bug("517580") }} Make JS_HAS_GETTER_SETTER always 1, remove support for old-style getters and setters   Easy  

Waldo blogged about this: http://whereswalden.com/2010/04/16/more-spidermonkey-changes-ancient-esoteric-very-rarely-used-syntax-for-creating-getters-and-setters-is-being-removed/

Waldo says: could summarize as "various non-standard syntaxes for defining getters and setters have been removed; syntax defined by ES5 has not been touched". There aren't any newly-obsolete functions.

{{ Bug("520696") }} Implement support for |{ get "string literal"() { /* ... */ }, get 5.4() { /* ... */ }, 6.72: 3 }|   Probably easy   Looks scarier than it probably is. Need to update https://developer.mozilla.org/en/JavaScript/Guide/Values,_Variables,_and_Literals#Literals. Plus wherever we have reference docs that apply.
{{ Bug("521141") }} Start menu / programs shortcuts pinned to the taskbar don't group correctly Low Probably easy   Good for someone familiar with the Windows installation process. This is about how to configure a Windows install for a Gecko app to properly let Windows know how to pin shortcuts.
{{ Bug("529404") }} Assignments to a property that has a getter but not a setter should only throw a TypeError in strict mode Medium Easy   Blogged at http://whereswalden.com/2009/12/21/ecma-262-ed-5-backwards-incompatible-change-coming-to-spidermonkey-and-to-gecko-based-browsers/ (per comment 11). Need to track down all the places where it needs to be mentioned, both in the JS reference and in the JS guide, as well as in "New in JavaScript 1.8.5" and the ECMAScript 5 docs.
{{ Bug("533592") }} Get rid of xpcnativewrappers=no Low Easy   There are notes on the "XPCOM changes in Gecko 2" page on this. xpcnativewrappers=no is a really really old old old feature, it had been deprecated for years when it was removed. The migration guide is "You must learn XPCWrappedNatives". Need to purge all mention of xpcnativewrappers=no except the place that says it's gone.
{{ Bug("536472") }} ES5: { get x(v) { } } and { set x(v, v2) { } } should be syntax errors   Easy  
This sounds like it may be a simple matter of a note in the ES5 page that says that this syntax is checked correctly now. And make sure that any changes that might be needed are made to https://developer.mozilla.org/en/JavaScript/Reference/Operators/Special/get and the corresponding set page.
{{ Bug("537873") }} Assignment to readonly properties should throw a TypeError in strict mode   Trivial   Need to note that strict mode now throws a TypeError in strict mode instead of silently failing if you try to change readonly properties. As usual, need to double check to be sure that if the old behavior is specifically mentioned anywhere, we update it.
{{ Bug("541373") }} Provide a global VACUUM component     Marco Bonardo [:mak] ?
The reference docs are written for this, but we could use an example for how to use it added. (Need to follow up with Marco re additional doc he was going to do.)

Doc completed

When you have finished documentation work for a bug, at the very least, please change the "dev-doc-needed" keyword to "dev-doc-complete". Then please also remove the row from the bug in the table above. If you want to celebrate completing the doc work, you can also paste the row to the table below, and change the "Doc Scope" value to the date you completed the work (this keeps the number of columns the same for easy pasting).

Bug ID Title Doc Priority Date Doc Completed Doc Owner Notes
           
           

 

Revision Source

<p>The following list is based on <a class=" link-https" href="https://bugzilla.mozilla.org/buglist.cgi?keywords=dev-doc-needed&amp;query_format=advanced&amp;keywords_type=allwords&amp;columnlist=assigned_to%2Cstatus_whiteboard%2Ckeywords%2Cshort_desc&amp;resolution=FIXED&amp;resolution=WORKSFORME&amp;product=Core&amp;product=Fennec&amp;product=Firefox&amp;product=NSPR&amp;product=NSS&amp;product=Tamarin&amp;product=Toolkit&amp;known_name=Updates%20Needed%20-%20Firefox%2FReady%20all%20Releases&amp;query_based_on=Updates%20Needed%20-%20Firefox%2FReady%20all%20Releases" title="https://bugzilla.mozilla.org/buglist.cgi?keywords=dev-doc-needed&amp;query_format=advanced&amp;keywords_type=allwords&amp;columnlist=assigned_to,status_whiteboard,keywords,short_desc&amp;resolution=FIXED&amp;resolution=WORKSFORME&amp;product=Core&amp;product=Fennec&amp;product=Firefox&amp;product=NSPR&amp;product=NSS&amp;product=Tamarin&amp;product=Toolkit&amp;known_name=Updates Needed - Firefox/Ready all Releases&amp;query_based_on=Updates Needed - Firefox/Ready all Releases">dev-doc-needed+RESOLVED</a> Bugzilla query. However, this list is manually maintained, and therefore may not be completely current. You can help by adding bugs that appear in the query but not in this list, with as much information as you can. </p>
<p>If you decide to work on one of these bugs, please add your name to the Doc Owner cell for that bug.</p>
<p>If you have questions about the documentation effort for any particular bug, you can add a comment to the bug, or ask in #devmo on irc.mozilla.org or the <a class=" link-mailto" href="mailto:dev-mdc@lists.mozilla.org" rel="freelink">dev-mdc@lists.mozilla.org</a> mailing list.</p>
<h2> Doc needed</h2>
<table border="0" cellpadding="1" cellspacing="1" class="standard-table"> <thead> <tr> <th scope="col">Bug ID</th> <th scope="col">Title</th> <th scope="col">Doc Priority</th> <th scope="col">Doc Scope</th> <th scope="col">Doc Owner</th> <th scope="col">Notes</th> </tr> </thead> <tbody> <tr> <td>{{ Bug("59314") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Alerts should be content-modal, not window-modal</span></span></td> <td> </td> <td> </td> <td>Sheppy</td> <td><br> Actively working, should be done soon (as of 2010-12-09)</td> </tr> <tr> <td>{{ Bug("264308") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Implement DOM Level 3 UserData API</span></span></td> <td>Low</td> <td> </td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">Old bug, needs someone to figure out how it works. The spec is not very helpful. Needs to be scoped. Might need its own doc bug.</span></td> </tr> <tr> <td>{{ Bug("321169") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">XUL templates need better logging capability</span></span></td> <td> </td> <td> </td> <td> </td> <td> <div class="ace-line" id="magicdomid187"><span class="author-g-qullz122zz122zn7l52wukz122z4">Basically should amount to "how do you turn on and off logging of XUL templates". Add a link to </span><span class="author-g-qullz122zz122zn7l52wukz122z4 url"><a href="/../../../../en/XUL/Template_Guide" title="../../../../en/XUL/Template_Guide">https://developer.mozilla.org/en/XUL/Template_Guide</a></span><span class="author-g-qullz122zz122zn7l52wukz122z4"> for a "Debugging XUL templates" page.</span></div> </td> </tr> <tr> <td>{{ Bug("323810") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">[FIXr]Move forcing into tabs and current windows out of Gecko</span></span></td> <td>Low</td> <td><br> Large</td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">For docs, see comment 13 and comment 14. </span><span class="author-g-qullz122zz122zn7l52wukz122z4">The patch is very large and will take a while to go through to make sure nothing's missed. Mostly of interest to embedders, who tend to read the source anyway.</span></td> </tr> <tr> <td>{{ Bug("368835") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">No focus events from xul tree table when a row is deleted</span></span></td> <td> </td> <td> </td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">Need better docs of tree-related events.</span></td> </tr> <tr> <td>{{ Bug("391829") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Add support for container-live-role to object attributes</span></span></td> <td> </td> <td>Easy</td> <td> </td> <td> <div class="ace-line" id="magicdomid420"><span class="author-g-qullz122zz122zn7l52wukz122z4">Add container-live-role to </span></div> <div class="ace-line" id="magicdomid581"><span class="author-g-ilfr7f1uo9dehk8e url"><a href="/.php?title=en/AJAX/WAI_ARIA_Live_Regions%2F%2FAPI_Support" title=".php?title=en/AJAX/WAI_ARIA_Live_Regions%2F%2FAPI_Support">https://developer.mozilla.org/index.php?title=en/AJAX/WAI_ARIA_Live_Regions%2F%2FAPI_Support</a></span><span class="author-g-ilfr7f1uo9dehk8e"> (is Ajax the correct topic here?)</span></div> </td> </tr> <tr> <td>{{ Bug("398776") }}</td> <td><span id="summary_alias_container">(<span id="alias_nonedit_display">doorhanger</span>) <span id="short_desc_nonedit_display">want mechanism for site-specific notification</span></span></td> <td>High</td> <td> </td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">New API for creating doorhanger notifications. Needs sample code (based on tests?) and screenshots.</span></td> </tr> <tr> <td>{{ Bug("399537") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">XPIDL documentation needs to be migrated and overhauled</span></span></td> <td>Medium</td> <td> </td> <td> </td> <td>XPIDL is the language used when creating IDL files to define interfaces. Newcomers to the project need to know this.</td> </tr> <tr> <td>{{ Bug("407963") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">[FUEL] Factor out generic toolkit aspects of FUEL into a reusable form</span></span></td> <td>Medium</td> <td> </td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">FUEL is an abstraction layer between extensions and interfaces. Doc work may be done, or may be incomplete. Need to compare the state of the docs and the state of the code.</span></td> </tr> <tr> <td>{{ Bug("412819") }}</td> <td><span id="summary_alias_container"> <span id="short_desc_nonedit_display">Mechanism for changing an extension GUID via updates</span></span></td> <td>High</td> <td>Small</td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">Used by Add-on developers.  Basically changes the new Addon Manager API to let an extension being installed automatically uninstall an old one, so that an add-on that's changing its GUID can get rid of the old version automatically.<br> </span></td> </tr> <tr> <td>{{ Bug("427293") }}</td> <td><span id="summary_alias_container"> <span id="short_desc_nonedit_display">"Secure Connection Failed" makes it difficult to work in the web hosting industry</span></span></td> <td>Low</td> <td>Small</td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">At most, this is documenting a preference that most users won't touch. Start a list of "super secret use-at-your-own-risk" preferences?</span></td> </tr> <tr> <td>{{ Bug("431503") }}</td> <td><span id="summary_alias_container"> <span id="short_desc_nonedit_display">Create infrastructure to test processing of key events with different keyboard layouts</span></span></td> <td>Low</td> <td>Easy</td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">Basically adds a single method to nsIDOMWindowUtils to let you programmatically inject keyboard events for testing. Only accessible from privileged code.<br> </span></td> </tr> <tr> <td>{{ Bug("433616") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">[FIX]Need facility for managing documents referenced via local URI references</span></span></td> <td>Medium</td> <td>Large</td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">Needs research (probably more research than writing). Need to identify everything that gains cross-server support because of this change and update the relevant docs.</span></td> </tr> <tr> <td>{{ Bug("435041") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">implement Cocoa NPAPI event model for Mac OS X</span></span></td> <td>High+Urgent</td> <td>Large</td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">Massive update to the plugin developer docs for Mac OS X. To support 64-bit plugins, plugin developers need to switch to this new event model.</span></td> </tr> <tr> <td>{{ Bug("451729") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Allow runtime's security callbacks to be overridden by a context</span></span></td> <td>Medium</td> <td> </td> <td> </td> <td>JS runtime docs changes. May have been started by jorendorff; unclear if it's finished.</td> </tr> <tr> <td>{{ Bug("460882") }}</td> <td><span id="summary_alias_container"> <span id="short_desc_nonedit_display">setTimeout loses XPCNativeWrappers</span></span></td> <td> </td> <td>Small</td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">Need to find all the places to mention it. Need to check whether the API change is already documented.</span></td> </tr> <tr> <td>{{ Bug("472529") }}</td> <td><span id="summary_alias_container">(<span id="alias_nonedit_display">websocket</span>) <span id="short_desc_nonedit_display">Support for Web sockets' HTML5 Draft Recommendation</span></span></td> <td>High</td> <td>Large</td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">On hold pending spec changes. Document that it's disabled by default, and how to turn it on (at own risk). Point to the spec until further notice.</span></td> </tr> <tr> <td>{{ Bug("480735") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Startup timeline</span></span></td> <td>Low</td> <td>Easy</td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">Only seriously deep core devs and testers will use it. Adds new API for logging during app startup.</span></td> </tr> <tr> <td>{{ Bug("494345") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Do not create accessibles for XUL label or description having a role of 'presentation'</span></span></td> <td> </td> <td>Easy</td> <td> </td> <td> <div class="ace-line" id="magicdomid1342"><span class="author-g-qullz122zz122zn7l52wukz122z4">Small API change. Should only take minutes.</span></div> </td> </tr> <tr> <td>{{ Bug("501423") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">StorageEvent implementation does not match the spec</span></span></td> <td>High+Urgent</td> <td> </td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">Needs to be done for Fx4. Update StorageEvent docs to match implementation (and spec).</span></td> </tr> <tr> <td>{{ Bug("501490") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Enable Taskbar Previews for Windows 7</span></span></td> <td>Low</td> <td> </td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">Reference stuff is mostly written, might need updating. To do: Make sure interface docs are up to date, then try to get a sample working.</span></td> </tr> <tr> <td>{{ Bug("501925") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Change cookie policy to relax the mailnews-specific APP_TYPE_MAIL requirement</span></span></td> <td>Medium for MozillaMessaging</td> <td>Unknown</td> <td> </td> <td>Thunderbird-specific. Needs scoping.</td> </tr> <tr> <td>{{ Bug("507012") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Need an efficient and convenient execution tracing API for profiling</span></span></td> <td>Medium</td> <td>Easy</td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">This will make it much easier for extension developers to find and fix their performance problems. </span><span class="author-g-qullz122zz122zn7l52wukz122z4">API change for the JS runtime that lets you profile JS routines using a callback that gets run on function enter and exit. Should also get mentioned on the "Improving your extension's performance" page we need to write.</span></td> </tr> <tr> <td>{{ Bug("507711") }}</td> <td><span id="summary_alias_container">(<span id="alias_nonedit_display">callgraph</span>) <span id="short_desc_nonedit_display">Produce mozilla-wide callgraph for static analyses</span></span></td> <td>Low</td> <td> </td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">This is very important and useful to a very small number of people. We need to update our docs to provide information about where to get the callgraph generated by this project. There's initial documentation at </span><span class="author-g-qullz122zz122zn7l52wukz122z4 url"><a href="/../../../../en/Callgraph" title="../../../../en/Callgraph">https://developer.mozilla.org/en/Callgraph</a></span><span class="author-g-qullz122zz122zn7l52wukz122z4"> that need to be gone over to be sure it's current.</span></td> </tr> <tr> <td>{{ Bug("511761") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Only use compatibility.ini (not .autoreg, or stat()s) to invalidate fastloads and other caches</span></span></td> <td>Medium</td> <td>Unknown</td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">See comments 43 and 54. Needs to be scoped. Pretty deep voodoo sounding stuff.</span></td> </tr> <tr> <td>{{ Bug("512424") }}</td> <td><span id="summary_alias_container"> <span id="short_desc_nonedit_display">implement IAccessibleTable2</span></span></td> <td> </td> <td>Easy</td> <td> </td> <td>Use Trevor's API doc add-on to create interface reference docs (doesn't need more than that).</td> </tr> <tr> <td>{{ Bug("513162") }}</td> <td><span id="summary_alias_container"> <span id="short_desc_nonedit_display">[Windows] Drawing in the Title Bar for the New Firefox Theme</span></span></td> <td> </td> <td>Trivial</td> <td> </td> <td>See comment 164; despite the huge bug ticket, the doc change is very minor.</td> </tr> <tr> <td>{{ Bug("514120") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Style resolution shows up as a serious cost when wrapping DOM nodes that have no frames</span></span></td> <td> </td> <td>Moderate</td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">This is a simple note that needs to be made, but figuring out where to put it will take some research.</span></td> </tr> <tr> <td>{{ Bug("517580") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Make JS_HAS_GETTER_SETTER always 1, remove support for old-style getters and setters</span></span></td> <td> </td> <td>Easy</td> <td> </td> <td> <p>Waldo blogged about this: <a class=" external" href="http://whereswalden.com/2010/04/16/more-spidermonkey-changes-ancient-esoteric-very-rarely-used-syntax-for-creating-getters-and-setters-is-being-removed/">http://whereswalden.com/2010/04/16/more-spidermonkey-changes-ancient-esoteric-very-rarely-used-syntax-for-creating-getters-and-setters-is-being-removed/</a></p> <p><span class="author-g-qullz122zz122zn7l52wukz122z4">Waldo says: could summarize as "various non-standard syntaxes for defining getters and setters have been removed; syntax defined by ES5 has not been touched". There aren't any newly-obsolete functions.</span></p> </td> </tr> <tr> <td>{{ Bug("520696") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Implement support for |{ get "string literal"() { /* ... */ }, get 5.4() { /* ... */ }, 6.72: 3 }|</span></span></td> <td> </td> <td>Probably easy</td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">Looks scarier than it probably is. Need to update </span><span class="author-g-qullz122zz122zn7l52wukz122z4 url"><a href="/../../../../en/JavaScript/Guide/Values,_Variables,_and_Literals#Literals" title="../../../../en/JavaScript/Guide/Values,_Variables,_and_Literals#Literals">https://developer.mozilla.org/en/JavaScript/Guide/Values,_Variables,_and_Literals#Literals</a></span><span class="author-g-qullz122zz122zn7l52wukz122z4">. Plus wherever we have reference docs that apply.</span></td> </tr> <tr> <td>{{ Bug("521141") }}</td> <td><span id="summary_alias_container"> <span id="short_desc_nonedit_display">Start menu / programs shortcuts pinned to the taskbar don't group correctly</span></span></td> <td>Low</td> <td>Probably easy</td> <td> </td> <td>Good for someone familiar with the Windows installation process. <span class="author-g-qullz122zz122zn7l52wukz122z4">This is about how to configure a Windows install for a Gecko app to properly let Windows know how to pin shortcuts. <br> </span></td> </tr> <tr> <td>{{ Bug("529404") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Assignments to a property that has a getter but not a setter should only throw a TypeError in strict mode</span></span></td> <td>Medium</td> <td>Easy</td> <td> </td> <td>Blogged at <span class="author-g-qullz122zz122zn7l52wukz122z4 url"><a class=" external" href="http://whereswalden.com/2009/12/21/ecma-262-ed-5-backwards-incompatible-change-coming-to-spidermonkey-and-to-gecko-based-browsers/">http://whereswalden.com/2009/12/21/ecma-262-ed-5-backwards-incompatible-change-coming-to-spidermonkey-and-to-gecko-based-browsers/</a></span><span class="author-g-qullz122zz122zn7l52wukz122z4"> (per comment 11). Need to track down all the places where it needs to be mentioned, </span><span class="author-g-qullz122zz122zn7l52wukz122z4">both in the JS reference and in the JS guide, as well as in "New in JavaScript 1.8.5" and the ECMAScript 5 docs.</span></td> </tr> <tr> <td>{{ Bug("533592") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Get rid of xpcnativewrappers=no</span></span></td> <td>Low</td> <td>Easy</td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">There are notes on the "XPCOM changes in Gecko 2" page on this. xpcnativewrappers=no is a really really old old old feature, it had been deprecated for years when it was removed. The migration guide is "You must learn XPCWrappedNatives". Need to purge all mention of xpcnativewrappers=no except the place that says it's gone.</span></td> </tr> <tr> <td>{{ Bug("536472") }}</td> <td><span id="summary_alias_container"> <span id="short_desc_nonedit_display">ES5: { get x(v) { } } and { set x(v, v2) { } } should be syntax errors</span></span></td> <td> </td> <td>Easy</td> <td> </td> <td> <div class="ace-line" id="magicdomid2396"><span class="author-g-qullz122zz122zn7l52wukz122z4">This sounds like it may be a simple matter of a note in the ES5 page that says that this syntax is checked correctly now. And make sure that any changes that might be needed are made to </span><span class="author-g-qullz122zz122zn7l52wukz122z4 url"><a href="/../../../../en/JavaScript/Reference/Operators/Special/get" title="../../../../en/JavaScript/Reference/Operators/Special/get">https://developer.mozilla.org/en/JavaScript/Reference/Operators/Special/get</a></span><span class="author-g-qullz122zz122zn7l52wukz122z4"> and the corresponding set page.</span></div> </td> </tr> <tr> <td>{{ Bug("537873") }}</td> <td><span id="summary_alias_container"> <span id="short_desc_nonedit_display">Assignment to readonly properties should throw a TypeError in strict mode</span></span></td> <td> </td> <td>Trivial</td> <td> </td> <td><span class="author-g-qullz122zz122zn7l52wukz122z4">Need to note that strict mode now throws a TypeError in strict mode instead of silently failing if you try to change readonly properties. As usual, need to double check to be sure that if the old behavior is specifically mentioned anywhere, we update it.</span></td> </tr> <tr> <td>{{ Bug("541373") }}</td> <td><span id="summary_alias_container"><span id="short_desc_nonedit_display">Provide a global VACUUM component</span></span></td> <td> </td> <td> </td> <td>Marco Bonardo [:mak] ?</td> <td> <div class="ace-line" id="magicdomid2421"><span class="author-g-qullz122zz122zn7l52wukz122z4">The reference docs are written for this, but we could use an example for how to use it added.</span> <span class="author-g-qullz122zz122zn7l52wukz122z4">(Need to follow up with Marco re additional doc he was going to do.)</span></div> </td> </tr> </tbody>
</table>
<h2>Doc completed</h2>
<p>When you have finished documentation work for a bug, at the very least, please change the "dev-doc-needed" keyword to "dev-doc-complete". Then please also remove the row from the bug in the table above. If you want to celebrate completing the doc work, you can also paste the row to the table below, and change the "Doc Scope" value to the date you completed the work (this keeps the number of columns the same for easy pasting).</p>
<table cellpadding="1" cellspacing="1" class="standard-table"> <thead> <tr> <th scope="col">Bug ID</th> <th scope="col">Title</th> <th scope="col">Doc Priority</th> <th scope="col">Date Doc Completed</th> <th scope="col">Doc Owner</th> <th scope="col">Notes</th> </tr> </thead> <tbody> <tr> <td> </td> <td> </td> <td> </td> <td> </td> <td> </td> <td> </td> </tr> <tr> <td> </td> <td> </td> <td> </td> <td> </td> <td> </td> <td> </td> </tr> </tbody>
</table>
<p> </p>
Revert to this revision