<div class="gmail_quote">On Sat, Feb 7, 2009 at 6:22 PM, Aidan Gauland <span dir="ltr"><<a href="mailto:wgsilkie@ihug.co.nz">wgsilkie@ihug.co.nz</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
Giuseppe Luigi Punzi <glpunzi <at> <a href="http://lordzealon.com" target="_blank">lordzealon.com</a>> writes:<br>
> We have elections soon.<br>
><br>
> I'ts time to think about the project. What we search? What new<br>
> developers search?<br>
<br>
For me, the biggest problem with Sqeuak at the moment is its lack of class and<br>
method comments (but not every method needs an overview comment). I would like<br>
to say to all developers of the uncommented system classes: "Will you please go<br>
back and comment, all the methods and classes you wrote, but failed to<br>
document!" And I know I'm not the only one who feels this way. Hold back on<br>
new features for just a minute, and give what we already have a quick polish.<br>
I've wasted many hours trying to puzzle out how to use complex yet undocumented<br>
methods (some weren't even documented on the Squeak Swiki). The basic<br>
collection classes, and the core system classes are well commented.<br>
<font color="#888888"><br>
-Aidan<br>
</font><br>
P.S No hard feelings, just some frustration. Sqeuak is a great development<br>
system, and seems to keep getting better.<br>
<br></blockquote><div><br></div><div>What would be extremely useful (to me at least) is to provide example usage for some of the more cryptic and difficult classes. The person writing them has the best understanding and probably had to test things out anyway. So why not just publish that code in the class comment? For example...</div>
<div><br></div><div>I've been struggling for 2 days trying to get a TCP client socket dialog with a telnet server. In VisualWorks, I would do something like:</div><div><br></div><div><div>wire := ( SocketAccessor newTCPclientToHost: 'telnetHostname' port: 23 ) readAppendStream.</div>
<div><br></div><div>I can then use: </div><div><br></div><div>wire throughAll</div><div><br></div><div>and</div><div><br></div><div>wire nextPutAll:</div><div><br></div><div>among other stream methods, to handle the communication.</div>
<div><br></div><div>I do notice the SocketStream has a HTTP example, but I don't think SocketStream is for TCP (I could be wrong, but there is no documentation either way).</div><div><br></div><div>I haven't figured it out yet in Squeak. I thought I could do something like this:</div>
<div><br></div><div>wire := SocketStream openConnectionToHostNamed: 'telnetHostname' port: 23.<br></div><div><br></div><div>and then use</div><div><br></div><div>wire upToAll:</div><div><br></div><div>and</div><div>
<br></div><div>wire nextPutAll:</div><div><br></div><div>but this just 'hangs' and I have to alt+. to abandon the process.</div><div><br></div><div>Is this even possible in Squeak? Or do I have to load something else into the image?</div>
<div><br></div><div>Sockets are very hard to debug and I don't want to have to use the Socket class. That is way too low level for me. The purpose of Smalltalk is to make things easy, no? ;-)</div><div><br></div><div>
Daniel Klein</div><div><br></div><div><div><br></div><div>"You do not really understand something</div><div>unless you can explain it to your grandmother."</div><div> -- Albert Einstein.</div><div>
<br></div></div></div></div>