Gittrac #1780:  Added comments clarifying the relevant DAG parsing
code (just comments, no actual code changes); added some comments and
improved error messages in job_dagman_splice-R.run, which tests this
functionality.