ID: 18403
Updated by: [EMAIL PROTECTED]
Reported By: [EMAIL PROTECTED]
Status: Feedback
Bug Type: Documentation problem
PHP Version: 4.5.0
New Comment:
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.
Previous Comments:
------------------------------------------------------------------------
[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.
------------------------------------------------------------------------
[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)
------------------------------------------------------------------------
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
