more about comments than you ever wanted to know

[Eddie Kohler]

Faction(configuration string)

-- the configuration string must have balanced parentheses
-- ...except that you can escape parentheses with `\'
-- ...you can also escape `\' with `\'

-- once you have got a configuration string, inside that string, `#...EOL'
   is a comment and is removed
-- ...except that you can escape `#' with `\'
-- ...you can also escape `\' with `\'
-- ...there's some stuff with balanced parens and commas too

SO:
	Faction(configuration #comment1) #comment2
is equivalent to
	Faction(configuration)
AND:
	Faction(config(uration) #(comment))
is equivalent to
	Faction(config\(uration\))
BUT:
	Faction(config(uration) #(comment)
is an error (no closing paren).

NOTE TO FACTION WRITERS: The rules for comments inside the configuration
string only take effect if you call one of the cp_* functions in
confparse.hh, like cp_va_parse or cp_argvec.

love,
ed