]> granicus.if.org Git - apache/blob - STATUS
autoindex fix w/o mod_mime and mod_dir
[apache] / STATUS
1 APACHE 2.4 STATUS:                        -*- mode: text; coding: utf-8 -*-
2 Last modified at [$Date$]
3
4 The current version of this file can be found at:
5
6   * http://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x/STATUS
7
8 Documentation status is maintained separately and can be found at:
9
10   * docs/STATUS in this source tree, or
11   * http://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x/docs/STATUS
12
13 The current development branch of this software can be found at:
14
15   * http://svn.apache.org/repos/asf/httpd/httpd/trunk
16
17 Consult the following STATUS files for information on related projects:
18
19   * http://svn.apache.org/repos/asf/apr/apr/trunk/STATUS
20   * http://svn.apache.org/repos/asf/apr/apr/branches/1.4.x/STATUS
21   * http://svn.apache.org/repos/asf/apr/apr-util/branches/1.4.x/STATUS
22   * http://svn.apache.org/repos/asf/apr/apr/branches/1.5.x/STATUS
23   * http://svn.apache.org/repos/asf/apr/apr-util/branches/1.5.x/STATUS
24
25 Patches considered for backport are noted in their branches' STATUS:
26
27   * http://svn.apache.org/repos/asf/httpd/httpd/branches/2.0.x/STATUS
28   * http://svn.apache.org/repos/asf/httpd/httpd/branches/2.2.x/STATUS
29   * http://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x/STATUS
30
31
32
33 Release history:
34     [NOTE that x.{odd}.z versions are strictly Alpha/Beta releases,
35           while x.{even}.z versions are Stable/GA releases.]
36
37     2.4.17  : In development.
38     2.4.16  : Tagged on July 9, 2015. Released July 15, 2015
39     2.4.15  : Tagged on June 19, 2015. Not released.
40     2.4.14  : Tagged on June 11, 2015. Not released.
41     2.4.13  : Tagged on June 4, 2015. Not released.
42     2.4.12  : Tagged on January 22, 2015. Released Jan 29, 2015
43     2.4.11  : Tagged on January 15, 2015. Not released.
44     2.4.10  : Tagged on July 15, 2014. Released July 21, 2014
45     2.4.9   : Tagged on March 13, 2014. Released on March 17, 2014
46     2.4.8   : Tagged on March 11, 2014. Not released.
47     2.4.7   : Tagged on November 19, 2013. Released on Nov 25, 2013
48     2.4.6   : Tagged on July 15, 2013. Released July, 22, 2013
49     2.4.5   : Tagged on July 11, 2013, not released.
50     2.4.4   : Tagged on February 18, 2013. Released Feb 25, 2013
51     2.4.3   : Tagged on August 17, 2012. Released Aug 18, 2012
52     2.4.2   : Tagged on April 5, 2012. Released Apr 17, 2012.
53     2.4.1   : Tagged on February 13, 2012. Released Feb 21, 2012.
54     2.4.0   : Tagged on January 16, 2012, not released.
55     2.3.16  : Tagged on December 15, 2011.
56     2.3.15  : Tagged on November 8, 2011. Released Nov. 15, 2011.
57     2.3.14  : Tagged on August 1, 2011. Released Aug. 9, 2011.
58     2.3.13  : Tagged on June 28, 2011, not released.
59     2.3.12  : Tagged on May 11, 2011. Released May 23, 2011.
60     2.3.11  : Released as Beta on March 7, 2011.
61     2.3.10  : Tagged on December 13, 2010. Released Dec 21, 2010.
62     2.3.9   : Tagged on November 23, 2010, not released.
63     2.3.8   : Tagged on August 24, 2010.
64     2.3.7   : Tagged on August 19, 2010, not released.
65     2.3.6   : Released on June 21, 2010.
66     2.3.5   : Released on January 26, 2010.
67     2.3.4   : Released on December 8, 2009.
68     2.3.3   : Tagged on November 11, 2009, not released.
69     2.3.2   : Tagged on March 23, 2009, not released.
70     2.3.1   : Tagged on January 2, 2009, not released.
71     2.3.0   : Tagged on December 6, 2008, not released.
72
73 Contributors looking for a mission:
74
75   * Just do an egrep on "TODO" or "XXX" in the source.
76
77   * Review the bug database at: http://issues.apache.org/bugzilla/
78
79   * Review the "PatchAvailable" bugs in the bug database:
80
81     https://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=Apache+httpd-2&keywords=PatchAvailable
82
83     After testing, you can append a comment saying "Reviewed and tested".
84
85   * Open bugs in the bug database.
86
87   * See also the STATUS file in the docs/ directory, which lists documentation-specific TODO items.
88
89
90 CURRENT RELEASE NOTES:
91
92   * Forward binary compatibility is expected of Apache 2.4.x releases, such
93     that no MMN major number changes will occur after 2.4.1.  Such changes can
94     only be made in the trunk.
95
96   * All commits to branches/2.4.x must be reflected in SVN trunk,
97     as well, if they apply.  Logical progression is commit to trunk
98     then merge into branches/2.4.x, as applicable.
99
100   * Current exceptions for RTC for this branch:
101     . mod_lua
102     . documentation
103     . non-Unix build
104     . non-Unix, single-platform code
105
106 RELEASE SHOWSTOPPERS:
107
108
109 PATCHES ACCEPTED TO BACKPORT FROM TRUNK:
110   [ start all new proposals below, under PATCHES PROPOSED. ]
111
112
113
114 PATCHES PROPOSED TO BACKPORT FROM TRUNK:
115   [ New proposals should be added at the end of the list ]
116
117    * mod_proxy: Add ap_proxy_define_match_worker() and use it for ProxyPassMatch
118      and ProxyMatch section to distinguish between normal workers and workers
119      with regex substitutions in the name. Implement handling of such workers
120      in ap_proxy_get_worker(). Fixes the bug when regex workers were not
121      matched and used for request. PR 43513.
122      trunk patch: http://svn.apache.org/r1609680
123                   http://svn.apache.org/r1609688
124                   http://svn.apache.org/r1641381
125      ylavic: Merge patch provided (reusing new->real to avoid double de_socketfy() call).
126              Also added missing r1609688 to the patchset.
127      2.4.x patch: http://people.apache.org/~ylavic/httpd-2.4.x-ap_proxy_define_match_worker.patch
128      +1: ylavic
129      -0: covener tried to review this one in Austin with Jeff.  Does the added match function 
130          really cover a very narrow set of parameters with the way it skips over backreferences?
131          Also, why a new API vs. just setting the field inline?
132
133    * core: Add ap_errorlog_provider to make ErrorLog logging modular. This
134            backport keeps syslog logging as part of httpd core and only adds
135            API to allow other modules to be used for error logging.
136      trunk patch: http://svn.apache.org/r1525597
137                   http://svn.apache.org/r1525664
138                   http://svn.apache.org/r1525845
139                   http://svn.apache.org/r1527003
140                   http://svn.apache.org/r1527005
141                   http://svn.apache.org/r1532344
142                   http://svn.apache.org/r1539988
143                   http://svn.apache.org/r1541029
144                   http://svn.apache.org/r1543979
145                   http://svn.apache.org/r1544156
146                   http://svn.apache.org/r1626978
147      2.4.x patch: http://people.apache.org/~jkaluza/patches/httpd-2.4.x-errorlog_provider.patch
148      +1: jkaluza
149      +1: covener w/ doc or code to fix syntax (providername:providerarg not supported like syslog or socacheproviders, 
150                  needs 2 args which is not valid in ErrorLog manual)
151      trawick: nit: fix "writing" in "/* NULL if we are writting to syslog */"
152               (sorry, haven't finished reviewing completely)
153
154    * mod_journald: Add new module mod_journald to log error logs into journald.
155                    This patch needs changes done in mod_systemd patch (already
156                    proposed for 2.4.x).
157      trunk patch: http://svn.apache.org/r1610339
158                   http://svn.apache.org/r1621806
159      2.4.x patch: http://people.apache.org/~jkaluza/patches/httpd-2.4.x-mod_journald.patch
160      +1: jkaluza
161
162    * MPMs: Support SO_REUSEPORT to create multiple duplicated listener
163            records for scalability (full log in 2.4.x patch).
164      trunk patch: http://svn.apache.org/r1599531
165                   http://svn.apache.org/r1599593
166                   http://svn.apache.org/r1599601
167                   http://svn.apache.org/r1599603
168                   http://svn.apache.org/r1601558
169                   http://svn.apache.org/r1629909
170                   http://svn.apache.org/r1629918
171                   http://svn.apache.org/r1629990
172                   http://svn.apache.org/r1635521
173                   http://svn.apache.org/r1635859
174                   http://svn.apache.org/r1640145
175                   http://svn.apache.org/r1640161
176                   http://svn.apache.org/r1640184
177                   http://svn.apache.org/r1640763
178                   http://svn.apache.org/r1643179
179                   http://svn.apache.org/r1656368
180                   http://svn.apache.org/r1679714
181      2.4.x patch: http://people.apache.org/~ylavic/httpd-2.4.x-ap_listeners_buckets-v3.patch
182      +1: ylavic, jim
183
184   *) http: Don't remove the Content-Length of zero from a HEAD response if
185      it comes from an origin server, module or script. Allow the previous
186      behaviour (for legacy/buggy modules only, not origin) by also backporting
187      the HttpContentLengthHeadZero directive (and also HttpExpectStrict which
188      comes for free with the same commit).
189      trunk patch: http://svn.apache.org/r1554303
190                   http://svn.apache.org/r1678215
191      2.4.x patch: http://people.apache.org/~ylavic/httpd-2.4.x-preserve_head_cl_zero.patch
192      +1: ylavic
193      ylavic: r1554303 issued a major MMN bump, but since the ABI change is two
194              ints added at the end of core_server_config, the proposed merge
195              does a minor bump only.
196
197   *) mod_substitute: Configure patterns merge order. PR 57641
198      trunk patch: http://svn.apache.org/r1684900
199                   http://svn.apache.org/r1687539 
200                   http://svn.apache.org/r1687680
201                   http://svn.apache.org/r1688331
202                   http://svn.apache.org/r1688339
203                   http://svn.apache.org/r1688340
204                   http://svn.apache.org/r1688343
205                   http://svn.apache.org/r1697013
206                   http://svn.apache.org/r1697015
207      2.4.x patch: http://people.apache.org/~ylavic/httpd-2.4.x-SubstituteInheritBefore-v5.patch
208      +1: ylavic
209      ylavic: updated to v5 including r1697013 and r1697015, the diff to v4 is:
210              http://people.apache.org/~ylavic/httpd-2.4.x-SubstituteInheritBefore-v4_vs_v5.diff
211
212   *) mod_proxy: Fix a race condition that caused a failed worker to be retried
213      before the retry period is over
214       Trunk version of patch:
215          http://svn.apache.org/r1664709
216          http://svn.apache.org/r1697323
217       Backport version for 2.4.x of patch:
218          Trunk version of patch works modulo CHANGES
219       +1: rpluem, ylavic
220       niq: 1. the if(worker->s->retries) {} and comment at line 2917
221               don't seem to make any sense.
222       rpluem: This is just taken over from existing code. It is just indented
223               differently hence part of the path I think it should be marked
224               as TODO section. But this should be subject to another
225               patch.
226            2. Re: error handline line 2930 - can PROXY_WORKER_IS_USABLE
227               not be tested BEFORE opening connection?
228       rpluem: We could, but we can catch more race cases with the current code
229               as it also catches the case where a connection establishment
230               took long and the worker went into error meanwhile.
231  
232   *) util_script: Make REDIRECT_URL a complete URL (where set).
233      PR 57785
234      trunk: http://svn.apache.org/viewvc?view=revision&revision=1677702
235      2.4.x: trunk patch applies.
236      +1: niq
237
238   *) core/mod_ssl: add Protocols/ProtocolsHonorOrder directives and new 
239      protocols hooks to control Upgrade: and ALPN protocol switching.
240      HTTP_MISDIRECTED_REQUEST addition and handling in mod_ssl
241      trunk patch: http://svn.apache.org/r1697855
242                   http://svn.apache.org/r1697339
243                   http://svn.apache.org/r1696428
244                   http://svn.apache.org/r1696266
245                   http://svn.apache.org/r1696264
246                   http://svn.apache.org/r1695874
247                   http://svn.apache.org/r1695727
248                   http://svn.apache.org/r1692516
249                   http://svn.apache.org/r1692486
250                   http://svn.apache.org/r1610674
251                   http://svn.apache.org/r1685069
252                   http://svn.apache.org/r1693918
253                   http://svn.apache.org/r1698116
254                   http://svn.apache.org/r1698133
255                   http://svn.apache.org/r1694950
256                   http://svn.apache.org/r1700968
257                   http://svn.apache.org/r1701005
258                   http://svn.apache.org/r1701145
259                   http://svn.apache.org/r1701178
260      All changes to files in modules/http2 need to be ignored.
261      v2: added r1698116, r1693918 to patch
262      v3: added changes to ap_array_index and ap_array_contains
263      2.4.x patch: https://raw.githubusercontent.com/icing/mod_h2/master/sandbox/httpd/patches/core-protocols-v4.patch
264      +1: icing, jim
265
266   *) mod_h2: add HTTP/2 support to httpd, depends on core/mod_ssl changes above
267      trunk patch: http://svn.apache.org/r1700783
268                   http://svn.apache.org/r1688474
269                   http://svn.apache.org/r1688475
270                   http://svn.apache.org/r1689605
271                   http://svn.apache.org/r1690120
272                   http://svn.apache.org/r1690137
273                   http://svn.apache.org/r1690248
274                   http://svn.apache.org/r1691374
275                   http://svn.apache.org/r1691582
276                   http://svn.apache.org/r1691592
277                   http://svn.apache.org/r1691819
278                   http://svn.apache.org/r1691908
279                   http://svn.apache.org/r1692285
280                   http://svn.apache.org/r1692432
281                   http://svn.apache.org/r1692486
282                   http://svn.apache.org/r1694951
283                   http://svn.apache.org/r1695885
284                   http://svn.apache.org/r1695920
285                   http://svn.apache.org/r1696264
286                   http://svn.apache.org/r1696279
287                   http://svn.apache.org/r1696428
288                   http://svn.apache.org/r1696442
289                   http://svn.apache.org/r1696565
290                   http://svn.apache.org/r1696592
291                   http://svn.apache.org/r1696607
292                   http://svn.apache.org/r1696755
293                   http://svn.apache.org/r1696881
294                   http://svn.apache.org/r1697051
295                   http://svn.apache.org/r1697339
296                   http://svn.apache.org/r1697370
297                   http://svn.apache.org/r1697389
298                   http://svn.apache.org/r1697446
299                   http://svn.apache.org/r1697543
300                   http://svn.apache.org/r1697634
301                   http://svn.apache.org/r1697855
302                   http://svn.apache.org/r1698023
303                   http://svn.apache.org/r1698103
304                   http://svn.apache.org/r1698107
305                   http://svn.apache.org/r1698116
306                   http://svn.apache.org/r1698133
307                   http://svn.apache.org/r1700271
308                   http://svn.apache.org/r1700275
309                   http://svn.apache.org/r1700514
310                   http://svn.apache.org/r1700777
311                   http://svn.apache.org/r1700917
312                   http://svn.apache.org/r1700925
313                   http://svn.apache.org/r1701204
314      2.4.x patch for this and core/mod_ssl: https://raw.githubusercontent.com/icing/mod_h2/master/sandbox/httpd/patches/core-h2-all-in-one-v4.patch
315      +1: icing, jim
316
317
318   *) mod_socache_memcache: Add the 'MemcacheConnTTL' directive to control how 
319      long to keep idle connections with the memcache server(s).
320      Change default value from 600 usec (!) to 15 sec.  PR 58091
321      Measurements available in the svn commit message.
322      trunk: http://svn.apache.org/r1696105
323             http://svn.apache.org/r1700418
324      2.4.x: http://people.apache.org/~jailletc36/socache_memcache.diff
325      +1: jailletc36, ylavic
326      covener: please add compatibility tag to doc during backport
327      jailletc36: done in r1700418
328
329   *) mod_rewrite: Fix an harmless error spotted by sparse.
330      trunk: http://svn.apache.org/r1697735
331      2.4.x: trunk patch applies.
332      +1: jailletc36
333      ylavic: I'd prefer the unambiguous parentheses in the macros definitions,
334              as you suggested on dev@.
335
336   *) Fix some spurious and/or inconsistant indent spotted by sparse
337      Fix some minor style issues.
338      trunk: http://svn.apache.org/r1700317
339             http://svn.apache.org/r1700318
340             http://svn.apache.org/r1700319
341             http://svn.apache.org/r1700320
342             http://svn.apache.org/r1700321
343             http://svn.apache.org/r1700322
344             http://svn.apache.org/r1700326
345             http://svn.apache.org/r1700328
346             http://svn.apache.org/r1700330
347             http://svn.apache.org/r1700331
348             http://svn.apache.org/r1700332
349             http://svn.apache.org/r1700334
350             http://svn.apache.org/r1700336
351             http://svn.apache.org/r1700338
352      2.4.x: http://people.apache.org/~jailletc36/sparse.diff
353      +1: jailletc36, ylavic
354      jailletc36: To ease review http://people.apache.org/~jailletc36/sparse_nospace.diff
355                  is the same file as above but generated using svn diff -x --ignore-all-space
356
357   *) Allow autoindexes to work without mod_dir or mod_mime
358      trunk: http://svn.apache.org/r1701436
359      2.4.x: trunk works
360      +1: covener
361
362 PATCHES/ISSUES THAT ARE BEING WORKED
363
364   *) mod_ssl: add ALPN support by allowing other modules to register callbacks
365               for negotiation of the application layer protocol.  PR 52210.
366      trunk patch: http://svn.apache.org/r1332643
367                   http://svn.apache.org/r1487772
368                   http://svn.apache.org/r1670397
369                   http://svn.apache.org/r1670434
370                   http://svn.apache.org/r1670436
371                   http://svn.apache.org/r1670578
372                   http://svn.apache.org/r1670738
373                   http://svn.apache.org/r1675459
374                   http://svn.apache.org/r1676004
375                   http://svn.apache.org/r1676709
376                   http://svn.apache.org/r1681741
377                   http://svn.apache.org/r1681746
378                   http://svn.apache.org/r1685069
379      2.4.x patch: http://people.apache.org/~ylavic/httpd-2.4.x-alpn-v4.patch
380      +1:
381      ylavic: Needs work wrt activation with a new Protocols directive:
382              http://www.mail-archive.com/dev@httpd.apache.org/msg62163.html
383              and also about SNI checks and status 421:
384              http://www.mail-archive.com/dev@httpd.apache.org/msg62230.html
385              Let's comment on @dev for Stefan Eissing (mod_h2) to be able to
386              participate.
387
388    * mod_proxy_http: Don't establish or reuse a backend connection before pre-
389      fetching the request body, so to minimize the delay between it is supposed
390      to be alive and the first bytes sent: this is a best effort to prevent the
391      backend from closing because of idle or keepalive timeout in the meantime.
392      Also, handle a new "proxy-flushall" environment variable which allows to
393      flush any forwarded body data immediately. PR 56541+37920.
394      trunk patch: http://svn.apache.org/r1656259
395                   http://svn.apache.org/r1656359 (CHANGES entry)
396      2.4.x patch: trunk works (modulo CHANGES, docs/log-message-tags)
397      +1: ylavic
398      -0: jim:  This seems to be a hit to normal performance, to handle an
399                error and/or non-normal condition. The pre-fetch is
400                expensive, and is always done, even before we know that
401                the backend is available to rec' it. I understand the
402                error described, but is the fix actually worth it (plus
403                it seems to allow for a DDoS vector).
404      ylavic: It seems to me that the problem is real since we reuse the
405              connection before prefetching 16K (either controlled by the
406              client, or by an input filter), we currently always prefetch
407              these bytes already. Regarding performance I don't see any
408              difference (more cycles) compared with the current code.
409              However I think I failed to rebuild the header_brigade when
410              the proxy loop is retried (ping), so I need to rework this.
411              Do you think we'd better remove the prefetch, or maybe just
412              make it nonblocking (by default)?
413         jim: Non-blocking seems the best way to handle...
414
415 PATCHES/ISSUES THAT ARE STALLED
416
417    * mod_systemd: New module, for integration with systemd on Linux.
418      trunk patch: http://svn.apache.org/r1393976
419                   http://svn.apache.org/r1393997
420                   http://svn.apache.org/r1484554
421                   http://svn.apache.org/r1528032
422                   http://svn.apache.org/r1528034
423                   http://svn.apache.org/r1614821
424                   http://svn.apache.org/r1618579
425                   http://svn.apache.org/r1618588
426      2.4.x patch: http://people.apache.org/~jkaluza/patches/mod_systemd/httpd-2.4.x-mod_systemd.patch
427      +1: jkaluza
428
429    * core: Add support for systemd socket activation.
430      trunk patch: http://svn.apache.org/r1511033
431                   http://svn.apache.org/r1608686
432                   http://svn.apache.org/r1608694
433                   http://svn.apache.org/r1608703
434                   http://svn.apache.org/r1608721
435                   http://svn.apache.org/r1608744
436      2.4.x patch: http://people.apache.org/~jkaluza/patches/mod_systemd/httpd-2.4.x-socket-activation.patch
437      +1: jkaluza
438
439   * mod_proxy: Ensure network errors detected by the proxy are returned as
440     504 Gateway Timout as opposed to 502 Bad Gateway
441     trunk patch: https://svn.apache.org/viewvc?view=revision&revision=1480058
442     2.4.x patch: trunk patch works modulo CHANGES
443     +1:
444     -1: rpluem: This change is still disputed. See
445         http://mail-archives.apache.org/mod_mbox/httpd-dev/201305.mbox/%3C1B16B9E3-87BA-4EEF-939C-7C7313B54714%40gbiv.com%3E
446
447   * cross-compile: allow to provide CC_FOR_BUILD so that gen_test_char will be
448     compiled by the build compiler instead of the host compiler.
449     Also set CC_FOR_BUILD to 'cc' when cross-compilation is detected.
450     Trunk patches: http://svn.apache.org/viewvc?view=revision&revision=1327907
451                    http://svn.apache.org/viewvc?view=revision&revision=1328390
452                    http://svn.apache.org/viewvc?view=revision&revision=1328714
453     2.4 patch: http://people.apache.org/~fuankg/diffs/httpd-2.4.x-cross_compile.diff
454     fuankg: on hold until we agree for a better and more simple solution ...
455
456    * Makefile.win: Added copying of .vbs / .wsf CGIs to Windows install target.
457                    Moved fixing of shebang to separate target so that it is
458                    no longer executed by default and all CGIs remain inactive.
459      trunk patch: http://svn.apache.org/viewvc?view=revision&revision=1387984
460                   http://svn.apache.org/viewvc?view=revision&revision=1421203
461                   http://svn.apache.org/viewvc?view=revision&revision=1421591
462      2.4.x patch: http://people.apache.org/~fuankg/diffs/httpd-2.4.x-Makefile.win.diff
463      +1 fuankg, gsmith
464      -.8: trawick
465           This commit is essentially deciding that an httpd install on
466           Windows now has printenv/testcgi written in 2 more languages.
467           To the extent that the usefulness is that it shows how to make scripts
468           of these types executable by httpd, I believe that the documentation
469           is the proper place to solve that.  To the extent that the usefullness
470           is to show how to implement a CGI in these particular languages, I believe
471           that the httpd distribution and documentation in general is not the
472           place for that.  Historically these types of scripts have caused problems
473           for downstream vendorsas well as newbies (and sometimes the intersection
474           of those two groups) who don't understand that these are information leaks
475           once they are enabled, and the subtlety of the way they are disabled ("Apache
476           messed up the first line; let me fix that") contributes to that.
477      fuankg notes: I've just added a big warning to all CGI scripts which should now
478           make absolutely clear that these CGIs are for testing purpose only - so those
479           who enable those scripts with inserting the right shebang should be 100% aware
480           of any risks (this should cover your last point).
481      jim: trawick, does the above address your concerns?
482      trawick: to some extent (somebody reading the script gets an idea)
483           Why isn't the configuration requirement documented instead
484           of described indirectly in a sample?
485           Why are these new samples added to the install without three
486           votes?  (I didn't veto it; put your name next to the two
487           existing ones and I'll be satisified that enough people
488           considered this addition as an appropriate solution for a
489           real httpd usability problem.)
490      wrowe: I'd agree with trawick, and suggest that these scripts can begin
491             their life somewhere in the manual/ tree.  This really seems like
492             the place where /usr/share/httpd/examples/ would be useful, but
493             there isn't an ordinary directory for that.  Since we want none
494             of the scripts to function 'out of the box', what about a new
495             cgi-examples/ dir alongside cgi-bin/? Otherwise manual/cgi/examples
496             might work?
497