[PHPDOC] Documentation about Includes needs more explanation From: Richard Sims (rbs <email protected>)
Date: 06/26/00

I'm currently trying to install and use TWIG in conjunction with PHP,
and am experiencing a roadblock with PHP itself, which the documentation
does not help.
Documentation of the Include() function fails to say anything about its
interaction with the include_file definition in the php.ini file, or
whether there is some way to specify the include_path within the
application PHP code.
Documentation of the Include() function fails to describe what should be
coded inside the parentheses: Should it be absolute path names? Should
it be path completions relative to the include_file definition in the
php.ini file? Should it be path completions relative to the web server
DocumentRoot directive?

For your info, what I'm experiencing is:
If you run a php file containing simply "<?phpinfo()?>", it works fine,
and shows include_file being what I coded in the php.ini file.
If I run the test file provided with TWIG, it yields "Failed opening"
messages on all the include() operations in the file, additionally
saying "include_path=''", which is bewildering in that the phpinfo()
execution showed an include_path value.
This is maddening, made worse by the incomplete php documentation.
Anything you can do to improve the documentation in this area would be
appreciated.

    thanks, Richard Sims, Sr. Systems Programmer, Boston University
Office of Information Technology