MANY obsolete descriptions in INSTALL

[Norihiko Murase]

Hi, develop members:


When I read the document INSTALL in order to install
OpenSSH-3.7.1p1, I noticed that MANY obsolete descriptions
do remain still now.

(1) The configure options '--with-kerberos4' and
    '--with-afs' were obsoleted because Kerberos IV support
    and AFS support were removed; however the descriptions
    remain still now.
(2) The configure option '--with-kerberos5' for Kerberos V
    support is missing.
(3) The configure option '--with-ipv4-default' was
    obsoleted; however the description remains in the
    document Ver.1.56. (It is deleted in Ver.1.58, which is
    attached to snapshot-20030921.)
(4) The option '--enable-gnome-askpass' is not described in
    the output of "configure --help". If this option had
    been already obsoleted, the description in INSTALL
    should be deleted, too.
(5) CFLAGS="-a" LDFLAGS="-s" LIBS="-lx" ./configure
    is equivalent to
    ./configure --with-cflags="-a" --with-ldflags="-s" --with-libs="-lx"


The following is the patch against *Ver.1.58* for solving
the above problems (1), (2), (4), and (5).

---(cut here)---
--- INSTALL_1.58	Fri Sep 19 07:05:24 2003
+++ INSTALL	Mon Sep 22 17:53:45 2003
@@ -104,8 +104,4 @@
 --with-pam enables PAM support.
 
---enable-gnome-askpass will build the GNOME passphrase dialog. You
-need a working installation of GNOME, including the development
-headers, for this to work.
-
 --with-prngd-socket=/some/file allows you to enable EGD or PRNGD 
 support and to specify a PRNGd socket. Use this if your Unix lacks 
@@ -127,14 +123,9 @@
 Integration Architecture.  The default for OSF1 machines is enable.
 
---with-kerberos4=PATH will enable Kerberos IV support. You will need
+--with-kerberos5=PATH will enable Kerberos V support. You will need
 to have the Kerberos libraries and header files installed for this
 to work. Use the optional PATH argument to specify the root of your
 Kerberos installation.
 
---with-afs=PATH will enable AFS support. You will need to have the
-Kerberos IV and the AFS libraries and header files installed for this
-to work.  Use the optional PATH argument to specify the root of your
-AFS installation. AFS requires Kerberos support to be enabled.
-
 --with-skey=PATH will enable S/Key one time password support. You will 
 need the S/Key libraries and header files installed for this to work.
@@ -175,6 +166,14 @@
 can specify these as environment variables before running ./configure.
 For example:
-
-CFLAGS="-O -m486" LDFLAGS="-s" LIBS="-lrubbish" LD="/usr/foo/ld" ./configure
+  CFLAGS="-O -m486" LDFLAGS="-s" LIBS="-lrubbish" ./configure
+Also, you can do as the values of the options to the configure script.
+For example:
+  ./configure --with-cflags="-O -m486" \
+              --with-ldflags="-s"      \
+              --with-libs="-lrubbish"
+
+The entire list of the options to the configure script is available
+from the output of
+  ./configure --help
 
 3. Configuration
---(cut here)---
# The new version in which the above patch is applied is
# defined as 1.59 in the below...


It may be better for the order of the options mentioned in
the INSTALL document to correspond with that of the output
of './configure --help'. I put the new version (1.60) at
http://skeleten.shillest.net/tmp/INSTALL_1.60

# 1.58: The version attached in snapshot-20030921
# 1.59: The above patch was applied against 1.58
# 1.60: The same orders (changed from 1.59)


I hope the INSTALL document is updated before the new release.


---
Norihiko Murase <skeleten at shillest.net>