I think stdlib is special in that it is loaded automatically
during booting.  For cgi applications I certainly welcome the
current behavior.  Will you accept if a separate documentation 
file for stdlib be available somewhere?  There is a joxygen
addon but I have no experience with it or the original oxygen
either.

Вс, 24 фев 2013, Gilles Kirouac писал(а):
> 
>   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

-- 
regards,
====================================================
GPG key 1024D/4434BAB3 2008-08-24
gpg --keyserver subkeys.pgp.net --recv-keys 4434BAB3
----------------------------------------------------------------------
For information about J forums see http://www.jsoftware.com/forums.htm

Reply via email to