C++ experiment

whatis/.gitignore

@@ -16,3 +16,15 @@ tests_Makefile
 didactic_output_*
 didactic_code_*
 whatis.tex
+cppfrac.mk
+cppjava.tex
+fracexample
+fracexample.cpp
+fracexample.noline.cpp
+fracexample2.cpp
+fractest
+fractest.cpp
+fraction.cpp
+fraction.h
+fraction.o
+

whatis/Makefile

@@ -10,16 +10,24 @@ SRC+=		foo.bar foo.tex
 SRC+=		introsort.tex introsort.py
 SRC+=		test_introsort.py
 SRC+=		tests_Makefile
+SRC+=		cppjava.tex
 
 FIGS+=		figs/pbr.png figs/pbrcover.jpg
 FIGS+=		figs/jupyter-lab.png figs/jupyter-notebook.png
 FIGS+=		figs/pythontex.pdf figs/web.pdf figs/noweb.pdf
 
+DEPENDS+=	fracexample
+SRC+=		fracexample.cpp
+SRC+=		fracexample2.cpp
+
+fracexample2.cpp: cppjava.nw
+	${NOTANGLE.cxx}
+
 notes.pdf: notes.tex didactic.sty
-notes.pdf: ${SRC} ${FIGS}
+notes.pdf: ${SRC} ${FIGS} ${DEPENDS}
 
 slides.pdf: slides.tex didactic.sty
-slides.pdf: ${SRC} ${FIGS}
+slides.pdf: ${SRC} ${FIGS} ${DEPENDS}
 
 contents.tex: whatis.nw
 	${NOWEAVE.tex}
@@ -54,7 +62,12 @@ clean:
 	${RM} tests_Makefile
 	${RM} didactic_output_*
 	${RM} didactic_code_*
+	${RM} cppfrac.mk
+
+cppfrac.mk: cppjava.nw
+	${NOTANGLE.mk}
 
+include cppfrac.mk
 
 INCLUDE_MAKEFILES=../makefiles
 include ${INCLUDE_MAKEFILES}/tex.mk

whatis/abstract.tex

@@ -5,19 +5,17 @@
 % What's the findings? How was it evaluated, what are the results, limitations, 
 % what remains to be done?
 
-% XXX Summary
 \emph{Summary:}
 We'll introduce literate programming: what it is, one tool and a workflow to 
 use it.
 We'll also discuss the potential benefits of literate programming, and how it 
 relates to different techniques used in programming.
 
-% XXX Motivation and intended learning outcomes
 \emph{Intended learning outcomes:}
 We intend that the student reach the following learning objectives.
 \ltnote{%
-  In terms of variation theory~\cite{NecessaryConditionsOfLearning}, we can 
-  divide these learning objectives into several aspects.
+  In terms of variation theory \parencite{NecessaryConditionsOfLearning}, we 
+  can divide these learning objectives into several aspects.
   The following is a first approximation of what those aspects are.
   We'll need to refine this as we learn how students perceive this.
   LO~\ref{LOlitprog} covers:
@@ -41,21 +39,21 @@
   LO~\ref{LOnoweb} covers several aspects:
   \begin{enumerate}
     \item Tangle the literate program into the machine-readable code.
+      Which in turn concerns several aspects; such as how to have several files 
+      in one file, use the Noweb langugage.
     \item Weave the literate program into a human-readable document.
   \end{enumerate}
 }%
 \begin{restatable}{lo}{LOnoweb}\label{LOnoweb}
   The student can use \texttt{noweb} to write literate programs.
 \end{restatable}
 
-% XXX Prerequisites
 \emph{Prerequisites:}
 The student should be able to write programs using a language like Python and 
 be able to run them.
 The student should also be able to write documents using \LaTeX.
 Finally, the student should be able to use a terminal.
 
-% XXX Reading material
 \emph{Reading:}
 The material is self-contained, but the student may find it useful to read the 
 references at the end.