On 01/20/2012 11:57 AM, Martin Baker wrote:
Does the code have to be physically in the same document as the documentation to achieve the aims of literate programming?
It all depends on your tools. If there were a tool that puts every code chunk into a separate file but while editing shows you the chunks in the order you want, you wouldn't care how your content is physically stored.
A tool that can show (maybe even different) views on code and documentation would certainly be optimal. Anyway, I think one of the important view is that a potential reader can understand the code and the ideas (theory) that the code builds on. So the "literate programmer" also has the task to linearize thoughts and help others to understand the program.
Different views on the program is another helpful feature, but without also restructuring the accompanying documentation, it would not belong to the world of LP.
LP doesn't say how things have to be stored. In only says that you embellish your documentation with nice constructive examples (the actual code).
(Traditionally, we embellish programs by documentation.) Ralf _______________________________________________ Axiom-developer mailing list Axiom-developer@nongnu.org https://lists.nongnu.org/mailman/listinfo/axiom-developer
