2

Author's Note: I'd have posted this to the 'Software Recommendations' Stack Exchange if I'd seen any questions posted about literate-programming software when I did a cursory search there, but I didn't, so here I am…


     I've been meaning to do some literate programming in the near future, so I did a Google search for it and came upon this web page of tool recommendations, which at first looked like a good listing. Upon further inspection, however, my initial impressions of it proved to be somewhat rushed and naïve, as it doesn't exactly seem to state unequivocally which of the tools it lists is the most standard, commonly accepted best practice, or most modern I should work with. From what I've read around the Web so far, the original WEB was for Pascal and CWEB was for C, but both are obsolete.
     Neither of these would help me, though, since I need something that works with C++, specifically that language's 2011, 2014, and upcoming 2017 revisions. That consideration, therefore, left noweb to me as a prominent option. I was going to use it, but then, alas, I discovered to my chagrin that it, too, is deemed obsolete, at least by the watermark on its CTAN listing, and, according to its homepage, has not seen a new release for over six years! Given this unpleasant surprise, can anybody recommend me a more modern literate-programming tool or toolchain usable with LaTeX that is still seeing developer maintenance to use?

closed as off-topic by Henri Menke, Zarko, TeXnician, Stefan Pinnow, Maarten Dhondt Aug 25 '17 at 5:03

This question appears to be off-topic. The users who voted to close gave this specific reason:

  • "This question does not fall within the scope of TeX, LaTeX or related typesetting systems as defined in the help center." – Henri Menke, Zarko, TeXnician, Stefan Pinnow, Maarten Dhondt
If this question can be reworded to fit the rules in the help center, please edit the question.

  • Questions asking us to recommend or find a book, tool, software library, tutorial or other off-site resource are not really on-topic as they usually do not revolve around an abstract issue. Instead, describe the problem and what has been done so far to solve it. Also, this is a general programming question. Please ask this in an answerable form on Stack Overflow. – Henri Menke Aug 25 '17 at 2:28
  • 2
    There are people on this site who use CWEB and answer questions about it. It's not obsolete (Knuth still uses it every week, he says). I think noweb is still in use too. Not all software needs new versions every year or even decade (consider TeX). In practice there are as many literate-programming tools/environments as programmers trying literate programming. I have had some success with org-mode and tangle, though I haven't used it with LaTeX: in some sense, producing typeset (for paper) listings of source code is itself obsolete. – ShreevatsaR Aug 25 '17 at 2:39
  • @HenriMenke: Very well; can this question be moved to the 'Software Recommendations' Stack Exchange, then? I think that might be a better idea since I might get a similar response to the one I encountered here on Stack Overflow. (I'll have to make an edit to get rid of my question's header, since such a move would make it irrelevant/non-applicable, but I can do that.) – RandomDSdevel Aug 26 '17 at 0:56
  • 1
    Knuth is still making updates to cweb, e.g. cweb 3.70 is less than a month old. – ShreevatsaR Aug 27 '17 at 5:24
  • 1
    Latest versions of CWEB handle C++, dunno how well . But it is TeX (not LaTeX!) only... – vonbrand Oct 24 '18 at 10:33