Merge remote-tracking branch 'origin/peppe/common_test/remove_old_scripts'

* origin/peppe/common_test/remove_old_scripts:
  Remove obsolete installation scripts and update documentation

OTP-12421

5 files changed, 3 insertions, 181 deletions

diff --git a/lib/common_test/doc/src/install_chapter.xml b/lib/common_test/doc/src/install_chapter.xml
index 7f8c606324..31125b945c 100644
--- a/lib/common_test/doc/src/install_chapter.xml
+++ b/lib/common_test/doc/src/install_chapter.xml
@@ -34,7 +34,7 @@
     <title>General information</title>
 
     <p>The two main interfaces for running tests with Common Test
-      are an executable program named ct_run and an
+      are an executable program named <c>ct_run</c> and an
       erlang module named <c>ct</c>. The ct_run program
       is compiled for the underlying operating system (e.g. Unix/Linux
       or Windows) during the build of the Erlang/OTP system, and is
@@ -43,67 +43,10 @@
       The <c>ct</c> interface functions can be called from the Erlang shell,
       or from any Erlang function, on any supported platform.</p>
 
-    <p>A legacy Bourne shell script - named run_test - exists,
-      which may be manually generated and installed. This script may be used
-      instead of the ct_run program mentioned above, e.g. if the user
-      wishes to modify or customize the Common Test start flags in a simpler
-      way than making changes to the ct_run C program.</p>
-
     <p>The Common Test application is installed with the Erlang/OTP
       system and no additional installation step is required to start using
-      Common Test by means of the ct_run executable program, and/or the interface
-      functions in the <c>ct</c> module. If you wish to use the legacy Bourne
-      shell script version run_test, however, this script needs to be
-      generated first, according to the instructions below.</p>
-
-    <note><p>Before reading on, please note that since Common Test version
-	1.5, the run_test shell script is no longer required for starting
-	tests with Common Test from the OS command line. The ct_run
-	program (descibed above) is the new recommended command line interface
-	for Common Test. The shell script exists mainly for legacy reasons and
-	may not be updated in future releases of Common Test. It may even be removed.
-    </p></note>
-
-    <p>Optional step to generate a shell script for starting Common Test:</p>
-    <p>To generate the run_test shell script, navigate to the
-      <c><![CDATA[common_test-<vsn>]]></c> directory, located among the other
-      OTP applications (under the OTP lib directory). Here execute the
-      <c>install.sh</c> script with argument <c>local</c>:</p>
-
-    <p><c>
-	$ ./install.sh local
-    </c></p>
-    
-    <p>This generates the executable run_test script in the
-      <c><![CDATA[common_test-<vsn>/priv/bin]]></c> directory. The script
-      will include absolute paths to the Common Test and Test Server
-      application directories, so it's possible to copy or move the script to
-      a different location on the file system, if desired, without having to
-      update it. It's of course possible to leave the script under the
-      <c>priv/bin</c> directory and update the PATH variable accordingly (or
-      create a link or alias to it).</p>
-
-    <p>If you, for any reason, have copied Common Test and Test Server
-      to a different location than the default OTP lib directory, you can
-      generate a run_test script with a different top level directory,
-      simply by specifying the directory, instead of <c>local</c>, when running
-      <c>install.sh</c>. Example:</p>
-
-    <p><c>
-	$ install.sh /usr/local/test_tools
-    </c></p>
-
-    <p>Note that the <c><![CDATA[common_test-<vsn>]]></c> and
-      <c><![CDATA[test_server-<vsn>]]></c> directories must be located under the
-      same top directory. Note also that the install script does not copy files
-      or update environment variables. It only generates the run_test
-      script.</p>
-    
-    <p>Whenever you install a new version of Erlang/OTP, the run_test
-      script needs to be regenerated, or updated manually with new directory names
-      (new version numbers), for it to "see" the latest Common Test and Test Server
-      versions.</p>
-
+      Common Test by means of the <c>ct_run</c> executable program, and/or
+      the interface functions in the <c>ct</c> module.</p>
     </section>
 </chapter>
 
