Parsing is line-by-line. Parse is basically a large table that looks at the first token in a line and then passes control to a subroutine to complete parsing the line.

If a line begins with '#', it is ignored. Unfortunately, there is a parse error if the '#' comment character appears later in the line.

The hairiest part of parsing is when one is parsing splices: The splice dag is parsed, and along with any sub-splices. Then the splice is "lifted" into its parent dag. It would be nice if the splice were represented in code as a subdag, along with nested dags; then we could just have subdags. The splice could then be parsed "lazily".

This code is all in parse.cpp. dagman_main calls parse(); at the end, you have the dag nodes in memory.

Probably need something about partial rescue dags here.

(Note: this has been changed to parse in two passes for the more flexible command ordering -- there's a ticket for this.) Note that this is kind of tricky if INCLUDE commands are used...