[REBOL] Konka doc spin-offs
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/
