[PHP-DOC] Re: INSTALL PARTS (was: ugly cvs subject) From: Gabor Hojtsy (goba <email protected>)
Date: 01/14/02

> /phpdoc/ja/chapters install.apache.xml install.caudium.xml
> install.commandline.xml
> install.configure.databases.xml
> install.configure.graphics.xml
> install.configure.misc.xml
> install.configure.php.xml
> install.configure.servers.xml
> install.configure.xml install.configure.xml.xml
> install.fhttpd.xml install.hpux.xml
> install.iis.xml install.linux.xml
> install.macosx.xml
> install.netscape-enterprise.xml
> install.omnihttpd.xml install.openbsd.xml
> install.oreilly.xml install.otherhttpd.xml
> install.problems.xml install.solaris.xml
> install.unix.xml install.windows.xml
> install.xitami.xml

Please revert this patch. This is not the final place for these files,
nor the final names or contents of them. This is why it was a bad idea
to put them there temporarly IMHO...

Now, we need to discuss where they should go. I would be fine
with phpdoc/install for install.anything.xml files, and
phpdoc/install/configure or phpdoc/configure for
install.configure.anything.xml files.

So, as for a full list of paths and names:

phpdoc/install/apache.xml
phpdoc/install/caudium.xml
phpdoc/install/commandline.xml
phpdoc/install/fhttpd.xml
phpdoc/install/hpux.xml
phpdoc/install/iis.xml
phpdoc/install/linux.xml
phpdoc/install/macosx.xml
phpdoc/install/netscape-enterprise.xml
phpdoc/install/omnihttpd.xml
phpdoc/install/openbsd.xml
phpdoc/install/oreilly.xml
phpdoc/install/otherhttpd.xml
phpdoc/install/problems.xml
phpdoc/install/solaris.xml
phpdoc/install/unix.xml
phpdoc/install/windows.xml
phpdoc/install/xitami.xml

phpdoc/configure/databases.xml
phpdoc/configure/graphics.xml
phpdoc/configure/misc.xml
phpdoc/configure/php.xml
phpdoc/configure/servers.xml
phpdoc/configure/configure.xml
phpdoc/configure/xml.xml

Note, that configure/mis.xml may be broken
into several further parts. These files
are not used for doc generation currently!

Another thing: where is general installation
steps in the breaked up install parts? Its nowhere!!
Are there other parts left out? Can anybody please check?

Just another thing to talk about: Now look at
http://www.php.net/manual/en/install.configure.php and
http://www.php.net/manual/en/configuration.php

I am sure that it is confusing for people, to have two
completely different sections, with names consequently
starting with "config" [configuration and configure options].
We should invent another name for php.ini directives,
eg. "settings" or some other word, that is easily
distinquisable from "configure". I was also confused for
some days when I first saw these two chapters.

Yes, you can say, that we have a note on the configure
options page, that these are compile time options.
But there are many places, where we refer to "configure
options", and "configuration directives" (yes, we use
these two words for the two things). This is one major
thing need to be discussed!

Goba