ID: 18403
Updated by: [EMAIL PROTECTED]
-Summary: ini_set documentation outdated in other languages
Reported By: [EMAIL PROTECTED]
Status: Open
Bug Type: Documentation problem
-PHP Version: 4.2.1
+PHP Version: 4.5.0
New Comment:
This important topic needs more analysis.
The generated table found at php.net/ini_set (which is created by
phpdoc/scripts/mk_ini_set_table.sh) should not be listed at
php.net/ini_set but rather it should be listed somewhere near
config.xml as this table is certainly not ini_set specific.
Also, this table needs a third description column which somehow should
not be affected by mk_ini_set_table.sh. This would be, for example, a
place to explain why register_globals is PHP_INI_ALL.
And lastly, this information should be related to {extension}/ini.xml
somehow as currently the information is kept track of in two places.
This deserves some thought too.
Regarding the original purpose of this bug report, when
mk_ini_set_table.sh is run it should be run on all translations, not
just /en/. This would mean translations of this wouldn't get
out-of-date.
Previous Comments:
------------------------------------------------------------------------
[2002-07-23 14:58:43] [EMAIL PROTECTED]
Because it is sometimes really nice to have comments on settings (not
much like the indexes), they may be better to be kept as normal XML
files updated by hand.
A new idea is that maybe we can autogenerate it from the source, and
keep it language independent, and make all names links to their
corresponding parts (now in configure.xml and in the future in several
ini.xml files in ext docs)
------------------------------------------------------------------------
[2002-07-23 14:05:17] [EMAIL PROTECTED]
The list of ini_set() configuration options is manually autogenerated.
Sometimes changes are made, though, to reflect real world (imho)
behavior. And, sometimes php4 is modified through discussion of this
list.
Here are some options:
(a) Have this list autogenerated with every manual build.
(b) Have a centralized copy of this table, have all languages use it.
Doing (a) assumes no changes will be made (as they won't be kept),
currently we do make changes so this may not be viable. (b) is good as
this table is only in english anyways although it'd make it more
difficult to add a third "description" column for these settings. A
description column would be good to describe why the PHP4 source is the
way it is, and why one might not have expected behavior.
Feel free to discuss. A related documentation feature request is bug
#18372
------------------------------------------------------------------------
[2002-07-18 06:26:23] [EMAIL PROTECTED]
Anyway there is a mistake in the french version of the doc which views
it as a PHP_INI_ALL configuration option.
------------------------------------------------------------------------
[2002-07-18 04:45:26] [EMAIL PROTECTED]
The documentation is correct. It's not possible to change
it anymore (4.3.0-dev) and changing it now does not affect it in
anyway.
------------------------------------------------------------------------
[2002-07-18 03:50:40] [EMAIL PROTECTED]
There seems to have an error in the english documentation of ini_set
function. The upload_max_filesize is describe as PHP_INI_SYSTEM
configuration option, but it appears to be sizeable via ini_set
function.
Please care about it !
------------------------------------------------------------------------
--
Edit this bug report at http://bugs.php.net/?id=18403&edit=1
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
