docs/59240: handbook update: linux MATLAB

[Dan Pelleg]

>Number:         59240
>Category:       docs
>Synopsis:       handbook update: linux MATLAB
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          maintainer-update
>Submitter-Id:   current-users
>Arrival-Date:   Wed Nov 12 17:00:36 PST 2003
>Closed-Date:
>Last-Modified:
>Originator:     Dan Pelleg
>Release:        FreeBSD 4.9-STABLE i386
>Organization:
>Environment:

	
>Description:
Exit script to solve a problem of unquittable MATLAB. Contributed
by Richard Winkel.
	
>How-To-Repeat:
	
>Fix:


--- en_US.ISO8859-1/books/handbook/linuxemu/chapter.sgml.orig	Wed Nov 12 18:11:54 2003
+++ en_US.ISO8859-1/books/handbook/linuxemu/chapter.sgml	Wed Nov 12 19:30:21 2003
@@ -859,21 +859,52 @@
       </tip>
     </sect2>
 
+    <sect2>
+      <title>Creating a &matlab; Shutdown Script</title>
+
+      <para> The following is needed to solve a problem with &matlab
+        not exiting correctly.</para>
+
+      <procedure>
+	<step>
+	  <para>Create a file
+            <filename>$MATLAB/toolbox/local/finish.m</filename>, and 
+            in it put the single line:</para>
+
+	  <programlisting>! $MATLAB/bin/finish.sh</programlisting>
+
+          <note><para>The $MATLAB is literal.</para></note>
+
+          <tip><para>In the same directory, you will find the files
+              <filename>finishsav.m</filename> and
+              <filename>finishdlg.m</filename>, which let you save
+              your workspace before quitting. If you use either of
+              them, insert the line above immediately after the "save"
+              command.</para></tip>
+    </step>
+    <step>
+	  <para>Create a file
+            <filename>$MATLAB/bin/finish.sh</filename>, which will
+            contain the following:</para>
+
+	  <programlisting>#!/usr/compat/linux/bin/sh
+(sleep 5; killall -1 matlab_helper) &
+exit 0</programlisting>
+    </step>
+    <step>
+	    <para>Make the file executable:</para>
+
+	    <screen>&prompt.root; <userinput>chmod +x $MATLAB/bin/finish.sh</userinput></screen>
+
+    </step>
+      </procedure>
+    </sect2>
+
     <sect2 id="matlab-using">
       <title>Using &matlab;</title>
 
       <para>At this point you are ready to type
-	<command>matlab</command> and start using it.  Note that the
-	version of <application>&java;</application> shipped with
-	<application>&matlab;</application> does not work well under
-	&os;.  It will make it hard to quit
-	<application>&matlab;</application> and you will have to
-	<command>kill -9</command> it.  If you do not  use
-	<application>&java;</application> at all, you can avoid this
-	nuisance by starting
-	<application>&matlab;</application> with the
-	<option>-nojvm</option>
-	switch.</para>
+	<command>matlab</command> and start using it.</para>
     </sect2>
   </sect1>
 

>Release-Note:
>Audit-Trail:
>Unformatted: