How about being able to park the cursor/mouse over a primitive or any name
defined in the z locale and having a description of how to use it pop up?

On Sat, Feb 23, 2013 at 10:45 PM, bill lam <[email protected]> wrote:

> 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
>
----------------------------------------------------------------------
For information about J forums see http://www.jsoftware.com/forums.htm

Reply via email to