add XSLTProcessor::registerPHPFunctionNS and DOMXPath::registerPhpFunctionNS

[frederikbosch]

Hopefully this PR is correct.

I was not able to build the docs locally.

frederik@frederik-laptop:/srv/libraries/php-doc-en$ make
docker run --rm -v .:/var/www/en -w /var/www -u 1000:1000 php/doc-en
configure.php: $Id$
PHP version: 8.2.26

Checking for source directory... 
error: Source directory doesn't exist or can't be written to.
make: *** [Makefile:22: xhtml] Error 1

[Girgias]

The doc directory must be en and NOT doc-en, the build script is very picky about the name for the folder.

[Girgias]

XML markup changes, to mimic in the other new file.

[Girgias]

Remove the wrapping para tag it is unnecessary.

[Girgias]

New manual code style requires <simpara> instead of <para> when possible.

[Girgias]

Semantic line breaks

Suggested change

	The PHP function to call when the Xpath function gets called within the Xpath expression. When a node list is passed
	as parameter to the callback, they are arrays containing the matched dom nodes.
	The PHP function to call when the Xpath function gets called within the Xpath expression.
	When a node list is passed as parameter to the callback,
	they are arrays containing the matched dom nodes.

[Girgias]

No need for the wrapping para tag.

[Girgias]

Still hasn't been addressed.

[Girgias]

Ditto no wrapping para tag.

[nielsdos]

Thanks for tackling this, apart from Girgias's markup comments I also have 2 content-wise comments, but looks mostly good!

[nielsdos]

The title of this example is wrong

[nielsdos]

This comment is wrong

[frederikbosch]

Hopefully I have resolved both your remarks.

[Girgias]

Missing word? Also line break as we usually try to keep lines under 80 char.

Suggested change

	This method enables the ability to use a PHP function as a namespaced XPath function inside Xpath expressions.
	This method enables the ability to use a PHP function as a namespaced XPath function
	inside a Xpath expressions.

[nielsdos]

Actually should be "an XPath" instead of "a Xpath" (mind the a vs an, and capitalization)
"an" because it's the pronounciation that counts.

[Girgias]

Still hasn't been addressed.

[Girgias]

Suggested change

	<para>
	The URI of the namespace.
	</para>
	<simpara>
	The URI of the namespace.
	</simpara>

[Girgias]

Suggested change

	<para>
	The local function name inside the namespace.
	</para>
	<simpara>
	The local function name inside the namespace.
	</simpara>

[Girgias]

Suggested change

	<para>
	The PHP function to call when the Xpath function gets called within the Xpath expression.
	When a node list is passed as parameter to the callback,
	they are arrays containing the matched dom nodes.
	</para>
	<simpara>
	The PHP function to call when the Xpath function gets called within the Xpath expression.
	When a node list is passed as parameter to the callback,
	they are arrays containing the matched dom nodes.
	</simpara>

[Girgias]

Nit:

Suggested change

	</refsect1>
	<refsect1 role="parameters">
	</refsect1>
	<refsect1 role="parameters">

[Girgias]

Suggested change

	<para>
	The local function name inside the namespace.
	</para>
	<simpara>
	The local function name inside the namespace.
	</simpara>

[Girgias]

Suggested change

	<para>
	The PHP function to call when the XSL function gets called within the stylesheet.
	When a node list is passed as parameter to the callback,
	the argument becomes an array containing the matched dom nodes.
	</para>
	<simpara>
	The PHP function to call when the XSL function gets called within the stylesheet.
	When a node list is passed as parameter to the callback,
	the argument becomes an array containing the matched dom nodes.
	</simpara>

[Girgias]

Suggested change

	<para>
	&return.void;
	</para>
	<simpara>
	&return.void;
	</simpara>

[Girgias]

Ditto, the wrapping <para> tag around the <example> tag is useless, please remove.