Konka doc spin-offs
[1/6] from: jskibinski:emailaccount at: 19-Aug-2003 11:43
Hi all,
I will be soon announcing 1.0.6 version of Konka. A significant
documentation effort has taken place in the last weeks and
it has produced several spin-offs worthy to share with you. I'll
soon post a short message with downloading address. In meantime
here is the description of the reusable components for you
to enjoy.
1. foldable.r
Foldable list gadget, embeddable in any layout.
2. easy-viewer-bis.r and manual-parser.r
Much modified easy-viewer.r has been split into viewing and
parsing part, so latter can be used independently, as Konka does.
Uses foldable.r
3. multistyle-text.r
Its 'collage function takes a list of text styles and text strings
and builds a text with emphasized parts, wrapping the text between
the left and the right margins. Still a bit slow, needs some
improvements. For example, I did no know where to find the glyph
sizes, so I hacked it myself - using the 'size-text function.
4. yelp.r
Documentation extractor and formatter. Uses multistyle-text.r
for the View format. Parsing is fast, formatting for HTML is fast,
formatting for View is fast enough for a single access but too
slow for generation of documentation of many functions.
For example, Konka manual documents 25 API functions, and as a result
Easy-viewer-bis invocation takes about 3 seconds. Without
API it shows very fast.
In addition to the above I am providing konka-doc.txt, konka-api.r,
hof.r and slighly modified make-doc.r, so you can run the tests
on the really big documentation and see how it all works together.
Read chapter REMOTE API and section YELP in APPENDICES
of konka documentation, so you will find more about yelp
capabilities.
Jan
_____________________________________________________________
Finally, a free email address your friends will remember!
Become [you--EmailAccount--com] at http://www.emailaccount.com/
[2/6] from: brett:codeconscious at: 21-Aug-2003 13:22
> I will be soon announcing 1.0.6 version of Konka. A significant
> documentation effort has taken place in the last weeks and
> it has produced several spin-offs worthy to share with you. I'll
> soon post a short message with downloading address. In meantime
> here is the description of the reusable components for you
> to enjoy.
Sounds interesting! Looking forward to seeing these :^)
Regards,
Brett.
[3/6] from: jskibinski:emailaccount at: 21-Aug-2003 11:39
Hi Brett and All,
--- "Brett Handley" <[brett--codeconscious--com]> wrote:
>> I will be soon announcing 1.0.6 version of Konka. A significant
>> documentation effort has taken place in the last weeks and
<<quoted lines omitted: 3>>
>> to enjoy.
>Sounds interesting! Looking forward to seeing these :^)
Grab any of these two:
http://www.lun.pl/konka/files/konka-doc.zip
http://www.lun.pl/konka/files/konka-doc.tar.gz
and you will be able to generate HTML version of documentation
using provided (slightly modified) make-doc.r. Do %konka-doc.r
to start Easy Viewer Bis on konka-doc.txt. Prefered.
Here is an access to a pre-generated HTML doc if you are not
interested in the scripts provided above. Takes time - this
is a 360 K file with images!
http://www.lun.pl/konka/doc/konka-doc.html
Enjoy,
Jan
_____________________________________________________________
Finally, a free email address your friends will remember!
Become [you--EmailAccount--com] at http://www.emailaccount.com/
[4/6] from: atruter:labyrinth:au at: 22-Aug-2003 8:59
Impressive stuff. Your html doco "sold" it to me in less than 5 seconds! ;)
> Here is an access to a pre-generated HTML doc if you are not
> interested in the scripts provided above. Takes time - this
> is a 360 K file with images!
> http://www.lun.pl/konka/doc/konka-doc.html
Regards,
Ashley
[5/6] from: brett::codeconscious::com at: 22-Aug-2003 9:46
Wow. Impressive work Jan!
Regards,
Brett
[6/6] from: greggirwin:mindspring at: 22-Aug-2003 8:06
Indeed! Cool stuff Jan! Very impressive.
-- Gregg
Notes
- Quoted lines have been omitted from some messages.
View the message alone to see the lines that have been omitted