Add expand.pl Perl script to expand out SSI references in the manual,

so the end user doesn't need to have them turned on for .html files.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@77098 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/expand.pl b/docs/manual/expand.pl
new file mode 100644 (file)
index 0000000..26edf2e
--- /dev/null
+++ b/docs/manual/expand.pl
@@ -0,0 +1,100 @@
+#!/usr/local/bin/perl
+
+# This is a very simple Perl script to expand server-side includes
+# in the directory it is run, and direct subdirectories. It will
+# work only on SSI directives of the form
+#
+# <!--#include virtual="filename" -->
+#
+# Filename must be relative to the directory the file appears in.
+#
+# Nov 30, 1996 - Alexei Kosut <akosut@apache.org>
+
+# ====================================================================
+# Copyright (c) 1996 The Apache Group.  All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+#
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer. 
+#
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in
+#    the documentation and/or other materials provided with the
+#    distribution.
+#
+# 3. All advertising materials mentioning features or use of this
+#    software must display the following acknowledgment:
+#    "This product includes software developed by the Apache Group
+#    for use in the Apache HTTP server project (http://www.apache.org/)."
+#
+# 4. The names "Apache Server" and "Apache Group" must not be used to
+#    endorse or promote products derived from this software without
+#    prior written permission.
+#
+# 5. Redistributions of any form whatsoever must retain the following
+#    acknowledgment:
+#    "This product includes software developed by the Apache Group
+#    for use in the Apache HTTP server project (http://www.apache.org/)."
+#
+# THIS SOFTWARE IS PROVIDED BY THE APACHE GROUP ``AS IS'' AND ANY
+# EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE APACHE GROUP OR
+# ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+# NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+# STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+# OF THE POSSIBILITY OF SUCH DAMAGE.
+# ====================================================================
+#
+# This software consists of voluntary contributions made by many
+# individuals on behalf of the Apache Group and was originally based
+# on public domain software written at the National Center for
+# Supercomputing Applications, University of Illinois, Urbana-Champaign.
+# For more information on the Apache Group and the Apache HTTP server
+# project, please see <http://www.apache.org/>.
+
+# Put a list of dirs (except ..) into @dirs
+
+opendir DIR, "." or die "Could not open directory: $!";
+@dirs = grep !/^\.\.$/, (grep -d, readdir DIR);
+closedir DIR;
+
+foreach $dir (@dirs) {
+    print "Entering directory $dir\n";
+    opendir SUBDIR, "$dir" or die "Could not open subdir $dir: $!";
+    foreach $file (grep /\.html$/, readdir SUBDIR) {
+       print "Expanding file $dir/$file\n";
+       rename "$dir/$file", "$dir/${file}.old";
+       open READ, "$dir/${file}.old" or die "Couldn't read $dir/$file: $!";
+       open WRITE, ">$dir/$file" or die "Couldn't write $dir/$file: $!";
+       while ($r = <READ>) {
+           if ($r =~ /<!--#include virtual="(.*)" -->/) {
+               ($pre, $include, $post) = ($`, $1, $');
+               print WRITE $pre;
+
+               open INC, "$dir/$include" or
+                   print "Could not include file $dir/$include: $!";
+               print WRITE while (<INC>);
+               close INC;
+
+               print WRITE $post;
+           }
+           else {
+               print WRITE $r;
+           }
+       }
+       close READ;
+       close WRITE;
+       unlink "$dir/$file.old";
+    }
+    closedir SUBDIR;
+}
+
+