summaryrefslogtreecommitdiff
path: root/modules/experimental
diff options
context:
space:
mode:
authorRainer Jung <rjung@apache.org>2011-11-12 05:53:49 +0000
committerRainer Jung <rjung@apache.org>2011-11-12 05:53:49 +0000
commitafa92d3bb514765761845ecad23fb3bfe24ebdf0 (patch)
treeb0656628ce98a8c80dfa804dc7b2bac26e368095 /modules/experimental
parent63f6c2cde8acd136e832a9d6e96b3fda86af0514 (diff)
downloadhttpd-afa92d3bb514765761845ecad23fb3bfe24ebdf0.tar.gz
Move the examples README from experimental to
examples. Correct some basic errors in the file. No functional change. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1201198 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'modules/experimental')
-rw-r--r--modules/experimental/README54
1 files changed, 0 insertions, 54 deletions
diff --git a/modules/experimental/README b/modules/experimental/README
deleted file mode 100644
index b911e5d0cf..0000000000
--- a/modules/experimental/README
+++ /dev/null
@@ -1,54 +0,0 @@
-README for Apache 2.0 Example Module
-[April, 1997, updated May 2000]
-
-The files in the src/modules/example directory under the Apache
-distribution directory tree are provided as an example to those that
-wish to write modules that use the Apache API.
-
-The main file is mod_example.c, which illustrates all the different
-callback mechanisms and call syntaces. By no means does an add-on
-module need to include routines for all of the callbacks - quite the
-contrary!
-
-The example module is an actual working module. If you link it into
-your server, enable the "example-handler" handler for a location, and then
-browse to that location, you will see a display of some of the tracing
-the example module did as the various callbacks were made.
-
-To include the example module in your server add --enable-example to the
-other ./configure arguments executed from the httpd source tree. After
-that run 'make'.
-
-To add another module of your own:
-
- A. cp modules/experimental/mod_example.c modules/experimental/mod_myexample.c
- B. Modify the file
- C. Add an entry to modules/experimental/config.m4, e.g.
- APACHE_MODULE(myexample, my new module, , , no)
- The last argument specifies if the module is built by-default
- D. Build the server with --enable-myexample
-
-For windows, the process is slightly different;
-
- A. copy modules\experimental\mod_example.c modules\experimental\mod_myexample.c
- B. copy modules\experimental\mod_example.dsp modules\experimental\mod_myexample.dsp
- C. replace the occurances of 'example' with your module name.
- D. add the new .dsp to your Apache.dsw workspace, with dependencies
- on the libapr, libaprutil and libhttpd projects. With the newer
- Developer Studio 2002 through 2005, when you add the new .dsp
- file it will be converted to a .vcproj file.
-
-To activate the example module, include a block similar to the
-following in your httpd.conf file:
-
- <Location /example-info>
- SetHandler example-handler
- </Location>
-
-As an alternative, you can put the following into a .htaccess file and
-then request the file "test.example" from that location:
-
- AddHandler example-handler .example
-
-After reloading/restarting your server, you should be able to browse
-to this location and see the brief display mentioned earlier.