Remove
Pierre Marechal [Fri, 29 Aug 2008 13:09:25 +0000 (13:09 +0000)]
 - loaddefaultbrowser() macro
 - %browsehelp global variable

scilab/CHANGES
scilab/etc/scilab.start
scilab/modules/helptools/help/en_US/apropos.xml
scilab/modules/helptools/help/en_US/help.xml
scilab/modules/helptools/help/fr_FR/apropos.xml
scilab/modules/helptools/help/fr_FR/help.xml
scilab/modules/helptools/macros/gethelpfile.sci
scilab/modules/helptools/macros/loaddefaultbrowser.sci [deleted file]
scilab/modules/helptools/macros/make_help_index.sci

index 09c6b7f..d03cee9 100644 (file)
@@ -292,6 +292,8 @@ Online Help management:
        + xmltops
        + xmltochm
  - xmltohtml function is now deprecated
+ - loaddefaultbrowser function and %browsehelp global variable have been removed :
+   The new Java help browser is the only help browser.
  - For more information, have a look to :
     + http://wiki.scilab.org/howto/scilab_documentation_kit
     + SCI/modules/helptools/doc directory
index 8e8da51..073277f 100644 (file)
@@ -93,12 +93,6 @@ else
 end
 setenv("VERSION",getversion())
 
-
-// Set the preferred browser  ==========================================
-global %browsehelp
-%browsehelp=loaddefaultbrowser();
-clear %browsehelp with_tk with_gtk loaddefaultbrowser  pathconvert//remove the local variable
-
 // Protect variable previously defined  ================================
 predef('all')
 
index 7886c29..12b48a9 100644 (file)
@@ -45,27 +45,19 @@ apropos(regexp)</synopsis>
     <title>Description</title>
     <para><literal>apropos(key)</literal> looks for Scilab help files containing
       keywords <literal>key</literal>in their short description section.</para>
-    <para>With Scilab Browser only, <literal>apropos(regexp)</literal> looks for Scilab
+    <para><literal>apropos(regexp)</literal> looks for Scilab
       help files containing regular expression  <literal>regexp</literal>in their short
       description section.</para>
   </refsection>
   <refsection>
     <title>Examples</title>
     <programlisting role="example"><![CDATA[
-
 apropos('ode')
 apropos ode 
 apropos "list of"
-
-//next only for Scilab Browser
-global %browsehelp;%browsehelp_save=%browsehelp;%browsehelp="Scilab Browser";
-
 apropos "sin.*hyperbolic"
 apropos "^ab"  //search help beginning the two characters "ab"
 apropos "quadratic.*solver"
-
-%browsehelp=%browsehelp_save;
   ]]></programlisting>
   </refsection>
   <refsection>
index 86ed23e..1114c92 100644 (file)
@@ -41,16 +41,6 @@ help</synopsis>
     <para><literal>help(key)</literal> displays the Scilab help file associated with the
       given  <literal>key</literal>. If no help file is found, <literal>help(key)</literal>
       automatically call <literal>apropos(key)</literal>.</para>
-    <para> Scilab includes its own simple browser written in TCL/TK. It is possible to choose an other one.
-    The global variable <literal>%browsehelp</literal> contains a string defining which browser 
-      must be used: its value may be changed (or redefined in your startup files : SCIHOME/.scilab or SCIHOME/scilab.ini). Note that when you 
-      enter an <literal>help</literal> command while <literal>%browsehelp</literal> contains the empty matrix
-      <literal>[]</literal> then the different browser choice possibilities are
-      displayed (so that you can enter the 2 instructions:
-      <literal>global  %browsehelp; %browsehelp=[]</literal> for changing of browser !). 
-      As generally different browsers have differents calling sequences, if
-      your favorite one is not in the list you may  have to adapt the <literal>browsehelp</literal> scilab 
-         which can be found in <literal>SCI/modules/helptools/macros/apropos.sci</literal>.</para>
     <para> See  <link linkend="man">man</link> for more explanation on how to write new help
       pages .</para>
   </refsection>
index 1989fc6..3bbacf8 100644 (file)
@@ -45,7 +45,7 @@ apropos(regexp)</synopsis>
     <title>Description</title>
     <para><literal>apropos(key)</literal> recherche les pages d'aides contenant la
       séquence de caractères <literal>key</literal> dans leur section "SHORT_DESCRIPTION".</para>
-    <para>Avec le "Browser Scilab" uniquement , <literal>apropos(regexp)</literal>
+    <para><literal>apropos(regexp)</literal>
       recherche les pages d'aides contenant l'expression régulière donnée par
       <literal>regexp</literal> dans leur section "SHORT_DESCRIPTION".</para>
   </refsection>
@@ -55,16 +55,9 @@ apropos(regexp)</synopsis>
 apropos('ode')
 apropos ode 
 apropos "list of"
-
-// la suite ne fonction qu'avec le browser "Browser Scilab"
-global %browsehelp;%browsehelp_save=%browsehelp;%browsehelp="Scilab Browser";
-
 apropos "sin.*hyperbolique"
 apropos "^ab"  //rechercher les pages d'aide dont le nom commence par les deux caractères "ab"
 apropos "quadratic.*solver"
-
-%browsehelp=%browsehelp_save;
-
  ]]></programlisting>
   </refsection>
   <refsection>
index 95d8546..66c7362 100644 (file)
     <para><literal>help(key)</literal> visualise la page d'aide associé avec le nom
       donné par <literal>key</literal>. S'il n'y a pas de page d'aide, <literal>help(key)</literal>
       appele automatiquement <literal>apropos(key)</literal>.</para>
