[Aldor-l] Literate programming

[pip88nl at gmail.com]

On Tue, Aug 19, 2008 at 11:29:33PM -0400, Thomas J. Moore wrote:
> On 08/19/08 17:06, Ralf Hemmecke wrote:
> > If I spot some place that I further want to work on, I simply click into 
> > the dvi viewer and voila, emacs suddenly opens the corresponding file at 
> > the correct place.
> > That works because of "inverse search".
> > http://www.hemmecke.de/aldor/allprose/myalpssu21.html#x62-5800024.3.9
> 
> Yes, I think inverse search is a neat feature, and I was aware your 
> system supported it.  It might be just what Pippijn was looking for, but 
>   it's definitely not for me.  It doesn't fit my programming style, and 
> I just don't see a problem with using a plain search.

I use plain text search. As for the code chunks scattered all over the
file, I automated that (if I press % on a <<foobar>>, it looks for the
previous (yes, previous, I think there is a bug in vim that prevents
forward searches using searchpair(), at least for me it does not work)
match of <<foobar>>.

I am currently on vacation in austria, so I will have limited time to
code, but I am working on backtrace.cc (from librona), making it a
literate programming file. I hope some of you can comment on my
interpretation of literate programming. I want to do it right and it's a
bit strange for me still.

By the way, as I see it, API documentation should be in POD and code
documentation in LaTeX along with the code (as literate programs). POD is
excellent for API documentation. Am I seeing this right?

Pippijn
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
URL: <http://mail.aldor.org/pipermail/aldor-l_aldor.org/attachments/20080820/cb48c993/attachment-0002.bin>