Fixed debugapp help messages; mention that DESIGN is an old document

git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/tools/make/trunk@24976 72102866-910b-0410-8b05-ffd578937521

ChangeLog

@@ -1,3 +1,17 @@
+2007-04-10  Nicola Pero  <nicola.pero@meta-innovation.com>
+
+	Fixed help messages for debugapp to display 'debugapp' instead of
+	'openapp' as program name.
+	* openapp.in: Use $0 instead of openapp as program name in help
+	messages.  In the help message mention that debugapp is equivalent
+	to openapp --debug.
+	* debugapp: Use source, not exec, to pass control to openapp while
+	still preserving $0.  (openapp_debug_mode): Set this variable to
+	turn on debug mode inside openapp.
+
+	* Documentation/DESIGN: Mention that this is mostly a historical
+	document now.
+	
 2007-04-10  Nicola Pero  <nicola.pero@meta-innovation.com>
 
 	* Instance/framework.make (xxx.framework/GNUSTEP_TARGET_LDIR/xxx):

Documentation/DESIGN

@@ -1,5 +1,7 @@
+[Important: this is mostly a historical document.]
+
 A makefile package for the GNUstep environment
-================================================================
+==============================================
 
 This document presents a makefile package for the GNUstep
 environment. It describes what are the goals the GNUstep environment

debugapp

@@ -20,4 +20,13 @@
 
 # debugapp is now a wrapper over 'openapp'.
 
-exec openapp --debug "$@"
+# To pass control to openapp we use 'source' here, instead of 'exec',
+# because we want the help messages to display 'debugapp' as the
+# application name instead of 'openapp'.
+
+# Set debug mode
+openapp_debug_mode=yes;
+
+# Source openapp
+. openapp
+

openapp.in

@@ -21,9 +21,6 @@
 # If not, write to the Free Software Foundation,
 # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 
-# FIXME - fix the help message to mention 'debugapp' and not 'openapp'
-# if we were called as 'debugapp'.
-
 # Please note that all local variables are prefixed with 'openapp_' to
 # avoid conflicts.
 
@@ -35,14 +32,11 @@
 # (originally we had a separate script, called debugapp, for that).
 
 if [ -z "$1" ]; then
-  echo "usage: openapp [--find] [--debug] application [arguments...]"
-  echo "openapp --help for more help"
+  echo "usage: `basename "$0"` [--find] [--debug] application [arguments...]"
+  echo "`basename "$0"` --help for more help"
   exit 1
 fi
 
-openapp_only_find=
-openapp_debug_mode=
-
 # Here read all the --find/--debug/--help/etc arguments, up to the
 # first non-argument.  That one is the name of the application we want
 # to launch.  We leave any parameters after the app name unchanged so
@@ -51,7 +45,7 @@ openapp_debug_mode=
 while [ x"$1" != x ]; do
   case "$1" in
   --help)
-    echo "usage: openapp [--find] [--debug] application [arguments...]"
+    echo "usage: `basename "$0"` [--find] [--debug] application [arguments...]"
     echo
     echo "application is the complete or relative name of the application"
     echo "program with or without the .app extension, like Ink.app."
@@ -70,6 +64,8 @@ while [ x"$1" != x ]; do
     echo "in non-flattened (advanced/non standard) setups to start up"
     echo "the application using a specified library-combo."
     echo
+    echo "Invoking this program as 'debugapp' is equivalent to using the --debug"
+    echo "option."
     exit 0
     ;;
   --find)
@@ -80,6 +76,8 @@ while [ x"$1" != x ]; do
     fi
     shift;;
   --debug)
+    # debugapp manually sets this variable before invoking openapp.
+    # So if you change this, make sure to update debugapp too.
     openapp_debug_mode=yes;
     if [ -z "$2" ]; then
       echo "Missing application name.  Please try openapp --help for more help."