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

Reply via email to