From a "first thought" I would probably go to rxsock to find the doc on "streamsocket", (because I am thinking sockets at the time) so maybe the doc should be there, with a "comment" in the rexref that the documentation is actually in rxsock.
Likewise, I think that other "external" packages should have a cross-reference entry in the Rexxref documentation to inform the user where to find the compete documentation. This would make the rexref, the first choice to find something, with the complete documentation (and any additional or backup material, including the possibility of detailed/documented examples) located in a more appropriate "topical" reference. As a newcomer to the concept of classes and inheritance, etc - I have a hard time find discriptions of things I know exist - possible because I do not fully comprehend the "pecking order" yet. I suspect that those of you that grew up with this concept probably find it far easier to find the doc when you need it... <grin> /s/ Bill Turner, wb4alm David Ashley wrote: > All - > > I have already moved socket.cls from the incubator to the main/trunk. In > addition I added the documentation for this class to the rxsock docs. > > I have not moved the streamsocket class out of the incubator yet because > I can not make up my mind where the docs for it should go. On the one > hand they would fit nicely in the rxsock docs but since streamsocket is > a subclass of the InputOutput class it also makes since that they should > go in the rexref. > > If you have opinions on this I would like to hear from you. > > For now the smtp.cls and mime.cls should remain in the incubator. There > is still some work I want to do to those classes. > > Thanks, > W. David Ashley > IBM Systems and Technology Group Lab Services > Open Object Rexx Team > > > ------------------------------------------------------------------------- > This SF.Net email is sponsored by the Moblin Your Move Developer's challenge > Build the coolest Linux based applications with Moblin SDK & win great prizes > Grand prize is a trip for two to an Open Source event anywhere in the world > http://moblin-contest.org/redirect.php?banner_id=100&url=/ > _______________________________________________ > Oorexx-devel mailing list > Oorexx-devel@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/oorexx-devel > > ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ _______________________________________________ Oorexx-devel mailing list Oorexx-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/oorexx-devel