<div dir="ltr"><div dir="ltr">On Mon, Nov 8, 2021 at 12:36 PM Scott Kruger <<a href="mailto:kruger@txcorp.com">kruger@txcorp.com</a>> wrote:<br></div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On 2021-11-06 11:12, Matthew Knepley did write:<br>
> On Sat, Nov 6, 2021 at 10:34 AM Patrick Sanan <<a href="mailto:patrick.sanan@gmail.com" target="_blank">patrick.sanan@gmail.com</a>><br>
> wrote:<br>
> > I don't know what WEB is, but if you're saying that this is kinda clunky,<br>
> > yes it definitely is - my only contention is that it's better than<br>
> > copy-pasting code and output.  I'm not sure if there's an easier and/or<br>
> > better way with Sphinx.<br>
> ><br>
> <br>
> WEB was the futuristic documentation idea of Don Knuth.<br>
> <br>
<br>
It never caught on (for good reasons IMO), but it is important<br>
historically and programmers should be aware of it:<br>
<a href="https://en.wikipedia.org/wiki/Literate_programming" rel="noreferrer" target="_blank">https://en.wikipedia.org/wiki/Literate_programming</a></blockquote><div><br></div><div>Threadjack:</div><div><br></div><div>My major problem with WEB was that it in essence assumed that everything was One Big Source File.</div><div>I tried documenting parts of PETSc with it in the 90s and I found that it did not perform as well as sowing</div><div>because it really wanted one gigantic control flow, just like the algorithms Knuth was presenting. Maybe</div><div>a combination of sowing and Web could bridge the gap.</div><div><br></div><div>  Thanks,</div><div><br></div><div>    Matt</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><br>
For those who love literate programming and fortran, PPPL developed this<br>
in the 80's:<br>
<a href="https://w3.pppl.gov/~krommes/fweb.html" rel="noreferrer" target="_blank">https://w3.pppl.gov/~krommes/fweb.html</a><br>
and I believe it is still maintained.<br>
<br>
I dealt with a code written with this tool.  Interesting, but I never<br>
wanted to follow it myself.  <br>
<br>
Scott<br>
<br>
<br>
<br>
>   Thanks,<br>
> <br>
>      Matt<br>
> <br>
> <br>
> ><br>
> >> Doing actual literate documentation of key tutorial programs would be a<br>
> >> nice way of doing this, but I realise that's a lot more effort.<br>
> >><br>
> > This is still a hope/plan to go into doc/tutorials - follow the deal.ii<br>
> > model for a small number of key examples. Matt has done a couple of pages<br>
> > there already, in this direction.<br>
> ><br>
> > Lawrence<br>
> ><br>
> ><br>
> <br>
> -- <br>
> What most experimenters take for granted before they begin their<br>
> experiments is infinitely more interesting than any results to which their<br>
> experiments lead.<br>
> -- Norbert Wiener<br>
> <br>
> <a href="https://www.cse.buffalo.edu/~knepley/" rel="noreferrer" target="_blank">https://www.cse.buffalo.edu/~knepley/</a> <<a href="http://www.cse.buffalo.edu/~knepley/" rel="noreferrer" target="_blank">http://www.cse.buffalo.edu/~knepley/</a>><br>
<br>
-- <br>
Scott Kruger<br>
Tech-X Corporation               <a href="mailto:kruger@txcorp.com" target="_blank">kruger@txcorp.com</a><br>
5621 Arapahoe Ave, Suite A       Phone: (720) 466-3196<br>
Boulder, CO 80303                Fax:   (303) 448-7756<br>
</blockquote></div><br clear="all"><div><br></div>-- <br><div dir="ltr" class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div>What most experimenters take for granted before they begin their experiments is infinitely more interesting than any results to which their experiments lead.<br>-- Norbert Wiener</div><div><br></div><div><a href="http://www.cse.buffalo.edu/~knepley/" target="_blank">https://www.cse.buffalo.edu/~knepley/</a><br></div></div></div></div></div></div></div></div>