On Fri, 10 Jun 2005, Jean-Marc Lasgouttes wrote:
> >>>>> "G" == G Milde <[EMAIL PROTECTED]> writes:
>
> >> And all of this is 1.5 stuff anyway.
>
> G> Does this mean I have to wait another 2 years for documented lfuns
> G> (or could this possibly also go to 1.4.x)?
>
> It may happen, but do not count on it. That is I suggested to start
> without waiting for support in main source :)
It seems I opened a can of worms here :-) I haven't had time to
digest all the posts yet, so I'll have to get back to you later on.
Anyway, although I also feel that the documentation should (eventually) be
stored in the source, I can see why now is not a good time for that.
So creating a separate documentation for the lfuns might be a good way to
start. And I guess there won't be too much happening with the lfuns
between now and 1.5 anyway, so it shouldn't matter too much. In addition,
if we write some documentation first, we'll have a better idea of how we'd
like to go about storing it more permanently.
I assume Gunter and I can "pepper" the devel-list with questions as to
what the different lfuns actually do? (We might even be able to decipher
this from the source - knock on wood)
On a more practical aspect, this will have to wait a few days until I've
started the transition of the devel pages to a so called "wiki field". But
this might be a useful test case for me in the transition to the new wiki
engine.
/Christian
PS. As for Lars' comment about having to learn wiki markup, the writer -
whoever it is - *will* have to learn some kind of markup. I don't see the
need for lots of italics or bold, but I do expect it will be really useful
to let an lfun-description refer to another lfun (producing a link).
Here's an imaginary example for the lfun 'char-left'
Moves one character to the left, also see [[char-right]].
where [[...]] would be used to refer to another lfun. From the perspective
of wiki markup, this is simply a link to another page called 'char-right'.
--
Christian Ridderstr�m, +46-8-768 39 44 http://www.md.kth.se/~chr
