granicus.if.org Git - apache/blob - 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   *) mod_socache_memcache: Add the 'MemcacheConnTTL' directive to control how
 113      long to keep idle connections with the memcache server(s).
 114      Change default value from 600 usec (!) to 15 sec.  PR 58091
 115      Measurements available in the svn commit message.
 116      trunk: http://svn.apache.org/r1696105
 117             http://svn.apache.org/r1700418
 118      2.4.x: http://people.apache.org/~jailletc36/socache_memcache.diff
 119      +1: jailletc36, ylavic, covener
 120      covener: please add compatibility tag to doc during backport
 121      jailletc36: done in r1700418
 122
 123
 124   *) Fix some spurious and/or inconsistant indent spotted by sparse
 125      Fix some minor style issues.
 126      trunk: http://svn.apache.org/r1700317
 127             http://svn.apache.org/r1700318
 128             http://svn.apache.org/r1700319
 129             http://svn.apache.org/r1700320
 130             http://svn.apache.org/r1700321
 131             http://svn.apache.org/r1700322
 132             http://svn.apache.org/r1700326
 133             http://svn.apache.org/r1700328
 134             http://svn.apache.org/r1700330
 135             http://svn.apache.org/r1700331
 136             http://svn.apache.org/r1700332
 137             http://svn.apache.org/r1700334
 138             http://svn.apache.org/r1700336
 139             http://svn.apache.org/r1700338
 140      2.4.x: http://people.apache.org/~jailletc36/sparse.diff
 141      +1: jailletc36, ylavic, covener
 142      jailletc36: To ease review http://people.apache.org/~jailletc36/sparse_nospace.diff
 143                  is the same file as above but generated using svn diff -x --ignore-all-space
 144
 145
 146 PATCHES PROPOSED TO BACKPORT FROM TRUNK:
 147   [ New proposals should be added at the end of the list ]
 148
 149    * mod_proxy: Add ap_proxy_define_match_worker() and use it for ProxyPassMatch
 150      and ProxyMatch section to distinguish between normal workers and workers
 151      with regex substitutions in the name. Implement handling of such workers
 152      in ap_proxy_get_worker(). Fixes the bug when regex workers were not
 153      matched and used for request. PR 43513.
 154      trunk patch: http://svn.apache.org/r1609680
 155                   http://svn.apache.org/r1609688
 156                   http://svn.apache.org/r1641381
 157      ylavic: Merge patch provided (reusing new->real to avoid double de_socketfy() call).
 158              Also added missing r1609688 to the patchset.
 159      2.4.x patch: http://people.apache.org/~ylavic/httpd-2.4.x-ap_proxy_define_match_worker.patch
 160      +1: ylavic
 161      -0: covener tried to review this one in Austin with Jeff.  Does the added match function
 162          really cover a very narrow set of parameters with the way it skips over backreferences?
 163          Also, why a new API vs. just setting the field inline?
 164
 165    * core: Add ap_errorlog_provider to make ErrorLog logging modular. This
 166            backport keeps syslog logging as part of httpd core and only adds
 167            API to allow other modules to be used for error logging.
 168      trunk patch: http://svn.apache.org/r1525597
 169                   http://svn.apache.org/r1525664
 170                   http://svn.apache.org/r1525845
 171                   http://svn.apache.org/r1527003
 172                   http://svn.apache.org/r1527005
 173                   http://svn.apache.org/r1532344
 174                   http://svn.apache.org/r1539988
 175                   http://svn.apache.org/r1541029
 176                   http://svn.apache.org/r1543979
 177                   http://svn.apache.org/r1544156
 178                   http://svn.apache.org/r1626978
 179      2.4.x patch: http://people.apache.org/~jkaluza/patches/httpd-2.4.x-errorlog_provider.patch
 180      +1: jkaluza
 181      +1: covener w/ doc or code to fix syntax (providername:providerarg not supported like syslog or socacheproviders,
 182                  needs 2 args which is not valid in ErrorLog manual)
 183      trawick: nit: fix "writing" in "/* NULL if we are writting to syslog */"
 184               (sorry, haven't finished reviewing completely)
 185
 186    * mod_journald: Add new module mod_journald to log error logs into journald.
 187                    This patch needs changes done in mod_systemd patch (already
 188                    proposed for 2.4.x).
 189      trunk patch: http://svn.apache.org/r1610339
 190                   http://svn.apache.org/r1621806
 191      2.4.x patch: http://people.apache.org/~jkaluza/patches/httpd-2.4.x-mod_journald.patch
 192      +1: jkaluza
 193
 194    * MPMs: Support SO_REUSEPORT to create multiple duplicated listener
 195            records for scalability (full log in 2.4.x patch).
 196      trunk patch: http://svn.apache.org/r1599531
 197                   http://svn.apache.org/r1599593
 198                   http://svn.apache.org/r1599601
 199                   http://svn.apache.org/r1599603
 200                   http://svn.apache.org/r1601558
 201                   http://svn.apache.org/r1629909
 202                   http://svn.apache.org/r1629918
 203                   http://svn.apache.org/r1629990
 204                   http://svn.apache.org/r1635521
 205                   http://svn.apache.org/r1635859
 206                   http://svn.apache.org/r1640145
 207                   http://svn.apache.org/r1640161
 208                   http://svn.apache.org/r1640184
 209                   http://svn.apache.org/r1640763
 210                   http://svn.apache.org/r1643179
 211                   http://svn.apache.org/r1656368
 212                   http://svn.apache.org/r1679714
 213      2.4.x patch: http://people.apache.org/~ylavic/httpd-2.4.x-ap_listeners_buckets-v3.patch
 214      +1: ylavic, jim
 215
 216   *) http: Don't remove the Content-Length of zero from a HEAD response if
 217      it comes from an origin server, module or script. Allow the previous
 218      behaviour (for legacy/buggy modules only, not origin) by also backporting
 219      the HttpContentLengthHeadZero directive (and also HttpExpectStrict which
 220      comes for free with the same commit).
 221      trunk patch: http://svn.apache.org/r1554303
 222                   http://svn.apache.org/r1678215
 223      2.4.x patch: http://people.apache.org/~ylavic/httpd-2.4.x-preserve_head_cl_zero.patch
 224      +1: ylavic
 225      ylavic: r1554303 issued a major MMN bump, but since the ABI change is two
 226              ints added at the end of core_server_config, the proposed merge
 227              does a minor bump only.
 228
 229   *) mod_substitute: Configure patterns merge order. PR 57641
 230      trunk patch: http://svn.apache.org/r1684900
 231                   http://svn.apache.org/r1687539
 232                   http://svn.apache.org/r1687680
 233                   http://svn.apache.org/r1688331
 234                   http://svn.apache.org/r1688339
 235                   http://svn.apache.org/r1688340
 236                   http://svn.apache.org/r1688343
 237                   http://svn.apache.org/r1697013
 238                   http://svn.apache.org/r1697015
 239      2.4.x patch: http://people.apache.org/~ylavic/httpd-2.4.x-SubstituteInheritBefore-v5.patch
 240      +1: ylavic
 241      ylavic: updated to v5 including r1697013 and r1697015, the diff to v4 is:
 242              http://people.apache.org/~ylavic/httpd-2.4.x-SubstituteInheritBefore-v4_vs_v5.diff
 243
 244   *) mod_proxy: Fix a race condition that caused a failed worker to be retried
 245      before the retry period is over
 246       Trunk version of patch:
 247          http://svn.apache.org/r1664709
 248          http://svn.apache.org/r1697323
 249       Backport version for 2.4.x of patch:
 250          Trunk version of patch works modulo CHANGES
 251       +1: rpluem, ylavic
 252       niq: 1. the if(worker->s->retries) {} and comment at line 2917
 253               don't seem to make any sense.
 254       rpluem: This is just taken over from existing code. It is just indented
 255               differently hence part of the path I think it should be marked
 256               as TODO section. But this should be subject to another
 257               patch.
 258            2. Re: error handline line 2930 - can PROXY_WORKER_IS_USABLE
 259               not be tested BEFORE opening connection?
 260       rpluem: We could, but we can catch more race cases with the current code
 261               as it also catches the case where a connection establishment
 262               took long and the worker went into error meanwhile.
 263
 264   *) util_script: Make REDIRECT_URL a complete URL (where set).
 265      PR 57785
 266      trunk: http://svn.apache.org/viewvc?view=revision&revision=1677702
 267      2.4.x: trunk patch applies.
 268      +1: niq
 269
 270   *) core/mod_ssl: add Protocols/ProtocolsHonorOrder directives and new
 271      protocols hooks to control Upgrade: and ALPN protocol switching.
 272      HTTP_MISDIRECTED_REQUEST addition and handling in mod_ssl
 273      trunk patch: http://svn.apache.org/r1697855
 274                   http://svn.apache.org/r1697339
 275                   http://svn.apache.org/r1696428
 276                   http://svn.apache.org/r1696266
 277                   http://svn.apache.org/r1696264
 278                   http://svn.apache.org/r1695874
 279                   http://svn.apache.org/r1695727
 280                   http://svn.apache.org/r1692516
 281                   http://svn.apache.org/r1692486
 282                   http://svn.apache.org/r1610674
 283                   http://svn.apache.org/r1685069
 284                   http://svn.apache.org/r1693918
 285                   http://svn.apache.org/r1698116
 286                   http://svn.apache.org/r1698133
 287                   http://svn.apache.org/r1694950
 288                   http://svn.apache.org/r1700968
 289                   http://svn.apache.org/r1701005
 290                   http://svn.apache.org/r1701145
 291                   http://svn.apache.org/r1701178
 292      All changes to files in modules/http2 need to be ignored.
 293      v2: added r1698116, r1693918 to patch
 294      v3: added changes to ap_array_index and ap_array_contains
 295      2.4.x patch: https://raw.githubusercontent.com/icing/mod_h2/master/sandbox/httpd/patches/core-protocols-v4.patch
 296      +1: icing, jim
 297
 298   *) mod_h2: add HTTP/2 support to httpd, depends on core/mod_ssl changes above
 299      trunk patch: http://svn.apache.org/r1700783
 300                   http://svn.apache.org/r1688474
 301                   http://svn.apache.org/r1688475
 302                   http://svn.apache.org/r1689605
 303                   http://svn.apache.org/r1690120
 304                   http://svn.apache.org/r1690137
 305                   http://svn.apache.org/r1690248
 306                   http://svn.apache.org/r1691374
 307                   http://svn.apache.org/r1691582
 308                   http://svn.apache.org/r1691592
 309                   http://svn.apache.org/r1691819
 310                   http://svn.apache.org/r1691908
 311                   http://svn.apache.org/r1692285
 312                   http://svn.apache.org/r1692432
 313                   http://svn.apache.org/r1692486
 314                   http://svn.apache.org/r1694951
 315                   http://svn.apache.org/r1695885
 316                   http://svn.apache.org/r1695920
 317                   http://svn.apache.org/r1696264
 318                   http://svn.apache.org/r1696279
 319                   http://svn.apache.org/r1696428
 320                   http://svn.apache.org/r1696442
 321                   http://svn.apache.org/r1696565
 322                   http://svn.apache.org/r1696592
 323                   http://svn.apache.org/r1696607
 324                   http://svn.apache.org/r1696755
 325                   http://svn.apache.org/r1696881
 326                   http://svn.apache.org/r1697051
 327                   http://svn.apache.org/r1697339
 328                   http://svn.apache.org/r1697370
 329                   http://svn.apache.org/r1697389
 330                   http://svn.apache.org/r1697446
 331                   http://svn.apache.org/r1697543
 332                   http://svn.apache.org/r1697634
 333                   http://svn.apache.org/r1697855
 334                   http://svn.apache.org/r1698023
 335                   http://svn.apache.org/r1698103
 336                   http://svn.apache.org/r1698107
 337                   http://svn.apache.org/r1698116
 338                   http://svn.apache.org/r1698133
 339                   http://svn.apache.org/r1700271
 340                   http://svn.apache.org/r1700275
 341                   http://svn.apache.org/r1700514
 342                   http://svn.apache.org/r1700777
 343                   http://svn.apache.org/r1700917
 344                   http://svn.apache.org/r1700925
 345                   http://svn.apache.org/r1701204
 346      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
 347      +1: icing, jim
 348
 349
 350   *) mod_rewrite: Fix an harmless error spotted by sparse.
 351      trunk: http://svn.apache.org/r1697735
 352      2.4.x: trunk patch applies.
 353      +1: jailletc36
 354      ylavic: I'd prefer the unambiguous parentheses in the macros definitions,
 355              as you suggested on dev@.
 356      covener: +1 ^
 357
 358
 359   *) Allow autoindexes to work without mod_dir or mod_mime
 360      trunk: http://svn.apache.org/r1701436
 361      2.4.x: trunk works
 362      +1: covener
 363
 364 PATCHES/ISSUES THAT ARE BEING WORKED
 365
 366    * mod_proxy_http: Don't establish or reuse a backend connection before pre-
 367      fetching the request body, so to minimize the delay between it is supposed
 368      to be alive and the first bytes sent: this is a best effort to prevent the
 369      backend from closing because of idle or keepalive timeout in the meantime.
 370      Also, handle a new "proxy-flushall" environment variable which allows to
 371      flush any forwarded body data immediately. PR 56541+37920.
 372      trunk patch: http://svn.apache.org/r1656259
 373                   http://svn.apache.org/r1656359 (CHANGES entry)
 374      2.4.x patch: trunk works (modulo CHANGES, docs/log-message-tags)
 375      +1: ylavic
 376      -0: jim:  This seems to be a hit to normal performance, to handle an
 377                error and/or non-normal condition. The pre-fetch is
 378                expensive, and is always done, even before we know that
 379                the backend is available to rec' it. I understand the
 380                error described, but is the fix actually worth it (plus
 381                it seems to allow for a DDoS vector).
 382      ylavic: It seems to me that the problem is real since we reuse the
 383              connection before prefetching 16K (either controlled by the
 384              client, or by an input filter), we currently always prefetch
 385              these bytes already. Regarding performance I don't see any
 386              difference (more cycles) compared with the current code.
 387              However I think I failed to rebuild the header_brigade when
 388              the proxy loop is retried (ping), so I need to rework this.
 389              Do you think we'd better remove the prefetch, or maybe just
 390              make it nonblocking (by default)?
 391         jim: Non-blocking seems the best way to handle...
 392
 393 PATCHES/ISSUES THAT ARE STALLED
 394
 395    * mod_systemd: New module, for integration with systemd on Linux.
 396      trunk patch: http://svn.apache.org/r1393976
 397                   http://svn.apache.org/r1393997
 398                   http://svn.apache.org/r1484554
 399                   http://svn.apache.org/r1528032
 400                   http://svn.apache.org/r1528034
 401                   http://svn.apache.org/r1614821
 402                   http://svn.apache.org/r1618579
 403                   http://svn.apache.org/r1618588
 404      2.4.x patch: http://people.apache.org/~jkaluza/patches/mod_systemd/httpd-2.4.x-mod_systemd.patch
 405      +1: jkaluza
 406
 407    * core: Add support for systemd socket activation.
 408      trunk patch: http://svn.apache.org/r1511033
 409                   http://svn.apache.org/r1608686
 410                   http://svn.apache.org/r1608694
 411                   http://svn.apache.org/r1608703
 412                   http://svn.apache.org/r1608721
 413                   http://svn.apache.org/r1608744
 414      2.4.x patch: http://people.apache.org/~jkaluza/patches/mod_systemd/httpd-2.4.x-socket-activation.patch
 415      +1: jkaluza
 416
 417   * mod_proxy: Ensure network errors detected by the proxy are returned as
 418     504 Gateway Timout as opposed to 502 Bad Gateway
 419     trunk patch: https://svn.apache.org/viewvc?view=revision&revision=1480058
 420     2.4.x patch: trunk patch works modulo CHANGES
 421     +1:
 422     -1: rpluem: This change is still disputed. See
 423         http://mail-archives.apache.org/mod_mbox/httpd-dev/201305.mbox/%3C1B16B9E3-87BA-4EEF-939C-7C7313B54714%40gbiv.com%3E
 424
 425   * cross-compile: allow to provide CC_FOR_BUILD so that gen_test_char will be
 426     compiled by the build compiler instead of the host compiler.
 427     Also set CC_FOR_BUILD to 'cc' when cross-compilation is detected.
 428     Trunk patches: http://svn.apache.org/viewvc?view=revision&revision=1327907
 429                    http://svn.apache.org/viewvc?view=revision&revision=1328390
 430                    http://svn.apache.org/viewvc?view=revision&revision=1328714
 431     2.4 patch: http://people.apache.org/~fuankg/diffs/httpd-2.4.x-cross_compile.diff
 432     fuankg: on hold until we agree for a better and more simple solution ...
 433
 434    * Makefile.win: Added copying of .vbs / .wsf CGIs to Windows install target.
 435                    Moved fixing of shebang to separate target so that it is
 436                    no longer executed by default and all CGIs remain inactive.
 437      trunk patch: http://svn.apache.org/viewvc?view=revision&revision=1387984
 438                   http://svn.apache.org/viewvc?view=revision&revision=1421203
 439                   http://svn.apache.org/viewvc?view=revision&revision=1421591
 440      2.4.x patch: http://people.apache.org/~fuankg/diffs/httpd-2.4.x-Makefile.win.diff
 441      +1 fuankg, gsmith
 442      -.8: trawick
 443           This commit is essentially deciding that an httpd install on
 444           Windows now has printenv/testcgi written in 2 more languages.
 445           To the extent that the usefulness is that it shows how to make scripts
 446           of these types executable by httpd, I believe that the documentation
 447           is the proper place to solve that.  To the extent that the usefullness
 448           is to show how to implement a CGI in these particular languages, I believe
 449           that the httpd distribution and documentation in general is not the
 450           place for that.  Historically these types of scripts have caused problems
 451           for downstream vendorsas well as newbies (and sometimes the intersection
 452           of those two groups) who don't understand that these are information leaks
 453           once they are enabled, and the subtlety of the way they are disabled ("Apache
 454           messed up the first line; let me fix that") contributes to that.
 455      fuankg notes: I've just added a big warning to all CGI scripts which should now
 456           make absolutely clear that these CGIs are for testing purpose only - so those
 457           who enable those scripts with inserting the right shebang should be 100% aware
 458           of any risks (this should cover your last point).
 459      jim: trawick, does the above address your concerns?
 460      trawick: to some extent (somebody reading the script gets an idea)
 461           Why isn't the configuration requirement documented instead
 462           of described indirectly in a sample?
 463           Why are these new samples added to the install without three
 464           votes?  (I didn't veto it; put your name next to the two
 465           existing ones and I'll be satisified that enough people
 466           considered this addition as an appropriate solution for a
 467           real httpd usability problem.)
 468      wrowe: I'd agree with trawick, and suggest that these scripts can begin
 469             their life somewhere in the manual/ tree.  This really seems like
 470             the place where /usr/share/httpd/examples/ would be useful, but
 471             there isn't an ordinary directory for that.  Since we want none
 472             of the scripts to function 'out of the box', what about a new
 473             cgi-examples/ dir alongside cgi-bin/? Otherwise manual/cgi/examples
 474             might work?
 475