From: Nick Kew Date: Tue, 29 Jun 2010 23:04:27 +0000 (+0000) Subject: Move new_api_2_4 doc to developer docs where it belongs X-Git-Tag: 2.3.7~113 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=042384c3b48673d5f73888352aa7276cc31c11de;p=apache Move new_api_2_4 doc to developer docs where it belongs git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@959136 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/developer/index.xml b/docs/manual/developer/index.xml index df8cf6b6d0..5b04eefa24 100644 --- a/docs/manual/developer/index.xml +++ b/docs/manual/developer/index.xml @@ -28,7 +28,7 @@

Many of the documents on these Developer pages are lifted from Apache 1.3's documentation. While they are all being - updated to Apache 2.0, they are in different stages of + updated to Apache 2, they are in different stages of progress. Please be patient, and point out any discrepancies or errors on the developer/ pages directly to the Topics

diff --git a/docs/manual/new_api_2_4.xml b/docs/manual/developer/new_api_2_4.xml similarity index 100% rename from docs/manual/new_api_2_4.xml rename to docs/manual/developer/new_api_2_4.xml diff --git a/docs/manual/new_api_2_4.xml.meta b/docs/manual/developer/new_api_2_4.xml.meta similarity index 100% rename from docs/manual/new_api_2_4.xml.meta rename to docs/manual/developer/new_api_2_4.xml.meta diff --git a/docs/manual/index.xml b/docs/manual/index.xml index c6cbe77ba0..cf89a54992 100644 --- a/docs/manual/index.xml +++ b/docs/manual/index.xml @@ -27,7 +27,6 @@ Documentation Release Notes - API changes with Apache 2.3/2.4 New features with Apache 2.3/2.4 New features with Apache 2.1/2.2 New features with Apache 2.0 diff --git a/docs/manual/new_api_2_4.html b/docs/manual/new_api_2_4.html deleted file mode 100644 index f13974a3bc..0000000000 --- a/docs/manual/new_api_2_4.html +++ /dev/null @@ -1,5 +0,0 @@ -# GENERATED FROM XML -- DO NOT EDIT - -URI: new_api_2_4.html.en -Content-Language: en -Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/new_api_2_4.html.en b/docs/manual/new_api_2_4.html.en deleted file mode 100644 index b49f08ad2c..0000000000 --- a/docs/manual/new_api_2_4.html.en +++ /dev/null @@ -1,223 +0,0 @@ - - - -API Changes in Apache HTTP Server 2.4 since 2.2 - Apache HTTP Server - - - - -
-

Modules | Directives | FAQ | Glossary | Sitemap

-

Apache HTTP Server Version 2.3

-
-
<-
-

API Changes in Apache HTTP Server 2.4 since 2.2

-
-

Available Languages:  en 

-
- -

This document describes changes to the Apache HTTPD API from - version 2.2 to 2.4, that may be of interest to module/application - developers and core hacks. At the time of writing, the 2.4 API - is not finalised, and this document may serve to highlight - points that call for further review.

-

API changes fall into two categories: APIs that are altogether new, - and existing APIs that are expanded or changed. The latter are - further divided into those where all changes are back-compatible - (so existing modules can ignore them), and those that might - require attention by maintainers. As with the transition from - HTTPD 2.0 to 2.2, existing modules and applications will require - recompiling and may call for some attention, but most should not - require any substantial updating (although some may be able to - take advantage of API changes to offer significant improvements).

-

For the purpose of this document, the API is split according - to the public header files. These headers are themselves the - reference documentation, and can be used to generate a browsable - HTML reference with make docs.

-
- -
top
-
-

ap_expr (NEW!)

- -

Introduces a new API to parse and evaluate boolean and algebraic - expressions, including provision for a standard syntax and - customised variants.

-
top
-
-

ap_listen (changed; back-compatible)

- -

Introduces new API to enable apache child processes to serve different purposes.

-
top
-
-

ap_mpm (changed)

- -

ap_mpm_run is replaced by a new mpm hook. - Also ap_graceful_stop_signalled is lost, and - ap_mpm_register_timed_callback is new.

-
top
-
-

ap_slotmem (NEW!)

- -

Introduces an API for modules to allocate and manage memory slots - (normally) for shared memory.

-
top
-
-

ap_socache (NEW!)

- -

API to manage a shared object cache.

-
top
-
-

heartbeat (NEW!)

- -

common structures for heartbeat modules (should this be public API?)

-
top
-
-

http_config (changed)