diff --git a/lib/common_test/install.sh.in b/lib/common_test/install.sh.in
deleted file mode 100644
index 5108c7a259..0000000000
--- a/lib/common_test/install.sh.in
+++ /dev/null
@@ -1,53 +0,0 @@
-#!/bin/sh
-
-CT_ROOT=$1
-CT_VSN=@CT_VSN@
-TS_VSN=@TS_VSN@
-
-if [ -z "$CT_ROOT" ]
-then
-    echo "install.sh: need CT_ROOT (absolute) directory or 'local' as argument"
-    exit 1
-fi
-
-if [ $CT_ROOT = "local" ]
-then
-    CT_DIR=`pwd`
-    cd priv
-    sed -e "s,@CTPATH@,$CT_DIR/ebin," \
-        -e "s,@TSPATH@,$CT_DIR/../test_server/ebin," \
-	run_test.in > bin/run_test
-    chmod 775 bin/run_test
-    echo "install successful, start script created in " $CT_ROOT/common_test-$CT_VSN/priv/bin
-else
-
-    if [ ! -d "$CT_ROOT" ]
-    then
-	echo "install.sh: CT_ROOT argument must be a valid directory"
-	exit 1
-    fi
-
-    if [ `echo $CT_ROOT | awk '{ print substr($1,1,1) }'` != "/" ]
-    then
-	echo "install.sh: need an absolute path to CT_ROOT"
-	exit 1
-    fi
-
-    if [ ! -d $CT_ROOT/common_test-$CT_VSN ]
-    then
-	echo "install.sh: The directory $CT_ROOT/common_test-$CT_VSN does not exist"
-	exit 1
-    fi
-
-    if [ -d $CT_ROOT/common_test-$CT_VSN/priv ]
-    then
-	cd $CT_ROOT/common_test-$CT_VSN/priv
-	sed -e "s;@CTPATH@;$CT_ROOT/common_test-$CT_VSN/ebin;" \
-	    -e "s;@TSPATH@;$CT_ROOT/test_server-$TS_VSN/ebin;" \
-	    run_test.in > bin/run_test
-	chmod 775 bin/run_test
-	echo "install successful, start script created in " $CT_ROOT/common_test-$CT_VSN/priv/bin
-    fi
-fi
-
-
diff --git a/lib/common_test/priv/Makefile.in b/lib/common_test/priv/Makefile.in
index 1bc6b82ebb..7765b06f95 100644
--- a/lib/common_test/priv/Makefile.in
+++ b/lib/common_test/priv/Makefile.in
@@ -66,12 +66,7 @@ JS = jquery-latest.js jquery.tablesorter.min.js
 # Rules
 #
 
-include ../../test_server/vsn.mk
 debug opt:
-	$(V_at)sed -e 's;@CT_VSN@;$(VSN);' \
-            -e 's;@TS_VSN@;$(TEST_SERVER_VSN);' \
-            ../install.sh.in > install.sh
-	- $(V_at)chmod -f 775 install.sh
 
 docs:
 
diff --git a/lib/common_test/priv/bin/.gitignore b/lib/common_test/priv/bin/.gitignore
deleted file mode 100644
index e69de29bb2..0000000000
--- a/lib/common_test/priv/bin/.gitignore
+++ /dev/null
diff --git a/lib/common_test/priv/run_test.in b/lib/common_test/priv/run_test.in
deleted file mode 100644
index 1508751e4f..0000000000
--- a/lib/common_test/priv/run_test.in
+++ /dev/null
@@ -1,63 +0,0 @@
-#!/bin/sh 
-
-args=""
-
-while [ $1 ]; do
-    if [ $1 = "-config" ]; then
-	args="$args -ct_config";
-    elif [ $1 = "-decrypt_key" ]; then
-	args="$args -ct_decrypt_key";
-    elif [ $1 = "-decrypt_file" ]; then
-	args="$args -ct_decrypt_file";
-    elif [ $1 = "-vts" ]; then
-	vts=1;
-	args="$args $1";
-    elif [ $1 = "-browser" ]; then
-	browser=$2;
-	args="$args $1";
-    elif [ $1 = "-shell" ]; then
-	shell=1;
-	args="$args $1";
-    elif [ $1 = "-ctname" ]; then
-	ctname=$2;
-	args="$args";
-    elif [ $1 = "-ctmaster" ]; then
-	master=1;
-	args="$args";
-    else
-	args="$args $1"
-    fi
-    shift
-done
-
-if [ $vts ]; then
-    erl -sname ct \
-	-pa @CTPATH@ \
-	-pa @TSPATH@ \
-	-s webtool script_start vts $browser \
-	-s ct_run script_start \
-	$args;
-elif [ $shell ]; then
-    erl -sname ct \
-	-pa @CTPATH@ \
-	-pa @TSPATH@ \
-	-s ct_run script_start \
-	$args;
-elif [ $ctname ]; then
-    erl -sname $ctname \
-	-pa @CTPATH@ \
-	-pa @TSPATH@ \
-	$args;
-elif [ $master ]; then
-    erl -sname ct_master \
-	-pa @CTPATH@ \
-	-pa @TSPATH@ \
-	$args;
-else
-    erl -sname ct \
-	-pa @CTPATH@ \
-	-pa @TSPATH@ \
-	-s ct_run script_start \
-	-s erlang halt \
-	$args
-fi