I bet very few users have actually used that context help feature. It will open the original source file and jump to the exact line containing the name concerned.
Your suggestion of pop up from mouse hovering is appealing, but I'll leave that to Chris. Вс, 24 фев 2013, Don Guinn писал(а): > 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 -- 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
