Re: [pdf-devel] torture utils and test data files: Comment format

[jemarch]

Hi Gerel.

    > The current format should be currently used in every test file, but it
    > would need to be extended to support an easily-parseable list of used
    > data files. Can you send a proposal to the list?

   BTW, I don't really want to define a very strict format, it will be tedious 
to
   use and to parse, I'll rather try to adapt the parser to the format already
   used.

   So, after reading some tests, I think the following format is fine:
   /*
    * Test: newline* <name> newline*
    * Description: newline* <description> newline*
    * Success condition[s]: newline* <cond 1> [newline+ <cond X>...] newline*
    * [Data file[s]: newline* <file 1> [<file X>...] newline*]
    */

   Where newline*/+ means zero/one or more new lines.
   Notice that in case of success conditions the newlines are meaningful, they
   separate each condition.
   For data files since the name format is very strict 'TDXXXXX' we can use any
   non-alphanumeric character as separator.
   Summarizing, the truly important part is the beginning string "Test:" that 
can
   be found after any number of spaces/newlines.

   Anyways, that's it.

It seems ok to me.