True. But perhaps a short pop-up very briefly describing usage rather than opening the help page. And as to opening the script defining a name - it becomes even less useful if comments are stripped. Most of the time all one needs is a hint. Like those on the two-page cheat sheet for J primitives.
On Sun, Feb 24, 2013 at 7:16 AM, bill lam <[email protected]> wrote: > In J7/GTKIDE, that was already available, see > > http://www.jsoftware.com/jwiki/Guides/Gtk%20IDE#Context_Sensitive_Help > > Вс, 24 фев 2013, Don Guinn писал(а): > > 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 > > -- > 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
