Function Documentation



>>>>> "Rupert" == Rupert Swarbrick <rswarbrick at gmail.com> writes:

    Rupert> Raymond Toy <toy.raymond at gmail.com> writes:
    Richard> The current documentation setup is unfortunately kept rather separate
    Richard> from the code that is read into memory by load() or batch().  This is
    Richard> partly a relic of an earlier time when memory was a scarce resource,
    Richard> and partly that the processing of text is being done by other programs
    Richard> in a batch operation...  at least as far as I understand it. But
    Richard> I haven't really tracked the various modifications of the routines.
    >> 
    >> Yes, that's basically it.  But there is a git branch where all of the
    >> parsing is done using Lisp.

    Rupert> Yep, and the feature would be very easy to add on that branch, because I
    Rupert> separated out the "how to provide documentation" stuff a bit
    Rupert> further. But I got bored of pushing the branch at everyone since it

I don't think that should be a deterrent (pushing at everyone).  After
all, it's on a branch, and those interested will continue to look at
it, and those that aren't, aren't using your branch anyway.

    Rupert> needs testing on Windows and I didn't have a Windows machine to test
    Rupert> everything on. I've managed to install a virtual XP instance on an old
    Rupert> laptop, but haven't spent the time getting everything to build yet. And
    Rupert> it's all horrendously painful and not fun at all. Bleugh.

I have a Windows machine I can use.  But the last time I tried
building maxima on Windows, it worked once and thereafter failed to
even start up the shell (mingw?) anymore.  So no promises on anything
getting done. :-(

Ray