I am in full agreement with Martin's statement about the lost script documentation. What a disappointment when I couldn't find how to use some string verb.
Think of the reaction of a young newcomer I am trying to get interested in J when I have to say "those scripts were documented, but they are not anymore". Think about how fast he turns away. I hope for a correction. ~ Gilles ---------- Original Message ----------- From: [email protected] To: [email protected] Sent: Fri, 22 Feb 2013 04:29:54 GMT Subject: Re: [Jgeneral] How access script documentation? > > Some previous scripts had been merged into stdlib. Even when > > scripts are available, most of them had been stripped all > > comments including information for scriptdoc. > > I think that this is a grave mistake. (The mutilation, > not necessarily the integration.) > > Firstly, like Murray, I am missing the documentation. Not just > for learning how a function is supposed to be used but also to find > a suitable function in first place. > > Secondly, we are often enough forced to dig into the library > functions when are not properly working. We *want* to help, but > having to that with a merged giant script bereft of sructure, layout, > and comments is like having insult added to injury. > > > You can browse source files from the web interface of the svn > > repositories or download a copy of them into your local harddisk. > > That whole shebang of having (a) "true" source scripts, (b) packages, > and (c) unpacked production scripts has always been needlessly > complex and over-the-top for my feeble mind. > > Martin > ---------------------------------------------------------------------- > For information about J forums see http://www.jsoftware.com/forums.htm ------- End of Original Message ------- ---------------------------------------------------------------------- For information about J forums see http://www.jsoftware.com/forums.htm
