First, thanks to all the devs for creating this wonderful and intriguing
language.
When I lookup documentation on a generic word like: nth, below the
general information and definition, I get a list of all the methods, each
of them with lots of implementation details like what vocabularies they
use, and their complete definition.
Example: searching for 'nth', I get:
[..snip..]
Definition
IN: sequences
GENERIC: nth ( n seq -- elt ) flushable
Methods
USING: accessors grouping kernel math sequences ;
M: circular-clumps nth
[ n>> over + ] [ seq>> ] bi
[ <circular-slice> ] [ like ] bi ; inline
USING: accessors kernel math quotations sequences ;
M: curry nth
over 0 =
[ nip obj>> literalize ] [ [ 1 - ] dip quot>> nth ] if ;
USING: sequences sequences.private ;
M: sequence nth bounds-check nth-unsafe ; inline
USING: grouping.private sequences ;
M: slice-chunking nth group@ <slice> ; inline
[..snip..]
This is all nice and all, but for a word with a lot of methods, all this
detail quickly crowds over what I'd really want to know: like which
classes these methods support.
I was wondering if, instead of listing all the details for each method,
we could have just a simple listing of all methods, where clicking on a
line takes one to its definition.
Actually, I tried something like this already:
IN: scratchpad \ nth methods [ . ] each
M\ circular-clumps nth
M\ curry nth
M\ sequence nth
M\ slice-chunking nth
M\ sliced-circular-clumps nth
M\ subseq-chunking nth
M\ tag nth
M\ virtual-sequence nth
M\ xml-chunk nth
M\ xml nth
Apart from the fact that the M: are replaced by M\ , this does exactly
what I would like: the listing is much shorter, no confusing
implementation details, and clicking on a line (between the words) takes
me right to that method's definition, with all the detail I could
possibly want.
I wonder if this is worth implementing. Any ideas, suggestions?
Kind regards,
Alain
------------------------------------------------------------------------------
Everyone hates slow websites. So do we.
Make your web apps faster with AppDynamics
Download AppDynamics Lite for free today:
http://p.sf.net/sfu/appdyn_d2d_mar
_______________________________________________
Factor-talk mailing list
Factor-talk@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/factor-talk
