A filter for extracting TeX'able code from source files. I originally wrote this tool to support the writing of my book "Concurrent Programming in ML" (Cambridge University Press), and then later extended it to support other research languages that I have worked on (e.g., Moby and Manticore's Parallel ML).

Commands are specified as comments that must begin at the start of a line and have "(*@" as their first three characters.

The supported commands are (using SML comment syntax):

(*@FILE attributes files *)

open the list of files for extracted output with the specified attibutes (attributes are @LEFT, @CENTER)

(*@BEGIN files *)

start directing output to the files

(*@END files *)

stop directing output to the specified files; if files is empty, then all active files are stoped.

(*@BEGIN-ELLIPSE *)
(*@END-ELLIPSE *)

suspend/resume output to the current files.

(*@BEGIN-HIGHLIGHT *)
(*@END-HIGHLIGHT *)

suspend/resume highlighting the output to the current files. Currently, highlighting is represented by underlining.

(*@IF-FILE files *)
(*@ELIF-FILE files *)
(*@ELSE *)
(*@END-IF *)

conditional extraction

(*@INSERT
  ... stuff ...
*)

insert the stuff into the open files

(*@KW*)token(*@WK*)

treat the token as a keyword. This markup is not supported for all source languages.