diff --git a/functions/misc.xml b/functions/misc.xml
index 1d469760c4..4ca4fb8333 100644
--- a/functions/misc.xml
+++ b/functions/misc.xml
@@ -1121,6 +1121,148 @@ if (!odbc_execute ($stmt, &$sqldata) || !odbc_fetch_into ($stmt, &$tmp)) {
+
+
+ highlight_string
+ Syntax highlighting of a string
+
+
+ Description
+
+
+ void highlight_string
+ string str
+
+
+
+ The highlight_string function prints out a syntax
+ higlighted version of str using the colors defined
+ in the built-in syntax highlighter for PHP.
+
+
+ See also higlight_file,
+ show_source.
+
+
+
+
+
+
+ highlight_file
+ Syntax highlighting of a file
+
+
+ Description
+
+
+ void highlight_file
+ string filename
+
+
+
+ The highlight_file function prints out a syntax
+ higlighted version of the code contained in filename
+ using the colors defined in the built-in syntax highlighter for PHP.
+
+
+
+ Creating a source highlighting URL
+
+ To setup a URL that can code hightlight any script that you pass to
+ it, we will make use of the "ForceType" directive in
+ Apache to generate a nice URL pattern, and use the
+ function highlight_file to show a nice looking
+ code list.
+
+
+ In your httpd.conf you can add the following:
+
+
+
+<Location /source>
+ ForceType application/x-httpd-php
+</Location>
+
+
+
+ And then make a file named "source" and put it in your
+ web root directory.
+
+
+
+<HTML>
+<HEAD>
+<TITLE>Source Display</TITLE>
+</HEAD>
+<BODY BGCOLOR="white">
+<?php
+ $script = getenv ("PATH_TRANSLATED");
+ if(!$script) {
+ echo "<BR><B>ERROR: Script Name needed</B><BR>";
+ } else {
+ if (ereg("(\.php|\.inc)$",$script)) {
+ echo "<H1>Source of: $PATH_INFO</H1>\n<HR>\n";
+ highlight_file($script);
+ } else {
+ echo "<H1>ERROR: Only PHP or include script names are allowed</H1>";
+ }
+ }
+ echo "<HR>Processed: ".date("Y/M/d H:i:s",time());
+?>
+</BODY>
+</HTML>
+
+
+
+ Then you can use an URL like the one below to display a colorized
+ version of a script located in "/path/to/script.php"
+ in your web site.
+
+
+ http://your.server.com/source/path/to/script.php
+
+
+
+
+
+
+ See also highlight_string,
+ show_source.
+
+
+
+
+
+
+ show_source
+ Syntax highlighting of a file
+
+
+ Description
+
+
+ void show_source
+ string filename
+
+
+
+ The show_source function prints out a syntax
+ higlighted version of the code contained in filename
+ using the colors defined in the built-in syntax highlighter for PHP.
+
+
+
+ This function is an alias for the function
+ highlight_file
+
+
+
+ See also highlight_string,
+ highlight_file.
+
+
+
+