-    <para> Scilab comprend son propre browser html écrit en  TCL/TK. Il est
-      possible de choisir un autre browser. La variable globale
-      <literal>%browsehelp</literal> contient une chaîne de caractères définissant
-      quel browser doit être utilisé. Sa valeur initiale est fixée par le
-      fichier startup <literal>scilab.start</literal> est peut être changée. </para>
-    <para>Si cette variable est affectée à la matrice vide ( <literal>global
-       %browsehelp; %browsehelp=[]</literal>) alors une fenêtre de dialogue
-      apparait au lancement du help et permet de  choisir le browser
-      désiré. Attention, les differents browsers on des syntaxes d'appel
-      différentes. Aussi si vous souhaitez ajouter un nouveau browser à la
-      liste vous devrez modifier la fonction Scilab <literal>browsehelp</literal>
-         dont le code source est dans  <literal>SCI/modules/helptools/macros/apropos.sci</literal>.</para>
     <para> Voir  <link linkend="man">man</link> pour apprendre à écrire de nouvelles pages d'aide.</para>
   </refsection>
   <refsection>
index 2a7ebb6..438b7b9 100644 (file)
@@ -10,7 +10,7 @@
 
 function path=gethelpfile(key)
        // copy of gethelpfile contained in help.sci
-       global %helps %browsehelp
+       global %helps
        global %helps_modules
   %HELPS=[%helps_modules;%helps];
        sep="/";
diff --git a/scilab/modules/helptools/macros/loaddefaultbrowser.sci b/scilab/modules/helptools/macros/loaddefaultbrowser.sci
deleted file mode 100644 (file)
index f3d0e44..0000000
+++ /dev/null
@@ -1,44 +0,0 @@
-
-// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
-// Copyright (C) 2005-2008 - INRIA - Allan CORNET <allan.cornet@inria.fr>
-//
-// This file must be used under the terms of the CeCILL.
-// This source file is licensed as described in the file COPYING, which
-// you should have received as part of this distribution.  The terms
-// are also available at
-// http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
-
-function DefaultBrowser=loaddefaultbrowser()
-
-  if MSDOS then
-    FileBrowser=SCIHOME+"\Browser.ini";
-  else
-    FileBrowser=SCIHOME+"/Browser.ini";
-  end
-  if with_tk() then Default="Scilab Browser",else Default=[],end
-
-  [fd,err]=mopen(FileBrowser,"r");
-  if (err<0) then //ini file does not exist
-    DefaultBrowser=Default
-  else //ini file  exist
-    DefaultBrowser=mgetl(fd,1);
-    if MSDOS then
-      KnownBrowsers=['Default Windows Browser';'Scilab Browser';
-                    'Old Scilab Browser']
-    else
-      KnownBrowsers=['Scilab Browser';'Old Scilab Browser';'nautilus';
-                    'mozilla/netscape (gnome-moz-remote)';'opera';
-                    'quanta (kde)']
-    end
-    if ~or(DefaultBrowser==KnownBrowsers) then 
-      //invalid DefaultBrowser in Browser.ini
-      DefaultBrowser=Default
-    else
-      if DefaultBrowser=='Scilab Browser' & ~with_tk() then
-       //DefaultBrowser in Browser.ini does not apply to current scilab
-       DefaultBrowser=Default
-      end
-    end
-    mclose(fd);
-  end
-endfunction
index a5730fd..f294531 100644 (file)
@@ -1,4 +1,3 @@
-
 // Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
 // Copyright (C) 2008 - INRIA
 //
@@ -9,34 +8,27 @@
 // http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
 
 function path=make_help_index()
-//we create a new index file each time to take into account dynamically
-//loaded toolboxes
-
-  OSseparator=filesep(); 
-  
-  global %helps
-  global %helps_modules
-  %HELPS=[%helps_modules;%helps];
-  path=TMPDIR+OSseparator+"index.htm";
-  
-  i_lines=["<html>";
-        "<head>";
-        "  <meta http-equiv=""Content-Type"" content=""text/html; charset=ISO-8859-1"">";
-        "    <title>Index</title>";
-        "</head>";
-        "<body bgcolor=""FFFFFF"">";]
-  global %browsehelp
-  if %browsehelp == "Old Scilab Browser" then
-       // Scilab Browser
-       i_lines=[i_lines;
-               "<BR><A HREF="""+%HELPS(:,1)+OSseparator+"whatis.htm"">"+%HELPS(:,2)+"</A>";
-               "</body></html>"]
-       else
-                       // Default Internet Browser IE,Mozilla, Opera,Nautilus
-                       i_lines=[i_lines;
-                       "<BR><A HREF=""file:///"+%HELPS(:,1)+OSseparator+"whatis.htm"">"+%HELPS(:,2)+"</A>";
+       
+       //we create a new index file each time to take into account dynamically
+       //loaded toolboxes
+       
+       global %helps
+       global %helps_modules;
+       %HELPS=[%helps_modules;%helps];
+       
+       path = TMPDIR+filesep()+"index.htm";
+       
+       i_lines=["<html>";
+               "<head>";
+               "  <meta http-equiv=""Content-Type"" content=""text/html; charset=ISO-8859-1"">";
+               "    <title>Index</title>";
+               "</head>";
+               "<body bgcolor=""FFFFFF"">";]
+               // Default Browser
+               i_lines=[i_lines;
+                       "<BR><A HREF=""file:///"+%HELPS(:,1)+filesep()+"whatis.htm"">"+%HELPS(:,2)+"</A>";
                        "</body></html>"]
-       end
-  clear %browsehelp    OSseparator
-  mputl(i_lines,path)
+       
+       mputl(i_lines,path);
+       
 endfunction