Re: [PHPDOC] Documentation about Includes needs more explanation From: Adam Trachtenberg (adam <email protected>)
Date: 06/26/00

On Mon, 26 Jun 2000, Richard Sims wrote:

> 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?

It should be relative to the directories set in the include_path
configuration directive. This feature essentially works like setting one's
Unix shell PATH.

http://www.php.net/manual/configuration.php

I don't know if absolute pathnames work, but I'm going to guess they don't
because of security reasons.

> 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.

I have no experience with TWIG, so I don't know why it is ignoring what
you've done. You will have better luck on the php-general list. This list
is for people writing the documentation.

> This is maddening, made worse by the incomplete php documentation.
> Anything you can do to improve the documentation in this area would be
> appreciated.

You are correct. If you'd like to provide an updated version of the
documentation with a paragraph or two explaining the parts you found
confusing, I'm sure someone will add it to the manual. I will also give it
a shot if I can get some free time.

-adam 

-- 
/ adam maccabee trachtenberg | visit college life online \
\ adam <email protected>           | http://www.student.com    /