12071 - Outdated Necko doc needs to be linked to new doc

Status: RESOLVED WONTFIX

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

Description

[[e-mail]]

I'm a professional newbie, and I can't get my head around Necko.  I don't have
any APIs or any overview of Necko, and basically don't understand it at all.

The documentation talks about nsINetService, but I can't find an IDL file by
that name in /netwerk (where I think Necko resides).  There's a header file by
that name under /network/module, but are we still supposed to use that?

Specifically, I'm trying to do the following:

Create a URI;
Open up a channel;
Get the output stream from the channel;
and then the rest is just RDF.

I'm completely at a loss.  Please help!

Comment 1

[[e-mail]]

See <a
href="news://news.mozilla.org/37BDDDC6.E5FAB54B%40pacbell.net">here</a> for my
patch based on rummaging around Necko source.

news://news.mozilla.org/37BDDDC6.E5FAB54B%40pacbell.net

Comment 2

[Sammy Ford]

How about turning this into a necko documentation tracking bug? Since there is
much work to be done along those lines.

Comment 3

[Warren Harris]

*** Bug 14101 has been marked as a duplicate of this bug. ***

Comment 4

[Warren Harris]

Subject:
               Documentation tasks
         Date:
               19 Aug 99 04:49:53 GMT
        From:
               [e-mail] (Warren Harris)
 Organization:
               Another Netscape Collabra Server User
           To:
               [e-mail]
  Newsgroups:
               netscape.public.mozilla.netlib




In our meeting yesterday we discussed the need for documentation, and agreed
that we'd spend some time writing up some minimal/preliminary
documentation on various parts of necko. Here's the list:

   1.file specs and channels [dougt]
   2.streams [warren]
   3.core services [warren]
   4.necko util [warren]
   5.pluggable protocols [mscott]
   6.http [gagan]
   7.mime converters [valeski]
   8.dns [gordon]
   9.cache [tbd]
  10.event sink getter [tbd]

Please reply to this message when you've got something and we'll see where's a
good place to put it. Thanks,

Warren

PS. Note that we wouldn't turn down volunteers for some of these too!




Subject:
               Re: Documentation tasks
         Date:
               30 Aug 99 17:24:03 GMT
        From:
               [e-mail] (Judson Valeski)
 Organization:
               Netscape Communications
           To:
               Warren Harris <[e-mail]>
          CC:
               [e-mail]
  Newsgroups:
               netscape.public.mozilla.netlib
  References:
               1





Signed



Warren Harris wrote:

     1.mime converters [valeski]

http://JAZZ/users/valeski/publish/streamConverters.html

Jud

Comment 5

[leger]

Bulk move of all Necko (to be deleted component) bugs to new Networking

component.

Comment 6

[Warren Harris]

Moving to M17 which is now considered part of beta2.

Comment 7

[Paul MacQuiddy]

spam, changing qa contact from paulmac to [e-mail] on networking/RDF 
bugs

Comment 8

[Gagan]

cc'ing the group. 

guys help me clean this bug by writing up a page or two of the areas that you
have been working on. Send them to me and I will assemble them and post them up
on mozilla.org. thx.

Comment 9

[Judson Valeski]

crap. I just re-wrote the stream converters docs. I had forgotten there were 
some outstanding. grrr.

Comment 10

[Judson Valeski]

gagan, when you drop the new stuff in, please cleanup our old html/docs/netlib 
dir on gila, and put all the new stuff in html/projects.

Comment 11

[Will Sargent]

Is there any movement on this bug?  It seems like the APIs on nsIChannel change 
every month -- it's very frustrating not to have anything to which I can write 
an extension

Comment 12

[benc]

mass move, v2.
qa to me.

Comment 13

[benc]

qa to bbaetz
+helpwanted.

I've done a lot of hacking on the "wire" side of networking documentation
(www.packetgram.com), but this type of stuff is beyond my grasp for the near future.

Comment 14

[Bradley Baetz (:bbaetz)]

bryner wanted be to update the "how to write a protocol handler stuff". I'll try
to do that sometime this week.

Comment 15

[Bradley Baetz (:bbaetz)]

QA -> benc

Comment 16

[benc]

+qawanted - we don't have processes or document flow in bugzilla yet, but if qa
== review, it's beyond my current skills.

Comment 17

[benc]

-> documentation.

I looked at the link in the URL, and it is a document that is not linked in the
mozilla.org/catalog structure.

Is this document current or outdated? I can link it up if someone would take a
quick look at it.

Comment 18

[Daniel Wang]

The document you want is
http://www.mozilla.org/projects/netlib/necko_interface_overview.html

Comment 19

[benc]

I've added this link to:

http://www.mozilla.org/catalog/libraries/network/index.html

darin: is there other necko documentation you want to update or add to this page?

Comment 20

[benc]

I'm leaving whitebox testing and documents alone for now...

Comment 21

[Samuel Sidler (old account; do not CC)]

Docs that haven't already been moved to Devmo will be migrated. Outdated docs will be removed. This bug is old and makes me sad. WONTFIX. :)