[PHP-DOC] #18403 [Opn]: changable directive information (ini_set)
ID: 18403 Updated by: [EMAIL PROTECTED] Reported By: huet dot olivier at free dot fr Status: Open Bug Type:Documentation problem PHP Version: Irrelevant New Comment: Links from ini_set already present, ini_set table updated from sources by a script once a time. Left to do: Automatically update reference/*/ini.xml by the same script which updates ini_set; find a way how to automatically document changes of versions in permissions (changeable column). Previous Comments: [2003-02-04 20:18:53] [EMAIL PROTECTED] Some thoughts: a) A third column called 'type' that dictates what type the directive takes on (string,int,float..) b) A regex tweak is needed to allow settings such as url_rewriter.tags to work (note the commas) c) Currently $map is used to decide which test_ini.xml a setting goes into. Should we use it with $excludeitems too? d) Also generate a master list Regarding a big change, currently the description of many directives exist in the manual but are separate from this generated table. This is a little confusing as this information might go better together. This could include reciprocal links OR a fourth column for the description. [2003-02-04 18:21:34] [EMAIL PROTECTED] keep this open then.. [2003-02-04 17:10:44] [EMAIL PROTECTED] The script is there. Had made some limited tests in my local copy of the phpdoc, and seems to be working. I would like someone involved in the manual build to test it and give some feedback. IIRC something along the lines of the script's output was in the PHPDOC todo list. [2003-02-04 16:45:51] [EMAIL PROTECTED] what's the status with this? [2003-01-19 21:01:30] [EMAIL PROTECTED] I have just commited the script: phpdoc/scripts/genPHP_INI_ENTRY.php which should replace my aging phpdoc/scripts/mk_ini_set_table.sh Test that script. By default it will generate files named 'test_ini.xml' in the appropriate dirs. If all looks OK, we can go ahead and remove the ini_set table, make the new script generate all the ini.xml files and change the manual files where appropriate (makefile, etc.) Also, look at the approach there. It might be useful for making replacements for the funcsummary and funclist scripts. 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=18403edit=1
[PHP-DOC] #18403 [Opn]: changable directive information (ini_set)
ID: 18403 Updated by: [EMAIL PROTECTED] Reported By: [EMAIL PROTECTED] Status: Open Bug Type:Documentation problem -PHP Version: 4.5.0 +PHP Version: php/fi New Comment: Some thoughts: a) A third column called 'type' that dictates what type the directive takes on (string,int,float..) b) A regex tweak is needed to allow settings such as url_rewriter.tags to work (note the commas) c) Currently $map is used to decide which test_ini.xml a setting goes into. Should we use it with $excludeitems too? d) Also generate a master list Regarding a big change, currently the description of many directives exist in the manual but are separate from this generated table. This is a little confusing as this information might go better together. This could include reciprocal links OR a fourth column for the description. Previous Comments: [2003-02-04 18:21:34] [EMAIL PROTECTED] keep this open then.. [2003-02-04 17:10:44] [EMAIL PROTECTED] The script is there. Had made some limited tests in my local copy of the phpdoc, and seems to be working. I would like someone involved in the manual build to test it and give some feedback. IIRC something along the lines of the script's output was in the PHPDOC todo list. [2003-02-04 16:45:51] [EMAIL PROTECTED] what's the status with this? [2003-01-19 21:01:30] [EMAIL PROTECTED] I have just commited the script: phpdoc/scripts/genPHP_INI_ENTRY.php which should replace my aging phpdoc/scripts/mk_ini_set_table.sh Test that script. By default it will generate files named 'test_ini.xml' in the appropriate dirs. If all looks OK, we can go ahead and remove the ini_set table, make the new script generate all the ini.xml files and change the manual files where appropriate (makefile, etc.) Also, look at the approach there. It might be useful for making replacements for the funcsummary and funclist scripts. [2003-01-18 05:00:51] [EMAIL PROTECTED] 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. 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=18403edit=1 -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] #18403 [Opn]: changable directive information (ini_set)
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=18403edit=1
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] #18403 [Opn]: changable directive information (ini_set)
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=18403edit=1
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
