httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From c...@locus.apache.org
Subject cvs commit: httpd-docs-1.3/apidoc TODO api-dict.html api.list dict-DOCUMENT_LOCATION.html dict-HARD_SERVER_LIMIT.html dict-ap_table_add.html dict-ap_table_addn.html dict-ap_table_set.html dict-ap_table_setn.html mkapidict
Date Thu, 27 Jul 2000 10:07:07 GMT
coar        00/07/27 03:07:05

  Modified:    apidoc   TODO api-dict.html api.list
                        dict-DOCUMENT_LOCATION.html
                        dict-HARD_SERVER_LIMIT.html dict-ap_table_add.html
                        dict-ap_table_addn.html dict-ap_table_set.html
                        dict-ap_table_setn.html mkapidict
  Log:
  	Label the documentation as being strictly for 1.3, and update
  	some of it to be more complete and useful.
  
  Revision  Changes    Path
  1.6       +0 -2      httpd-docs-1.3/apidoc/TODO
  
  Index: TODO
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/apidoc/TODO,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -u -r1.5 -r1.6
  --- TODO	2000/07/25 21:45:46	1.5
  +++ TODO	2000/07/27 10:06:53	1.6
  @@ -1,5 +1,4 @@
   The following need to be added to api.list:
  -DEFAULT_ADMIN
   TARGET
   HTTP_VERSION
   HTTP_VERSION_MAJOR
  @@ -10,7 +9,6 @@
   DEFAULT_TIMEOUT
   DEFAULT_KEEPALIVE_TIMEOUT
   DEFAULT_KEEPALIVE
  -HARD_SERVER_LIMIT
   APLOG_LEVELMASK
   APLOG_WIN32ERROR
   REQUEST_NO_BODY
  
  
  
  1.7       +4 -3      httpd-docs-1.3/apidoc/api-dict.html
  
  Index: api-dict.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/apidoc/api-dict.html,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -u -r1.6 -r1.7
  --- api-dict.html	2000/06/14 10:37:25	1.6
  +++ api-dict.html	2000/07/27 10:06:54	1.7
  @@ -2,7 +2,7 @@
    "http://www.w3.org/TR/REC-html40/loose.dtd">
   <html>
    <head>
  -  <title>Apache Web server API Dictionary</title>
  +  <title>Apache Web server 1.3 API Dictionary</title>
     <!-- $Generated by:$ -->
    </head>
   <!-- Background white, links blue (unvisited), navy (visited), red (active) -->
  @@ -14,12 +14,13 @@
     alink="#ff0000"
    >
   <!--#include virtual="header.html" -->
  -  <h1 align="center">Apache Web server API Dictionary</h1>
  +  <h1 align="center">Apache Web server 1.3 API Dictionary</h1>
     <blockquote>
      <b>
       The intent of this and the related pages is to provide definitive
       documentation for the Apache Web server API (application programming
  -    interface).  Unfortunately, it does not yet live up to that intention,
  +    interface) for version 1.3.  Unfortunately, it does not yet live
  +    up to that intention,
       but it's something, anyway.
       This file is <!--very much--> under construction.  <!--You should not take
       anything you find in it at face value.-->
  
  
  
  1.22      +25 -18    httpd-docs-1.3/apidoc/api.list
  
  Index: api.list
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/apidoc/api.list,v
  retrieving revision 1.21
  retrieving revision 1.22
  diff -u -u -r1.21 -r1.22
  --- api.list	2000/07/25 21:45:47	1.21
  +++ api.list	2000/07/27 10:06:54	1.22
  @@ -940,7 +940,8 @@
   #; Random constants
   #;
   X|CTCEs\
  -    |BIG_SECURITY_HOLE,DOCUMENT_LOCATION,DYNAMIC_MODULE_LIMIT,HTTPD_ROOT\
  +    |BIG_SECURITY_HOLE,DEFAULT_ADMIN,DOCUMENT_LOCATION,DYNAMIC_MODULE_LIMIT\
  +     ,HARD_SERVER_LIMIT,HTTPD_ROOT\
       |\
       |\
       |
  @@ -949,16 +950,27 @@
       |env CFLAGS="-Wall -D$*" ./configure\
       |CTCEs\
       |dict-$*.html
  -C|DOCUMENT_LOCATION\
  +C|DEFAULT_ADMIN\
       |Compile-time definition\
       |env CFLAGS="-Wall -D$*=\"/usr/httpd/htdocs\"" ./configure\
       |CTCEs\
       |dict-$*.html
  +C|DOCUMENT_LOCATION\
  +    |Compile-time definition\
  +    |env CFLAGS="-Wall -D$*=\"/usr/httpd/htdocs\"" ./configure\
  +    |CTCEs,ap_document_root\
  +    |dict-$*.html
   C|DYNAMIC_MODULE_LIMIT\
       |Compile-time definition\
       |env CFLAGS="-Wall -D$*=64" ./configure\
       |CTCEs\
       |dict-$*.html
  +C|HARD_SERVER_LIMIT\
  +    |Compile-time definition\
  +    |env CFLAGS="-Wall -D$*=1024" ./configure \n \n \
  +for (i = 0; i &lt; $*; ++i) {\n    ...per-child processing...\n}\
  +    |CTCEs\
  +    |dict-$*.html
   C|HTTPD_ROOT\
       |Compile-time definition\
       |env CFLAGS="-Wall -D$*=\"/usr/httpd\"" ./configure\
  @@ -1003,12 +1015,12 @@
       |SA-tables\
       |dict-$*.html
   R|ap_table_add\
  -    |void $*(table *t, const char *key, const char *val);\
  +    |void $*(table *t, const char *k, const char *val);\
       |\
       |SA-tables\
       |dict-$*.html
   R|ap_table_addn\
  -    |void $*(table *t, const char *key, const char *val);\
  +    |void $*(table *t, const char *k, const char *val);\
       |\
       |SA-tables\
       |dict-$*.html
  @@ -1016,7 +1028,7 @@
   #; Here's an example of multiline definition with proper indenting.
   #;
   R|ap_table_do\
  -    |void $*(int (*comp) (void *d, const char *key, const char *val), \n \
  +    |void $*(int (*comp) (void *d, const char *k, const char *val), \n \
                    void *rec, const table *t, ...);\
       |\
       |SA-tables\
  @@ -1027,27 +1039,27 @@
       |SA-tables\
       |dict-$*.html
   R|ap_table_merge\
  -    |void $*(table *tab, const char *name, const char *more_val);\
  +    |void $*(table *t, const char *k, const char *more_val);\
       |\
       |SA-tables\
       |dict-$*.html
   R|ap_table_mergen\
  -    |void $*(table *tab, const char *name, const char *more_val);\
  +    |void $*(table *t, const char *k, const char *more_val);\
       |\
       |SA-tables\
       |dict-$*.html
   R|ap_table_set\
  -    |void $*(table *tab, const char *name, const char *val);\
  +    |void $*(table *t, const char *k, const char *val);\
       |\
       |SA-tables\
       |dict-$*.html
   R|ap_table_setn\
  -    |void $*(table *tab, const char *name, const char *val);\
  +    |void $*(table *t, const char *k, const char *val);\
       |\
       |SA-tables\
       |dict-$*.html
   R|ap_table_unset\
  -    |void $*(table *tab, const char *key);\
  +    |void $*(table *t, const char *k);\
       |\
       |SA-tables\
       |dict-$*.html
  @@ -1889,9 +1901,9 @@
       |\
       |dict-$*.html
   R|ap_document_root\
  -    |char *$*(request_rec *r);\
  -    |\
  -    |\
  +    |const char *$*(request_rec *r);\
  +    |request_rec *r;\nconst char *docroot;\ndocroot = ap_document_root(r)\n \
  +    |DOCUMENT_LOCATION\
       |dict-$*.html
   R|ap_each_byterange\
       |int $*(request_rec *r, long *offset, long *length);\
  @@ -2945,11 +2957,6 @@
   C|SERVER_VERSION\
       |#define $* <var>string</var>\
       |Deprecated; use ap_get_server_version() instead.\
  -    |\
  -    |dict-$*.html
  -C|HARD_SERVER_LIMIT\
  -    |#define $* <var>value</var>\
  -    |for (i = 0; i &lt; $*; ++i) {\n    ...per-child processing...\n}\
       |\
       |dict-$*.html
   C|kill_conditions\
  
  
  
  1.2       +5 -0      httpd-docs-1.3/apidoc/dict-DOCUMENT_LOCATION.html
  
  Index: dict-DOCUMENT_LOCATION.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/apidoc/dict-DOCUMENT_LOCATION.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -u -r1.1 -r1.2
  --- dict-DOCUMENT_LOCATION.html	2000/07/23 15:32:50	1.1
  +++ dict-DOCUMENT_LOCATION.html	2000/07/27 10:06:54	1.2
  @@ -13,3 +13,8 @@
   The default value is based on the definition of the <code>HTTPD_ROOT</code>
   compile-time definition (<i>q.v.</i>).
   </p>
  +<p>
  +You should use the <code>ap_document_root()</code> (<i>q.v.</i>)
routine
  +instead to obtain the value of the DocumentRoot for the server handling a
  +request.
  +</p>
  \ No newline at end of file
  
  
  
  1.3       +10 -1     httpd-docs-1.3/apidoc/dict-HARD_SERVER_LIMIT.html
  
  Index: dict-HARD_SERVER_LIMIT.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/apidoc/dict-HARD_SERVER_LIMIT.html,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -u -r1.2 -r1.3
  --- dict-HARD_SERVER_LIMIT.html	2000/07/24 22:13:49	1.2
  +++ dict-HARD_SERVER_LIMIT.html	2000/07/27 10:06:55	1.3
  @@ -1,3 +1,12 @@
   <p>
  -The maximum possible number of server processes.
  +This compile-time constant defines the maximum possible number of server
  +processes.  It places a ceiling on the number of concurrent requests
  +the server can handle.  It is used to size several static data structures
  +and therefore requires a recompilation in order to change the value.
  +</p>
  +<p>
  +The default value for Windows is 1024, because on that platform
  +it refers to threads rather than processes.  For all other
  +platforms the default value (which <i>does</i> refer to actual
  +child processes) is 256.
   </p>
  
  
  
  1.4       +19 -2     httpd-docs-1.3/apidoc/dict-ap_table_add.html
  
  Index: dict-ap_table_add.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/apidoc/dict-ap_table_add.html,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -u -r1.3 -r1.4
  --- dict-ap_table_add.html	2000/07/24 22:14:00	1.3
  +++ dict-ap_table_add.html	2000/07/27 10:06:55	1.4
  @@ -1,6 +1,23 @@
   <p>
  -Adds a new value <EM>val</EM> to <EM>t</EM>, associated with <EM>key</EM>.
  +Adds a new value <var>val</var> to table <var>t</var>, associated
with key
  +<var>key</var>.
  +Both the key and the value are copied into the table's pool using
  +<code>ap_pstrdup()</code> and pointers to the copies used in the table.
  +If both values are constants, such
  +as literal strings, you should use <code>ap_table_addn()</code>
  +instead.
   </p>
   <p>
  -A new table entry is always created, even if it duplicates another.
  +A new table entry is always created, even if there are already one or
  +more entries with the same key.
  +To update an existing entry, or create it if it doesn't exist, use
  +<code>ap_table_set()</code> (<i>q.v.</i>).  Be aware, though,
  +that <code>ap_table_set()</code> will delete all other entries
  +with the same key.
  +</p>
  +<p>
  +If a table has multiple entries for a particular key, only the
  +first will be returned by the direct lookup routines (<i>e.g.</i>,
  +<code>ap_table_get()</code>).  The only way to access such duplicate
  +entries is to traverse the table with <code>ap_table_do()</code>.
   </p>
  
  
  
  1.5       +14 -2     httpd-docs-1.3/apidoc/dict-ap_table_addn.html
  
  Index: dict-ap_table_addn.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/apidoc/dict-ap_table_addn.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -u -r1.4 -r1.5
  --- dict-ap_table_addn.html	2000/07/24 22:14:00	1.4
  +++ dict-ap_table_addn.html	2000/07/27 10:06:55	1.5
  @@ -1,7 +1,19 @@
   <p>
  -Adds a new value <EM>val</EM> to <EM>t</EM>, associated with <EM>key</EM>.
  +Adds a new value <i>val</i> to table <i>t</i>, associated with
<i>key</i>.
  +Pointers to the supplied strings are stored in the table, so they
  +must either be constants or at least have a greater longevity than
  +the table's pool, and they <b>must not</b> be modified after the
  +entry has been added to the table.  If these conditions cannot be
  +met, you should use <code>ap_table_add()</code> instead.
   </p>
   <p>
   A new table entry is always created, even if it duplicates another.
  -This function does not use ap_pstrdup.
  +To update an existing entry, or create it if it doesn't exist, use
  +<code>ap_table_setn()</code>.
  +</p>
  +<p>
  +If a table has multiple entries for a particular key, only the
  +first will be returned by the direct lookup routines (<i>e.g.</i>,
  +<code>ap_table_get()</code>).  The only way to access such duplicate
  +entries is to traverse the table with <code>ap_table_do()</code>.
   </p>
  
  
  
  1.4       +10 -1     httpd-docs-1.3/apidoc/dict-ap_table_set.html
  
  Index: dict-ap_table_set.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/apidoc/dict-ap_table_set.html,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -u -r1.3 -r1.4
  --- dict-ap_table_set.html	2000/07/24 22:14:00	1.3
  +++ dict-ap_table_set.html	2000/07/27 10:06:56	1.4
  @@ -1,3 +1,12 @@
   <p>
  -Replaces or creates <EM>t</EM> with new <EM>val</EM> in table <EM>t</EM>.
  +Sets the entry in table <var>t</var> with key <var>k</var> to have
value
  +<var>val</var>.  If no such entry exists, one is created.  If an
  +entry does exist, its value is replaced.  If there are multiple
  +entries with key <var>k</var>, the first one is modified, and
  +all the other matching entries are deleted from the table.  The value
  +is always duplicated from the routine argument into the table's pool
  +using <code>ap_pstrdup()</code>, and a pointer to the copy used; if a new
  +entry needs to be created, the key string is copied as well.  If both
  +the key and the value are literals, use <code>ap_table_setn()</code>
  +instead.
   </p>
  
  
  
  1.5       +10 -4     httpd-docs-1.3/apidoc/dict-ap_table_setn.html
  
  Index: dict-ap_table_setn.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/apidoc/dict-ap_table_setn.html,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -u -r1.4 -r1.5
  --- dict-ap_table_setn.html	2000/07/24 22:14:00	1.4
  +++ dict-ap_table_setn.html	2000/07/27 10:06:56	1.5
  @@ -1,6 +1,12 @@
   <p>
  -Replaces or creates <EM>t</EM> with new <EM>val</EM> in table <EM>t</EM>.
  -</p>
  -<p>
  -This function does not use ap_pstrdup.
  +Sets the entry in table <var>t</var> with key <var>k</var> to have
value
  +<var>val</var>.  If no such entry exists, one is created.  If an
  +entry does exist, its value is replaced.  If there are multiple
  +entries with key <var>k</var>, the first one is modified, and
  +all the other matching entries are deleted from the table.
  +The key and value pointers from the argument list are inserted
  +directly into the table, so the caller <b>must not</b> modify
  +them after calling this routine.  If either the key or the
  +value cannot be guaranteed immutable, you should use
  +<code>ap_table_set()</code> (<i>q.v.</i>) instead.
   </p>
  
  
  
  1.15      +2 -2      httpd-docs-1.3/apidoc/mkapidict
  
  Index: mkapidict
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/apidoc/mkapidict,v
  retrieving revision 1.14
  retrieving revision 1.15
  diff -u -u -r1.14 -r1.15
  --- mkapidict	2000/07/25 21:45:47	1.14
  +++ mkapidict	2000/07/27 10:06:56	1.15
  @@ -466,10 +466,10 @@
    "http://www.w3.org/TR/REC-html40/loose.dtd">
   <html>
    <head>
  -  <title>Apache API: $iname</title>
  +  <title>Apache 1.3 API: $iname</title>
    </head>
    <body>
  -  <h1>Apache API Documentation</h1>
  +  <h1>Apache 1.3 API Documentation</h1>
   EOHT
   
       my($p) = $Prefix{$rtype};
  
  
  

Mime
View raw message