documentation/3088: INSTALL document directions to test initial server build do not match the default configuration file.

[Rob Jenson <ro...@spotch.com>]

>Number:         3088
>Category:       documentation
>Synopsis:       INSTALL document directions to test initial server build do not match the default configuration file.
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    apache
>State:          open
>Class:          doc-bug
>Submitter-Id:   apache
>Arrival-Date:   Sun Sep 27 19:20:00 PDT 1998
>Last-Modified:
>Originator:     robjen@spotch.com
>Organization:
apache
>Release:        1.3.2
>Environment:
Linux 2.0.35 i586
gcc version 2.7.2.3
libc-2.07
>Description:
The INSTALL documentation states that an Apache server installed according
to the directions will be running at http://localhost/.  In fact, based on
the configuration files that are created with the default instructions, the
Apache server begins running at http://localhost:8080/ -- This is not a show-
stopper ... just confusing for newcomers to Apache.  Documentation patch below.
>How-To-Repeat:
Follow INSTALL directions exactly.  At line 438 (counting absolute lines),
after starting the server for the first time  with apachectl, the directions
say to go to http://localhost instead of http://localhost:8080 which is where
the default configuration sets it up.
>Fix:
I like the idea of leaving the default configuration on port 8080 until you figure
out how to move it to port 80 if that's what you want.  Apply the following patch
to the INSTALL file to fix the documentation to match the system:

*** INSTALL.DIST        Sat Sep 19 09:06:40 1998
--- INSTALL     Sun Sep 27 22:09:25 1998
***************
*** 435,441 ****
          $ PREFIX/sbin/apachectl start
   
       and then you should be able to request your first document via URL
!      http://localhost/. Then stop the server again by running:
    
          $ PREFIX/sbin/apachectl stop
   
--- 435,441 ----
          $ PREFIX/sbin/apachectl start
   
       and then you should be able to request your first document via URL
!      http://localhost:8080/. Then stop the server again by running:
    
          $ PREFIX/sbin/apachectl stop
   
***************
*** 449,455 ****
          $ vi PREFIX/etc/access.conf
          $ vi PREFIX/etc/srm.conf
   
!      Have a look at the Apache manual under http://localhost/manual/ or
       http://www.apache.org/docs/ for a complete reference of available
       configuration directives.
  
--- 449,455 ----
          $ vi PREFIX/etc/access.conf
          $ vi PREFIX/etc/srm.conf
   
!      Have a look at the Apache manual under http://localhost:8080/manual/ or
       http://www.apache.org/docs/ for a complete reference of available
       configuration directives.
  

>Audit-Trail:
>Unformatted:
[In order for any reply to be added to the PR database, ]
[you need to include <ap...@Apache.Org> in the Cc line ]
[and leave the subject line UNCHANGED.  This is not done]
[automatically because of the potential for mail loops. ]
[If you do not include this Cc, your reply may be ig-   ]
[nored unless you are responding to an explicit request ]
[from a developer.                                      ]
[Reply only with text; DO NOT SEND ATTACHMENTS!         ]