Description:
------------
The legal syntax for PHP ini files (both php.ini and those parsed by parse_ini_file()) is not really fully described anywhere in the manual. It'd be helpful to have that documented say on http://www.php.net/manual/en/configuration.file.php, and then have the parse_ini_file() and parse_ini_string() documentation pages link to that syntax documentation.

There are bits and pieces of documentation, like in the comments of the php.ini in Example 1 on the above page, and in the comments of the latest php.ini in CVS.  Also, in the page for parse_ini_file(), it documents the set of illegal words and characters for keys.  It also says certain characters have "special meaning" in values, but doesn't say what those meanings are / what they can be used for in values.

The lack of precise syntax documentation makes it hard to predict how parse_ini_file() will actually treat a given ini file line (as an error, as ok but with some odd value interpretation, or just silently ignore).  The following examples illustrate; these are using 5.3.0-beta2 snapshot on Windows.

			value of key "x" 
ini line		from parse_ini_file()
--------		---------------------
x = 'foo' ;blah		foo
	;; Single quotes are ok too?

# x = blah		N/A
	;; No keys parsed out for this line, and no syntax
	;; error reported -- is "#" a comment char.?

x = "foo" # test	foo# test
	;; Hmm, legal to have text after double quoted value
	;; and gets oddly appended to value.
	;; And no, guess "#" ISN'T a comment char.

foo bar car		N/A
	;; No keys parsed out for this line, and no syntax
	;; error reported.  What happened to it?


Reproduce code:
---------------
The above was done by varying the contents of test.ini and then running the following command at the windows prompt:

% php -r "print_r(parse_ini_file('test.ini'));"


Expected result:
----------------
For most of the examples I expected syntax errors to be reported.  But the larger issue is that without documentation of the legal syntax of ini files, PHP users don't really know what's legal and what's not.


Actual result:
--------------
See above.