Changed INSTALL.txt to focus new users on zopectl

rather then runzope to avoid all the hassle with
not detaching and thus mysteriously stopping zopes.

doc/INSTALL.txt

@@ -62,7 +62,17 @@ Building Zope
     within the build directory (e.g. 'in-place').  You may start
     Zope by running::
 
-      ./bin/runzope
+      ./bin/zopectl start
+
+    See ./log/event.log for any output which may happen during
+    start of Zope. If anything goes wrong you will see there.
+
+    If you use
+
+      ./bin/zopectl fg
+
+    instead, the output is generated to the screen. In this case
+    Zope does not detach from terminal.
 
   Optional:  Building Zope Using The "Clean-Source-Tree" Method
 
@@ -102,21 +112,44 @@ Starting Zope
   Once an instance home has been created, the Zope server can now be
   started using this command:
 
-    /location/of/zope/instance/bin/runzope
+    /location/of/zope/instance/bin/zopectl start
+
+  During start, zope emits log messages into ./log/event.log
+  You can examine it with the usual tools (cat, more, tail)
+  and see if there are any errors preventing zope from starting.
+
+    /location/of/zope/instance/bin/zopectl fg
+
+  can be used to instead output these messages to the console. This
+  way zope does not detach from terminal.
 
   If you get errors indicating that addresses are in use, then you
   will have to supply arguments to runzope to change the ports used
   for HTTP or FTP. The default HTTP and FTP ports used by Zope are
   8080 and 8021 respectively. You can change the ports used by
-  specifying the "port-base" parameter to runzope.  For example, to
-  run Zope on ports 9080 and 9021::
+  editing ./etc/zope.conf apropriately.
+
+  The section usually is like this:
+
+  <http-server>
+    # valid keys are "address" and "force-connection-close"
+    address 8080
+    # force-connection-close on
+  </http-server>
+
+  address can just be a port number as shown, but also a host:port
+  pair to bind to a specific interface only.
+
+  zopectl can be linked as rc-script in the usual start directories
+  on linux or other system V unix variants.
 
-    ./bin/runzope -X port-base=1000
+  You can use zopectl interactively as a command shell by just
+  calling it w/o any arguments. Try help there and help <command>
+  to find out about additionally commands of zopectl. These commands
+  work also on command line.
 
-  There is also an interactive Zope command shell named 'zopectl' that
-  may be invoked by running 'bin/zopectl'.  By default, 'zopectl
-  start' will start a background process that manages Zope and
-  'zopectl stop' will stop the background process.
+  By default, 'zopectl start' will start a background process that
+  manages Zope and 'zopectl stop' will stop the background process.
 
 Logging In To Zope