[ET Trac] [Einstein Toolkit] #1303: document syntax of new parameter file parser

[Einstein Toolkit]

#1303: document syntax of new parameter file parser
--------------------+-------------------------------------------------------
 Reporter:  rhaas   |       Owner:     
     Type:  defect  |      Status:  new
 Priority:  major   |   Milestone:     
Component:  Cactus  |     Version:     
 Keywords:          |  
--------------------+-------------------------------------------------------
 currently we have no documentation as to what format the new parser
 accepts. As a matter of fact the documentation in the UsersGuide (see
 http://einsteintoolkit.org/documentation/UsersGuide/UsersGuidech7.html#x10-37000B3.2)
 is in contradiction with what the parser will allow:

 {{{
 * The parameter file is read sequentially from top to bottom, this means
 that if you set the value of a parameter twice in the parameter file, the
 second value will be used.
 * String parameter values can be specified either as unquoted tokens (not
 containing any whitespace), or as quoted values. If a quoted string
 parameter value spans multiple lines, all whitespaces, including newline
 characters, are preserved.
 }}}

 which will fail. Actually the first one is already incorrect with the
 current implementation which does not allow a parameter to be set twice
 (since this is often a sign of a user error).

 While this is "just" documentation, I'll still flag it as major since the
 parser is so fundamental.

-- 
Ticket URL: <https://trac.einsteintoolkit.org/ticket/1303>
Einstein Toolkit <http://einsteintoolkit.org>
The Einstein Toolkit