143387 - Tracking bug for Embedding API Reference

Status: RESOLVED FIXED

(www.mozilla.org :: General, defect)

Description

[Ellen Evans]

Please file any questions, additions, errors, etc re: this document here.  

Thanks.

Comment 1

[James Cox]

can you confirm the url for this document? if it's what i am thinking it is, i
am working on it already...

Comment 2

[James Cox]

http://www.mozilla.org/projects/embedding/EmbedInterfaceFreeze.html -- related url.

Comment 3

[Ellen Evans]

The URL will be added when the APIs are posted - probably by Friday, the 17th.

Thanks for the additional info, James.

Comment 4

[Ellen Evans]

Added URL

Comment 5

[Matthew Mastracci]

Nitpicks:

In the nsIInputStream list of methods
(http://mozilla.org/projects/embedding/embedapiref/embeddingapiTOC.html), "clos"
should be "close"

In nsIProfile
(http://mozilla.org/projects/embedding/embedapiref/embedapi56.html#1025700)
SHUTDOWN_CLEANSE is bigger than SHUTDOWN_PERSIST.

Thanks for the awesome ref!

Comment 6

[Martin Wulffeld]

I'm wondering if you could change the bgcolor #0000099 to something else because
it's exactly the same as the text selection color. In other words it's not
possible to see what you're selecting if you're over a block with that color. A
tad annoying.

Also putting the layout stuff in a style sheet would ease updating, the
documents would become smaller and less error prone blah blah..

Comment 7

[Ellen Evans]

"clos" -> "close", will fix the size problem today.

I'm working on moving to a .css version, should be available in the next couple
of weeks.  That should make the underlying code much easier to look at.  The
disappearing text in table thing doesn't happen on my machine.  What platform
are you using?  I can certainly adjust the shade of blue if you think it would
help.  The blue itself is part of the old style recommendations.

Comment 8

[Ellen Evans]

nsIProfile font size issue fixed

Thanks for all the good feedback, everyone

Comment 9

[Ellen Evans]

I've added the Necko interfaces, nsIFile/LocalFile, and nsIURIContentListener,
which, I think, brings the ref up to Moz 1.0 freeze levels.  If I've missed
anything, please let me know.

Comment 10

[Ellen Evans]

Changed to .css based format.  Zip file added at bottom of opening page
http://mozilla.org/projects/embedding/embedapiref/embedapi.html.

Also note change in URL for TOC
http://mozilla.org/projects/embedding/embedapiref/embedapiTOC.html   

Comment 11

[Ellen Evans]

I've added interfaces frozen between 1.0 and 1.4.

Comment 12

[Don Malcolm]

The frozen interface at 
http://www.mozilla.org/projects/embedding/embedapiref/embedapi55.html#1150910
specifies nsIIOService::offline as an attribute available for setting offline mode, and the documentation does not mention SetOffline or GetOffline.

When I attempt to use the offline attribute, I get an error message stating there is no member named 'offline'.

Eventhough SetOffLine is not documented as part of the frozon interface, it does work.

Could you please clarify if 'offline' is part of the frozen interface, and please consider updating the documentation on the frozen interface to include SetOffLine and GetOffLine.

Thank You,
Don.

Comment 13

[Andre Luiz Jarussi]

I wonder if it's possible to change de print windows itself. eg: change the shape of the pages, or enter a new text, somewhere on the window. 

thanks

Comment 14

[David Boswell]

Sheppy, should this Embedding API Reference content on www.mozilla.org be redirected to

http://developer.mozilla.org/En/Gecko_Embedding_API_Reference

Comment 15

[Eric Shepherd [:sheppy]]

In theory, except a lot of that material doesn't look like it's migrated yet.

Comment 16

[Timothy Madden]

Could you please mention the necesary include file and library file when describing a function/interface in the embedding API ?

Comment 17

[Timothy Madden]

I have found (using XULRunner compiled from mozilla-1.9.1 sources for Firefox) that embedder-provided nsWebBrowserChrome should also implement nsIInterfaceRequestor and nsIWeakReference (other than nsIEmbeddingSiteWindow) in order used by the runtime. Could this note be added on the page ?

Comment 18

[David Boswell]

To follow up on this bug, archiving legacy content is now a requirement for being able to move forward with the mozilla.org/.com merge.

If there is no plan to manually migrate this content in the short term, we will go ahead with moving this content off of www.mozilla.org and putting it someplace where it can decide what to do with it on your own schedule.  That may be either the www-archive.mozilla.org site or an archive section of MDN.

Comment 19

[Ellen Evans]

I personally have not been maintaining this doc since Netscape folded in 2003.  So I'm not sure who should have ownership of it going forward.

Comment 20

[David Boswell]

If no one currently owns this then archiving it makes sense.  This will let people know the content is not up to date and will leave the content in a place that is available for someone to update and migrate back to an appropriate place later.  I'll archive this soon unless there are objections.

Comment 21

[Chris More [:cmore]]

I'm closing this bug as this no longer exists on www.mozilla.org and has all been moved to www-archive.