ID: 18403
Updated by: [EMAIL PROTECTED]
Reported By: [EMAIL PROTECTED]
Status: Open
Bug Type: Documentation problem
PHP Version: 4.5.0
New Comment:
First, there should not be two places to change, so all ini information
should be in reference/.../ini.xml files. For those ini settings that
are global (not extension related), they should be at some common place
(not ini_set). Much like the configure options.
Second if you would like to make it automatically update all
translations, the simlest thing is to put it out into its own file, and
link it using an entity. The entity will be automatically created for
the .xml file, so you only need to replace / with . in the path... Then
if translators won't translate the file, it will automatically be up to
date in all languages.
Previous Comments:
------------------------------------------------------------------------
[2003-01-16 20:21:01] [EMAIL PROTECTED]
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.
------------------------------------------------------------------------
[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.
------------------------------------------------------------------------
The remainder of the comments for this report are too long. To view
the rest of the comments, please view the bug report online at
http://bugs.php.net/18403
--
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