- -
    -
  • Introduces per-module, per-directory loglevels, including macro wrappers.
    • -
  • New AP_DECLARE_MODULE macro to declare all modules.
    • -
  • New APLOG_USE_MODULE macro necessary for per-module loglevels in - multi-file modules.
    • -
  • New API to retain data across module unload/load
    • -
  • New check_config hook
    • -
  • New ap_process_fnmatch_configs() to process wildcards
    • -
-
top
-
-

http_core (changed)

- -
    -
  • REMOVED ap_default_type, ap_requires, all 2.2 authnz API
    • -
  • Introduces Optional Functions for logio and authnz
    • -
  • New function ap_get_server_name_for_url to support ipv6 literals.
    • -
-
top
-
-

httpd (changed)

- -
    -
  • Introduce per-directory, per-module loglevel
    • -
  • New loglevels APLOG_TRACEn
    • -
  • Support for mod_request kept_body
    • -
  • Support buffering filter data for async requests
    • -
  • New CONN_STATE values
    • -
  • Function changes: ap_escape_html updated; ap_unescape_all, ap_escape_path_segment_buffer
    • -
-
top
-
-

http_log (changed)

- -
    -
  • Introduce per-directory, per-module loglevel
    • -
  • New loglevels APLOG_TRACEn
    • -
  • ap_log_*error become macro wrappers (fully back-compatible if - APLOG_MARK macro is used)
    • -
  • piped logging revamped
    • -
  • module_index added to error_log hook
    • -
  • new function: ap_log_command_line
    • -
-
top
-
-

http_request (changed)

- -
    -
  • New auth_internal API and auth_provider API
    • -
  • New EOR bucket type
    • -
  • New function ap_process_async_request
    • -
  • New functions ap_hook_check_access, ap_hook_check_authn, ap_hook_check_authz (why are these called ap_hook_* when they are functions not hooks?)
    • -
-
top
-
-

mod_auth (NEW!)

- -

Introduces the new provider framework for authn and authz

-
top
-
-

mod_core (NEW!)

- -

This introduces low-level APIs to send arbitrary headers, - and exposes functions to handle HTTP OPTIONS and TRACE.

-
top
-
-

mod_request (NEW!)

- -

The API for mod_request, to make input data - available to multiple application/handler modules where required, - and to parse HTML form data.

-
top
-
-

mpm_common (changed)

- -
    -
  • REMOVES: accept, lockfile, lock_mech, set_scoreboard (locking uses the new ap_mutex API)
    • -
  • NEW API to drop privileges (delegates this platform-dependent - function to modules)
    • -
  • NEW Hooks: mpm_query, mpm_note_child_killed, timed_callback, get_name, and function ap_mpm_note_child_killed
    • -
-
top
-
-

scoreboard (changed)

- -

ap_get_scoreboard_worker is gratuitously made non-back-compatible - as an alternative version is introduced. Additional proxy_balancer - support. Child status stuff revamped.

-
top
-
-

util_cookies (NEW!)

- -

Introduces a new API for managing HTTP Cookies.

-
top
-
-

util_ldap (changed)

- -

I have yet to get a handle on this update.

-
top
-
-

util_mutex (NEW!)

- -

A wrapper for APR proc and global mutexes in httpd.

-
top
-
-

util_script (changed)

- -

NEW: ap_args_to_table

-
top
-
-

util_time (changed)

- -

NEW: ap_recent_ctime_ex

-
-
-

Available Languages:  en 

-
- \ No newline at end of file diff --git a/docs/manual/sitemap.xml b/docs/manual/sitemap.xml index 1866775e6d..316c8518e2 100644 --- a/docs/manual/sitemap.xml +++ b/docs/manual/sitemap.xml @@ -34,7 +34,6 @@ Documentation.

Release Notes Upgrading to 2.4 from 2.2 New features with Apache 2.3/2.4 -API updates in Apache HTTPD 2.4 New features with Apache 2.1/2.2 New features with Apache 2.0 Apache License @@ -157,6 +156,7 @@ Server on HPUX Developer Documentation Overview Apache API notes +API updates in Apache HTTPD 2.4 Debugging Memory Allocation in APR Documenting Apache 2.x Apache 2.x Hook Functions diff --git a/docs/manual/upgrading.xml b/docs/manual/upgrading.xml index 4a9b64e7bf..eb73c304b7 100644 --- a/docs/manual/upgrading.xml +++ b/docs/manual/upgrading.xml @@ -31,7 +31,7 @@ more information in either the New Features document, or in the src/CHANGES file. Application and module developers - can find a summary of API changes in the API updates overview.

This document describes changes in server behavior that might @@ -238,7 +238,7 @@

Many third-party modules designed for version 2.2 will otherwise work unchanged with the Apache HTTP Server version 2.4. - Some will require changes; see the API + Some will require changes; see the API update overview.