7864 - xpidl authoring guide needs to be finished

Status: RESOLVED WONTFIX

(Developer Documentation Graveyard :: Mozilla Platform, defect)

Description

[Michael Ang]

Shaver, are you still working on this?

Comment 1

[Michael Ang]

Guess not. It's all up to me.

Comment 2

[Michael Ang]

Random stuff left to document
- use of NS_DECL_*
- out parameters through XPConnect

Other
- "string passing" in best practices is really about implementation, not
interface

Comment 3

[Michael Ang]

Also, need more docs on these keywords
- shared
- notxpcom

Comment 4

[Michael Ang]

Mass reassign to mccabe since I'm outta here.

Comment 5

[Mike McCabe]

Mass accept as ASSIGNED of xpidl bugs

Comment 6

[Mike McCabe]

[SPAM] Marking milestone 'future' as part of nsbeta3 triage.

(Actually, I think 'array' may be all we're missing.)

Comment 7

[Michael Ang]

Could also discuss use of %{C++ escape to define ProgID and CID in .idl file. 
IMO, this is marginally acceptable (stylistically) since there is often only one
component that implements that interface.  Should warn other implementers from
using the same CID.

Will add this and 'array' Real Soon Now.

Comment 8

[James Cox]

accepting QA for mozilla developer docs.

some of these bugs have been around for a _long_ time. Reporters, would you
please review the bugs, see if the issues have been resolved, and close bugs
appropriately.

I will do a full review of all bugs not touched in one week (8th April). 

Thanks.

</spam>

Comment 9

[Daniel Wang]

add url
taking over QA

reporter, is the guide finished?

Comment 10

[g4t3z]

yyyyyyyyyyyy

Comment 11

[Jothi]

something

Comment 12

[John Karahalis [:openjck]]

Reopening for review by Sheppy.

Comment 13

[Eric Shepherd [:sheppy]]

This still needs to be done. Anyone spend a lot of time in IDL that would like to finish this up?

Comment 14

[Florian Scholz (Open Web Docs)]

Trying to make this bug more clear for anyone who wants to work on this (this bug belongs to one of the very few open bugs where the ID is less than 10000!!!)

Looking at the inventory, there are the following docs for XPIDL on MDN:

https://developer.mozilla.org/en-US/docs/Mozilla/XPIDL
https://developer.mozilla.org/en-US/docs/Mozilla/XPIDL/Function_modifier
https://developer.mozilla.org/en-US/docs/Mozilla/XPIDL/Generating_xpt_on_Windows
https://developer.mozilla.org/en-US/docs/Mozilla/XPIDL/pyxpidl
https://developer.mozilla.org/en-US/docs/Mozilla/XPIDL/Syntax
https://developer.mozilla.org/en-US/docs/Mozilla/XPIDL/xpidl

These docs could need a review and are probably in need of some updates to reflect current reality.
There is also the archived material at http://www-archive.mozilla.org/scriptable/xpidl/idl-authors-guide/ which was requested to be migrated to MDN in bug 399537.

Sheppy, are you working on this in the foreseeable future? If not, please unassign so that this is open to anyone.

Comment 15

[Jean-Yves Perrier [:teoli]]

If there is no objection, I plan to archive this area in a few days. It is no longer in the scope of MDN and is unmaintained for years.

Comment 16

[Janet Swisher]

Finally closing this issue and archiving the XPIDL docs. They now live under https://developer.mozilla.org/en-US/docs/Archive/Mozilla/XPIDL