[Picture]

CD Rosetta for Windows User's Guide

Michel Lavaud - CNRS and Orléans Univ.

Multi-files version, for fast displayBack to main web page of AsTeX Association

English  Francais


1 Introduction
2 Installation
3 Installation Tests
4 Starter guide of the CD-ROM
5 Tips and tricks
6 Technical References
7 Toolbars of the Alg-1 group
8 Toolbars of the Alg-2 group
9 Toolbars of the Alg-3 group
10 Troubleshooting
11 History

End of manual
Last update on May 11, 2003, at 1h 54, by Michel Lavaud

To download the document CD Rosetta for Windows User's Guide (1621Kb), click here.


 

Chapter 1 Introduction 

The goal of the Rosetta CDs is to permit the comparison of the existing various free programs of computer algebra, while launching the programs to be tested directly from the CD, without having to install them beforehand on the hard disk. There are two versions of the CD Rosetta: one for Linux and one for Windows. The version for Linux has been achieved by Tim Daly, the version for Windows by Michel Lavaud. Both CD-ROMs can be ordered through AsTeX association, or downloaded on the net under compressed iso form, then burnt. Further explanations to uncompress and to burn them are given in section 2.1.

This chapter contains a brief introduction to the CD Rosetta for Windows. If you have a copy of it and in a hurry to install it and to test it, you can go directly to section 2.3.

1.1 Warning 

Please note that this work is in progress. This means that  : All commentaries, corrections, propositions of improvements and/or of additions are welcome.

1.2 Updates 

For not to delay too much the diffusion of the first version of the Rosetta CD-ROM for Windows, the necessary verifications, with regard to the buttons of assistant AsTeX for Rosetta, have not all been made exhaustively. These verifications are indeed very numerous, because they must not only be done for all programs of computer algebra systems present on the CD-ROM (Calc, CoCoA, Gap, Giac, Jacal, Macaulay, Maxima, MuPAD Studio, Pari, Singular and Yacas) but also for all versions of Windows 9x (95/98/ME) and NTx (4.0/2000/XP), and for all types of command windows used (command.com for Win9x and WinNTx, cmd.exe for WinNTx, %COMSPEC% for the shell of Emacs). Corrections will be uploaded on the ftp server of AsTeX association and announced on its web server.

More generally, updates of the Rosetta CD-ROM for Windows will be uploaded also on the ftp server, and their availability will be announced on the web server and on a few discussion lists (astex, oscas, calcul-formel-libre. . . ).

1.3 Generalities about the Rosetta CDs 

The first idea was to make an unique CD, usable as well under Linux as under Windows, with a maximum number of files in common. It was not possible, for reasons of size: the version for Linux occupies a complete CD. In fact, it would not have been possible either, at least in a first step, for technical reasons: first of all, some CAS (computer algebra systems) exist under Linux but not under Windows, and vice versa. For example, Aldor is only available under Linux and MuPAD Studio under Windows. Then, some software are available in different versions depending on the OS (operating system). For example, Maxima, in the original distribution of W. Schelter, is available in the version 5.6 for Linux and in the version 5.5 for Windows. At last, even when a software is available in the same version under the two OS, some files differ by the date and/or the size, so that it is not easy to know if the differences are about the contents (different versions of files depending to the OS) or only on the form (use of CR+LF as separator of lines under Windows, and use of LF under Linux). The possibility to achieve a common directory structure usable at the same time under Linux and Windows, is therefore a long-term objective.

Another important difference between the version for Windows and the version for Linux of the CD Rosetta comes from the fact that most Linux distributions contain Emacs, Xemacs, TeX, Xdvi, Ghostscript and the standard GNU utilities, so that these programs are not included in the CD Rosetta for Linux. These software are indispensable to a lot of CAS to edit (Emacs, Xemacs) the programs written in their programming language and to visualize (TeX, Xdvi, Ghostscript) the resulting mathematical formulas. As they are not distributed with Windows, they have been added to the CD Rosetta for Windows. They have been borrowed to the AsTeX distribution.

A last difference comes from the fact that the sources of the programs have not been included in the version for Windows, insofar as they are already included in the version for Linux. The latter having been recorded with the extensions Rock Ridge and Joliet, the users of Windows should be able to read most Unix long file names correctly on the Cd Rosetta for Linux. However, no verification has been made that all the names of the source files are seen identically under Windows and Linux, nor that the binaries for Windows can be constructed from these sources.

For the future, it would be desirable to make converge the versions for Linux and Windows so that, when they are installed on the hard disk of a PC with dual boot (i.e. that can function under Linux and Windows) they can share a maximum of files and therefore occupy a minimum of room on the hard disk. Of course, it will be possible to do that only in collaboration with the authors of the software included on the CD.

1.4 Contents of the CD Rosetta for Windows 

The programs of computer algebra installed on the Rosetta CD-ROM for Windows are Gnu-Calc, CoCoA, Gap, Giac, Jacal, Macaulay, Maxima, MuPAD Studio, Pari, Singular and Yacas.

The CD-ROM also contains the programs Emacs for the edition of documents, the Cygwin utilities, for the execution of programs of Unix origin ported under Windows, two virtual desktop managers (VirtuaWin and JS Pager), a manager of processes for Windows 9x (Sinfo), GhostScript and Gsview for the visualization of PostScript files, Acrobat Reader for pdf files, the web browser Netscape Navigator, for html files, and partial copies of web sites to be able to consult these sites from the CD-ROM, without connection to Internet. It finally contains assistant AsTeX, which permits to launch all these programs from an unique and customizable interface, and AsTeX navigator that permits to navigate in the dvi, ps or pdf versions of the documentations from a common interface. The dvi versions can be displayed directly if the AsTeX distribution is installed already, otherwise it is necessary to install at least the part View/Print of the distribution.

1.5 Required Configuration 

The CD Rosetta for Windows can be installed on all PC equipped with Windows 9x (95/98/ME) or NTx (4.0/2000/XP). However, the computer algebra software being often brought to stock some intermediate results of very large size in memory, it is recommended to have more RAM that the minimum required for the working of the OS, in order to avoid as much as possible swapping between the physical memory (RAM) and the virtual memory (hard disk) that can slow down a lot the calculations.

1.6 Typographic Conventions 

Les conventions de notation adoptées pour les versions imprimées de ce manuel et pour les versions affichables aux formats dvi, ps et pdf, sont les suivantes:

Élément de texte Signification
télétype minuscule Nom de fichier, texte tapé par l'utilisateur, nom de module téléchargeable à partir de la version HTML du manuel.
télétype petits caractères Recopie d'écran (messages du système, menus).
TÉLÉTYPE MAJUSCULE Variable d'environnement.
sans sérif Nom de touche, option de menu, nom de bouton d'une bo^ite de dialogue ou de message, titre de fenêtre.
Nom de bouton d'un panneau de l'assistant.
italique Nom de manuel, de chapitre ou de section ; variable à remplacer par une valeur d'une liste.
gras Titre de chapitre, de section ou de tableau du manuel ; indique que la version HTML du manuel contient un lien actif vers un site web.
(mod. jj/mm/aa) Indique une section modifiée depuis la version précédente du manuel. jj/mm/aa symbolise la date de la dernière modification, dans l'ordre jour, mois, année (2 chiffres avant l'an 2000, 4 chiffres après).

Dans la version HTML de ce manuel, les caractères sans sérif sont remplacés par des caractères gras, et les boutons des panneaux de l'assistant sont affichés en vert, au lieu d'être encadrés.

 

Chapter 2 Installation 

This chapter explains how to get a CD-ROM Rosetta for Windows, and how to install it.

2.1 Getting a CD-ROM 

You can get a copy of the CD-ROM Rosetta in two ways:
  1.  By ordering it through the AsTeX association.
  2.  By downloading the files rosetta4windows1_0c.iso.bz2 and bunzip2.exe from the directory rosetta on the ftp server of Orleans University.
If you got a CD-ROM through the AsTEX association, you can go to the next section. If you downloaded the compressed image of the CD-ROM from the ftp server, you have then:
  1.  To verify that the compressed image of the CD-ROM has been downloaded without error. To this end, open a command window and type, from the directory where the files have been downloaded:
    bunzip2 -t rosetta4windows1_0c.iso.bz2
  2.  To expand the image by typing the same line as above but by omitting the option -t:
    rosetta4windows1_0c.iso.bz2 bunzip2
    Attention, room occupied on disk rises from 200 Mo to 700 Mo.
  3.  To burn a CD-ROM (Note : It is also possible to mount the iso file with a suitable software, rather than burning a CD-ROM. There is a freeware version for Win9x and NT4, commercial versions for Win2k/XP. If you are networked with a Linux machine running as a Samba server, it is possible to mount the iso file on the server with the command mount.) from the resultant file rosetta4windows1_0c.iso. It can be made under Windows (with the software that comes with your CD recorder) or under Linux (with Cdrecord, or with XOnCD or XCDRoaster, which provide a pleasant interface for Cdrecord).

2.2 Displaying and printing the manual 

The User's Guide of the CD Rosetta for Windows (the present manual) is available on the web site of AsTEX association and on the CD-ROM, under html, dvi, and pdf forms.

If you have not yet installed the CD, you can consult the manual in html form from the Windows Explorer, by clicking on the file alire.htm, under the root of the CD-ROM, then on the link Manuel d'installation et d'utilisation du cdrom Rosetta pour Windows (cf. Fig. 2.1).  


../../../images/rosetta/insros06.gif
Figure 2.1Displaying documentation of the CD-ROM Rosetta for Windows from file alire.htm of the CD-ROM.

If there is no web browser installed on your PC (for ex. if you just installed / reinstalled Windows 95), you can launch Netscape from the CD-ROM, by opening Windows Explorer, and by double-clicking on the file netscape.exe in the directory ast\view\Netscape\Program of the CD-ROM (cf. sec. 4.11.1 for the configuration procedure of Netscape).

The pdf form can be displayed by clicking on the file ast\astex\doc\en\rosetta\src\urosej.pdf of the CD-ROM, if there is a program to display pdf files installed on your PC. Otherwise, you can launch Acrobat Reader from the CD by clicking on the file ast\view\acroread\acrord32.exe.

The manual can be printed from the pdf version, or from the mono-file html version of the online help (cf. Fig. 5.1). The latter is accessible from the table of contents of the ordinary html version, or from Windows Explorer by clicking on the file ast\astex\doc\fr\rosetta\htmla\urosea.htm.

Displaying and printing the manual are much simpler after having installed the CD-ROM: the html version can be displayed from the button Man Util Ros of Assistant Rosetta, and the pdf version from the button Man Util Ros A4 (cf. sec. 3.3.3). A pdf version adapted to consultation on screen can be displayed from the button Man Util Ros cr. . As for Netscape and Acrobat Reader, they can be launched from their icons in the Rosetta filer (cf. Fig. 2.2).

2.3 Installing the CD-ROM 

2.3.1 Target Disk (mod. 08/05/2003) 

The installation program of CD-ROM Rosetta installs only a few configuration files on the hard disk, in the directory defined by the environment variable ASTEXDIR, or if it is not defined, in the directory C:\ast\astex. If this directory is not convenient for you, refer to section 6.6 to see how to modify it.

2.3.2 Source Disk 

With the installation by default, all programs of the Rosetta distribution are launched from the CD-ROM, as the objective is to be able to test them without installing them on the hard disk (cf. chap. 1). However, if you wish to use them intensively and not occasionnely for a few tests, it is possible to launch them from a copy of the CD-ROM on the hard disk. This allows to free your CD-ROM drive and to run programs at full speed (Note : Lauching certain programs from the CD-ROM can be slow, even with supposedly fast CD-ROM drives (30x or more), because these drives are fast when reading one big file (video for example), but not necessarily when reading a large number of small files (this is frequently the case with Computer Algebra Systems).). If you wish to use them in this way and you have enough room on your hard disk, refer to section 6.7 for the installation procedure.

2.3.3 Installation procedure by default (mod. 04/27/2003) 

  1.  Close all your programs that may be opened. If you are under Windows NTx, log in with a user name belonging to groups Administrators or Users with powers (to be authorized to modify the configuration of the computer).
    ../../../images/rosetta/aaccnt01.gif
  2.  Insert the CD-ROM in the CD-ROM drive of your PC. Windows Explorer opens itself automatically under the root of the CD-ROM (Note : If Windows Explorer does not open automatically, launch it and go under the root of the CD-ROM) :
    ../../../images/rosetta/insros16.gif
    Double click on the file install.exe to start installation. A panel is displayed, allowing to select the language that will be used with the CD-ROM Rosetta.
    ../../../images/rosetta/en/insros21.gif
  3.  Choose the required language in the pull-down list and click on the button OK. The welcome page of the installation program is displayed :
    ../../../images/rosetta/en/insros03.gif
  4.  If you don't want your computer to restart at the end of installation, uncheck the slot (Restart the machine):
    ../../../images/rosetta/en/insros04.gif
    In this case, you should restart your PC by hand, so that the installation parameters can be taken in account.
  5.  If you are still hesitating to run the installation, click on Cancel. Otherwise, click on Install. This launches the installation of configuration files on your hard disk and configures your PC for the Rosetta distribution.
    ../../../images/rosetta/en/insros02.gif
  6.  If you didn't uncheck the slot Restart the machine, you are asked if you want to restart now:
    ../../../images/rosetta/en/insros08.gif
    Click on Yes, to restart your PC and be able to use the programs of the CD-ROM. If you click on No, click then on Close to leave the installation program.
  7.  If you unchecked the slot Restart the machine, or if you clicked on No at the preceding step, you are proposed to display the documentation:
    ../../../images/rosetta/en/insros05.gif
    If you click on the button Yes, chapter 3 of the manual (Installation tests) is displayed in your current web browser. When you have finished to read it, restart your PC to be able to run the tests and use the programs of the CD-ROM.
  8.  After restarting, chapter 3 (Installation tests) of the manual is displayed (or redisplayed) in the selected language, to introduce you to the various programs of the CD-ROM and to allow you to check they are correctly installed. Read at least sections 3.1 and 3.2 and run the tests that are described there.
    ../../../images/rosetta/en/insros20.gif

2.4 Description of the new desktop 

The installation program adds an option Rosetta to the menu Start / Programs. This option opens a sub-menu with two options, Assistant Rosetta and Désinstallation Rosetta (Uninstalling Rosetta) :
../../../images/rosetta/insros14.gif
The first option launches the Rosetta Assistant, graphical interface from which you will be able to launch all the programs of the CD-ROM, display the documentations, test and customize your installation, etc. The second option allows to uninstall the Rosetta distribution (cf. sec. 2.5).

The installation program adds also an icon entitled Assistant Rosetta and a filer entitled Rosetta on the desktop :
../../../images/rosetta/insros17.gif
The icon allows to launch Rosetta Assistant, as does the option with the same name. The filer (cf. Fig 2.2) regroups shortcuts to some programs of the distribution, as troubleshooting in the case where the Rosetta assistant would refuse to start at the first attempt.  


../../../images/rosetta/dosros01.gif
Figure 2.2 The icons of the Rosetta filer

It must be noted that the installation program does not add any shortcut to the computer algebra programs of the CD-ROM in the menu Start / Programs of Windows : these programs must be launched from the Rosetta assistant, and are executed from the CD-ROM. The system of menus and the file system of the hard disk are both modified in a minimal way, in accordance with the original requirement (to be able to test the various CAS of the CD-ROM without installing them on the hard disk).

2.5 Uninstallation (mod. 04/27/2003) 

To uninstall the Rosetta distribution, click on option Start / Programs / Rosetta / Dsinstallation Rosetta.
../../../images/rosetta/insros18.gif
As the Rosetta distribution can be installed above an AsTeX installation, the four main environment variables ASTEXBAS, ASTEXDIR, HOME and ROSETBAS are left as they are, as well as the directory structure with root \ast. To uninstall completely Rosetta, one must :
  1.  Remove from the file autoexec.bat the lines that are between rem --- Configuration for Rosetta begins here and rem End of configuration for Rosetta for Windows.
  2.  Remove the environment variable ROSETBAS from the registry database. If the AsTeX distribution was not already installed, remove also ASTEXBAS et ASTEXDIR. At last, remove HOME if this variable is not used by other programs. All these variables are situated under the key HKEY_- CURRENT_USER\Environment for all versions of Windows (from Windows 95 to Windows XP).
  3.  If the AsTeX distribution was not already installed, delete the contents of directory C:\ast from Windows Explorer (or from the directory contained in ASTEXDIR if you defined this variable as indicates in sec. 6.6).
If you installed updates of Windows libraries with the button Ini Navig , il is not necessay to uninstall them : the updates are more recent and thus are supposed to contain bug corrections and additional functions. In case there is a problem, the list of libraries updated can be deduced from the contents of the directory astexdis\navig of the CD-ROM.

2.6 Changing the language (mod. 09/05/2003) 

The texts and comments of the boutons of assistant Rosetta are displayed in the language selected at installation time. To change this language:
  1.  Unistall the distribution with the option Start / Programs / Rosetta / Dsinstallation Rosetta.
  2.  Rerun installation as indicated in sec. 2.3, while selectiong the new language and unchecking the slot Restart the machine in the main page of installation program (it is unnecessary to restart).
The documentations displayed from buttons of the assistant are also displayed in the language selected at installation time, when a version in this language is available.

 

Chapter 3 Installation Tests 

This chapter permits to present the various programs of the CD-ROM and to test their installation.

It is indispensable to make the tests of the sections 3.1 and 3.2 just after the installation, in order to verify that assistant Rosetta and all computer algebra programs function correctly. The other tests can be made subsequently, but it is recommended to have them all made before getting involved in studying in depth one of the CAS (Computer Algebra Systems) of the CD-ROM.

The tests are supposed to be made in the order, and are described as such. If you interrupt them at one moment, the succession of the operations can differ slightly from what is indicated in this manual.

3.1 Test of installation of assistant Rosetta 

As the Assistant Rosetta is playing the role of the menu Start / Programs for the Rosetta distribution (cf.  sec. 2.4), it is necessary to start with verifying whether it is working correctly, by double-clicking on the icon Assistant Rosetta ../../../images/assist/aastex.gif , that has been added on the desktop by the installation program. If the installation ended correctly, you should see appearing a horizontal strip of title Assistant AsTeX (Note : The Assistant AsTeX is a general program that permits to create and to use palettes of tools. The Assistant Rosetta is made of the program Assistant AsTeX and of tool palettes specialized for the Rosetta distribution. For more precisions, cf.  sec. 6.4.)  :
../../../images/rosetta/grpros01.gif
If the assistant's strip is not displayed and that you get an error message (it can happen if you work under an old version of Windows), refer to the section 10.2 to solve the problem, then restart the assistant.

3.2 Test of installation of the computer algebra programs 

If the strip of assistant Rosetta is displayed correctly, the following stage consists in verifying if the computer algebra programs are installed correctly. To this end:
  1.  Click on the ../../../icones/rosetta/calfor01.gif  button in the assistant's strip, to open the associated palette of tools (or toolbar) (cf. Fig. 3.1).
  2.  Click on the button TEST SCF of this toolbar. This opens a command window of Windows in which all programs of computer algebra will be launched successively. Resize and displace this window so that your desktop has more or less the aspect of Fig. 3.1 (modulo the fact that, under Windows 9x, the characters of the command window are displayed in white on a black background, instead of blue on yellow background as on the figure).  
    ../../../images/rosetta/tstros13.gif
    Figure 3.1Launching the test of the computer algebra programs from the button TEST SCF of the toolbar Alg\Calfor01 (Generalities on Computer Algebra), under Windows NTx.

    If the command window is not displayed and that you get an error message, refer to sec.   10.1 to correct it, and restart the test. If the window is displayed, the program of test starts with launching a few configurations (cf. the first two lines of the command window Rosetta, in Fig. 3.1): the computer algebra program Macaulay then, under Windows NTx, the previewer of PostScript files Gsview (Note : Under Windows 9x, the configuration of Gsview doesn't appear at this stage, because it is done during the installation of the CD-ROM. Under Windows NTx, every user can have his own configuration of Gsview, this is why it is made after the installation of the CD-ROM.).

    The computer algebra programs without Graphical User's Interface (GUI) are launched then, starting with CoCoA. For every computer algebra software, the program of test displays the character indicating an end of command, and the command to type to quit the software. For CoCoA, it points out that the character indicating the end of a command is the semicolon, and that the command to quit CoCoA is Quit; or Ctrl-C (cf.  Fig.   3.1).

    For this quick installation test, we will limit ourselves to verify that the addition works, as well as the command to quit the software.

  3.  To verify that installation of CoCoA is correct, type  :
     1+2;
     Quit;
    
  4.  After having typed the commands above, Gap is launched. Attention  : the delay to get the Gap prompt (the chain gap>) is long (1 min on a 200 MHz PC). The commands to be typed to test the installation of Gap and to quit it are:
     1+2;
     quit;
    
  5.  Macaulay, Maxima, Pari, Singular, Yacas and Jacal are then launched. The commands to be typed are indicated in table 3.1. A copy of everything that is displayed during the test is in the file ast\testcas.log\astex of the CD-ROM.  
    ProgramPromptAdditionQuit
    CoCoA 1+2; Quit;
    Gap gap> 1+2; quit;
    Macaulayi1: 1+2 quit
    Maxima (C1) 1+2; quit();
    Pari ? 1+2 quit
    Singular > 1+2; quit;
    Yacas In> 1+2; quit;
    Jacal e0: 1+2; quit();

    Table 3.1 Table of the prompts of the CAS without GUI of the CD-ROM, and of the commands to add 1 and 2 and to quit the software.

  6.  Then the four programs with graphic interfaces are launched , Xmaxima 5.5, Xmaxima 5.9.0, WinCoCoA and Giac. The menu option to select to quit each of them and to pass to the next one is indicated in the last but one column of table 3.2. The last column indicates if it is necessary, under Windows 9x, to close the associated command window also, so that the next program can be launched (under Windows NTx, it is not necessary).  
    Program Addition Quit Next test
    Xmaxima 5.5 1+2;Enter File / exit No
    Xmaxima 5.9.01+2;Enter File / exit No
    WinCoCoA 1+2;Ctrl-EnterFile / quit Yes
    Giac 1+2Enter File / quit Yes

    Table 3.2 Table of prompts of the CAS with GUI of the CD-ROM, and of the commands to add 1 and 2 and to quit the software.

3.3 Test of display and printing of the documentation 

The major part of the documentation of the CD-ROM is available under html and/or pdf form, and can be displayed from buttons of the assistant. The goal of this section is to verify that these buttons are working correctly.

3.3.1 Displaying html documents 

Click on the button Aide générale of the ../../../icones/rosetta/calfor01.gif toolbar  : this should launch the display of the general documentation of the Rosetta CD-ROM in your default web browser (cf.  Fig. 2.1).

If no display appears, maybe no web browser is installed (for ex. if you are under grass-roots Windows 95), or maybe your browser is not coupled to the files with extension htm. In the first case, you can use Netscape from the CD-ROM. To this end, click on the button Netscape of the ../../../icones/rosetta/calfor01.gif toolbar, do the configuration of Netscape as indicated in the sec. 4.11.1, then declare it as the default web browser when the question is asked to you. In the second case, couple the files with extension htm to your web browser by using the usual procedure of Windows.

3.3.2 Displaying pdf documents 

  1.  Close the web browser opened during the previous test, then click on the button Man Util Ros écr. of the ../../../icones/rosetta/calfor01.gif toolbar. This opens the table of navigation of the User's manual of the Rosetta CD-ROM for Windows (the present manual), in the window of Navigator AsTeX.
    ../../../images/rosetta/navros06.gif
    If the window of navigation is not displayed, try to install the required libraries, as indicated in section 10.3.
  2.  Open the pull-down list at the top and on the right of the navigator's window, click then on the element Gsview of the list.  
    ../../../images/rosetta/navros07.gif
    Figure 3.2Selection of GSview to display a manual from its table of navigation.

    This displays the manual in Gsview (cf.  Fig. 3.3).
  3.  In the window of navigation, click on the blue ball before the element table of contents, then on the blue ball before the element 3 installation Tests. This displays the sections of chapter 3 in the window of navigation (Fig. 3.3).
  4.  Double click on the element 3.1 Test d'installation de l'assistant Rosetta. The section of the manual corresponding to this element should be displayed in the window of Gsview (Fig. 3.3).  
    ../../../images/rosetta/navros08.gif
    Figure 3.3Display of the pdf version of the user's manual of Rosetta CD-ROM with the help of Navigator AsTeX and Gsview.

  5.  Close the window of Gsview.
You can, if you wish, redo the same test while selecting Acrobat Reader instead of Gsview in the navigator's pull down list (cf. however the limitations indicated in the sec. 10.7). If the AsTeX distribution is installed, you can also do the test with Dviwin and Dview. The display with Dviwin works for all versions of Windows, but it is only in N&B. The display with Dview is in color, but it only works with Win 9x (cf. Installation manual of AsTeX).

3.3.3 Printing pdf documents 

  1.  Close the windows of the previous test that would still be opened (navigator AsTeX and, possibly, Acrobat Reader, Dviwin or Dview), then click on the button Man Util Ros A4 of the ../../../icones/rosetta/calfor01.gif toolbar. This opens the table of navigation of the User's manual of the Rosetta CD-ROM for Windows (the present manual), in a form adapted to printing.
  2.  Display the manual with Gsview by proceeding as in the previous section.
  3.  In the window of Gsview, click on the option Fichier / Imprimer and select the element mswinpr2 in the list Type (normally, the installation program of Rosetta made it for you, but who knows!).
    ../../../images/rosetta/gsvimp01.gif
  4.  Determine, by examining the table of navigation, the pages that you want to print (for ex. pages 23 to 32, if you want to print the installation chapter). Then select these pages in the frame Pages: of the printing dialog box Configuration of the printer of Gsview. If your printer has an option recto/verso, click on Ok to launch the printing. Otherwise, click on Impaires then Ok to print all odd pages, put back the printed sheets in the printer. Tick the slot Ordre inverse if the odd sheets have been printed in the order of decreasing pages, untick it otherwise, and click on Paires then Ok to print the even pages.
  5.  Close the windows of navigator AsTeX and Gsview.

3.4 Test of use of the CAS in a shell of Emacs (mod. 15/03/2003) 

In section 3.2, we tested the computer algebra programs without GUI in a command window, to verify that they are correctly installed. It is the most convenient way to test them, but it is not necessarily the most convenient way to use them, in particular under Windows 9x since a window cannot contain more than 50 lines.

In this section, we test their use in a shell of Emacs. This method is especially interesting because it permits to use all the CAS without GUI of the CD-ROM (with the exception of Yacas), in a window with any length and under all versions of Windows (9x and NTx). It also permits to launch commands of CAS directly from assistant Rosetta, as one will see it farther. To test this mode of use :

  1.  Click on the button EMACS/ast of the ../../../icones/rosetta/calfor01.gif toolbar to launch Emacs.
  2.  When Emacs is open, click on the button Etests . The configurations of Macaulay and Gsview are launched again in command windows, then the window of Emacs is split in two and CoCoA is launched in the bottom part.
    ../../../images/rosetta/tstros14.gif
  3.  In normal time, the upper part can be used as a notepad, to cut and paste the important results. For now, delete it by typing Ctrl-X 0, in order to display the maximum of lines of CoCoA in the window of Emacs.
  4.  Type Quit; to quit CoCoA. Gap is launched then. Quit Gap by typing quit; then quit the other CAS by typing the command displayed by the test program just before their launching (cf. also table 3.1). For Macaulay, it is necessary to type two times on the key Enter. Note that the prompts of Pari (a question mark) and of Singular (the character >) don't appear. Among the CAS of the CD-ROM, only Yacas cannot be launched in this way  : an error message Handle non valide (under Windows 9x) or Descripteur non valide (under Windows NTx) shows off. Click on the button OK to go to the following CAS. At the end of the test, the message runprg.bat testcas nogui: finished shows off at the bottom of the window of Emacs. Note that the CAS with GUI are not launched in this test, since they are capable to preserve the totality of the commands typed in their own window.
  5.  Close Emacs with the option File / Exit Emacs.

3.5 Test of the virtual desktop managers 

The virtual desktop managers extend the desktop on several screens. They are very convenient to study a given CAS or compare two CAS. In this section, we test the two virtual desktop managers included in the distribution, VirtuaWin and JS Pager. A more detailed description of these programs is given in the part Starter Guide (sec. 4.9).

3.5.1 VirtuaWin 

  1.  Click on the button Virtuawin of the ../../../icones/rosetta/calfor01.gif toolbar. An error message is displayed, indicating that the configuration file of Virtuawin could not be read and that a new one is going to be created (it corresponds to the fact that the program is launched for the first time).
    ../../../images/rosetta/virtwi01.gif
  2.  Click on OK to confirm the creation of the configuration file. An icon ../../../icones/rosetta/virtuaw1.gif icon appears in the right part of the taskbar of Windows, corresponding to the creation of four virtual desktops. The selected virtual desktop is symbolized by a red square, the other by green squares.
  3.  Displace the mouse downwards until under the taskbar. Assistant Rosetta disappears, as a consequence of the passage of the cursor in the lower desktop. Simultaneously, the ../../../icones/rosetta/virtuaw1.gif icon turns into ../../../icones/rosetta/virtuaw2.gif and the cursor of the mouse reappears in top of the screen.
  4.  Continue to pull down the cursor toward the taskbar of the new desktop, and click with the right button on the icon of Virtuawin in the taskbar. Select the option Exit to quit Virtuawin. Assistant Rosetta reappears.

3.5.2 JS Pager 

  1.  Click on the button Jspager of the ../../../icones/rosetta/calfor01.gif toolbar. The ../../../icones/rosetta/jspager.gif icon appears on the right of the taskbar, and the virtual desktop monitor (a miniature window with 9 slots, every slot symbolizing a desktop) appears on the left in top of the screen.
    ../../../images/rosetta/jspag01.gif
    If the virtual desktop monitor doesn't appear, click on the icon of JS Pager in the taskbar and select the option Show Desktop Monitor to make it appear.
  2.  Click on an empty zone of the screen or the taskbar, then move the mouse downwards until under the taskbar. As with Virtuawin, assistant Rosetta disappears, as a consequence of the passage of the cursor in the lower desktop. Simultaneously, the cursor of the mouse reappears in top of the screen and the focus, in the virtual desktop monitor, switch from the first desktop (in top on the left of the monitor) to the fourth (just below the precedent).
    ../../../images/rosetta/jspag02.gif
  3.  Continue to move down the cursor toward the taskbar of the new desktop, and click with the right button on the icon of JS Pager in the taskbar. Select the option Exit JS Pager to quit JS Pager. Assistant Rosetta reappears.

3.6 Test of the other utilities 

It remains to verify that the last programs not yet tested (Sinfo, Acrobat Reader and Netscape) can be launched also correctly from the buttons of the group << Utils>> .

3.6.1 Sinfo 

Sinfo is a program for managing processes for Windows 9x. He/it is useful in case of problem with Emacs (cf. sec. 4.11.2). To verify that it works correctly, click on the button Sinfo of the ../../../icones/rosetta/calfor01.gif toolbar. If you work under Windows 9x, you should get something similar to Fig. 4.1. Under Windows NTx (4.0/2000/XP), this button has no effect.

3.6.2 Acrobat Reader 

Click on the button AcroReader button of the ../../../icones/rosetta/calfor01.gif toolbar  to verify that Acrobat Reader can be launched from the CD-ROM. This version is used by navigator AsTeX to display the manuals in pdf form, even though Acrobat Reader is already installed on your machine.

3.6.3 Netscape 

Netscape permits to visualize html files. To verify that it can be launched from the CD-ROM, click on the button Netscape of the ../../../icones/rosetta/calfor01.gif toolbar . If you don't want to install it, click on the button Annuler of the first configuration panel of Netscape (cf. sec. 4.11.1).

 

Chapter 4 Starter guide of the CD-ROM 

This chapter permits to familiarize oneself with assistant Rosetta and shows how to test and to use the computer algebra programs in the best conditions.

4.1 Launching a computer algebra program from the assistant 

At the time of installation tests of the computer algebra programs of the CD-ROM, all programs have been launched one after another, in one command window (sec. 3.2), then in a shell of Emacs (sec. 3.4), from buttons of the toolbar Alg\Calfor01 ( ../../../icones/rosetta/calfor01.gif ). These programs can be launched individually, in one command window or in a shell of Emacs, from the other toolbars of assistant Rosetta. For example, Maxima can be launched from the toolbar Alg\Maxima associated to the ../../../icones/rosetta/max.gif button of the assistant's strip.

4.1.1 In a command window 

To launch Maxima in a command window  :

  1.  Click on the ../../../icones/rosetta/max.gif button of the assistant's strip to open the toolbar Alg\Maxima.
    ../../../images/rosetta/en/pmaxima.gif
  2.  Click on the button MAXIMA5.9 of the toolbar Alg\Maxima. It launches the last version of Maxima in a command window.
  3.  When the prompt (C1) Maxima appears, type quit(); to leave Maxima. This closes the command window at the same time.

4.1.2 In a shell of Emacs 

To launch Maxima in a shell of Emacs:

  1.  Click on the button EMACS/ast of the toolbar Alg\Maxima to launch Emacs.
  2.  When Emacs is open, click on the button Emaxima5.9 of the toolbar, to launch the new version of Maxima in a shell of Emacs, (or click on Emaxima5.5 to launch the former version).
  3.  Type Ctrl-X 0 to allocate the whole window of Emacs to Maxima (you can also click on the ../../../icones/assist/emacs.gif button of the strip to open the toolbar Etc\Emacs, click on the button Del fenêtre of this toolbar and close this toolbar).
  4.  Click on the button 1+2 of the toolbar Alg\Maxima to verify the good working of this button and of Maxima in a shell of Emacs.
  5.  Click on the button integrate to verify the capacities of Maxima in computer algebra (calculation of the indefinite integral of the function 1/(1+ x3)).
    ../../../images/rosetta/exemax01.gif
  6.  If you wish to study Maxima further, refer to sections 7.10 and 8.1. Otherwise, click on the button Quitter of the toolbar Alg\Maxima to stop Maxima. The message runprg.bat maxima55: finished is displayed at the bottom of the window of Emacs.
  7.  Close the window of Emacs with the option File / Exit Emacs.

4.2 The groups of toolbars 

When assistant Rosetta is launched, you can access the computer algebra programs, Calc, CoCoA, WinCoCoA, Gap, Giac, Jacal, Macaulay and Maxima from their specialized toolbars, when clicking on the corresponding buttons of the assistant's strip. If you wish to try one of them, refer to the corresponding section of chapter 7.
../../../images/rosetta/grpros01.gif
The toolbars of the programsCalc, CoCoA etc. belong to the group of toolbars Alg-1. To launch the other computer algebra programs that you met in the installation tests of the section 3.2 (Pari, Singular, Yacas and Xmaxima), it is necessary to change group of toolbars. To this end, move the cursor of the mouse on the button ../../../images/assist/lampe.gif of the strip, then click on the button Alg-2 . The buttons of the programs Xmaxima, MuPAD Studio, Pari, Singular, Yacas, Aldor, Axiom, CLN and DoCon appear.
../../../images/rosetta/grpros02.gif
Click on the ../../../icones/rosetta/xmax.gif button of the strip then on the button XMAXIMA5.9 of the toolbar Alg\Xmaxima (Fig. 8.1): the Maxima program is launched in a graphic window, entitled Xmaxima. Click on the button integrate of the toolbar Alg\Xmaxima to verify the good working of Maxima in its graphic interface, then close Xmaxima with its option File / Exit or with the button Quitter 5.9 of the toolbar. For a more thorough study of Xmaxima, or if you wish to try one of the four following programs of the group Alg-2 (MuPAD Studio, Pari, Singular or Yacas), refer to the corresponding section of the chapter 8. Note that the last four software of the group Alg-2 are not usable from the CD-ROM: Aldor is not available under Windows, Axiom not yet available in free version, CLN is a library and DoCon is not yet installed. The associated toolbars provide the documentation solely (cf. sec. 8.6 to 8.9).

When moving the cursor on the button ../../../images/assist/lampe.gif of the strip and clicking on the button Alg-3 , the buttons of the programs of the group Alg-3 appear:
../../../images/rosetta/grpros03.gif

4.3 Generalities on the CAS 

Some software of computer algebra are programs (for example Maxima), others are libraries (for example Mpfr or Zen). To know the exact nature of the software attached to a button, move the cursor of the mouse over this button and read the description that is displayed in the zone of the assistant's messages. For example, when moving the cursor over the ../../../icones/rosetta/zen2.gif button, the message Zen - Librairie C pour calculs sur anneaux finis (Zen - C Library for calculations on finite rings) is displayed. Only executable programs are present on the Rosetta CD-ROM for Windows. The libraries are on the Rosetta CD-ROM for Linux.

When a software has an official icon, it is used as image for the button of the strip. For example, Singular (group Alg-2) has ../../../icones/rosetta/singular.gif as icon. When there is no official icon, the image used is merely the name of the software on a standard background. If the background has a light-blue contour (for example ../../../icones/rosetta/yacas.gif ) this indicates that the corresponding program is installed and usable from the CD Rosetta. If the background has a red contour (for example ../../../icones/rosetta/axiom2.gif ), this indicates either there is no version for Windows, or there is no executable program (case of the libraries), or there is a version for Windows of the program but that it is not yet installed (case of DoCon).

4.4 Generalities about the toolbars 

One endeavored to standardize the toolbars of the computer algebra software to be able to compare them easily, but this work is still far from being finished. The following rules were adopted :
  1.  The buttons of the toolbars of CAS are distributed in five groups : launching, documentation, common tests, special tests and buttons under test. The first two groups (launching and documentation) are always present in a toolbar, the third (common tests) is present if and only if an executable version of the software is present on the CD-ROM.
  2.  The buttons of the first group (launching) serve to launch the program if there is an executable version for Windows, to indicate the status of the CAS otherwise. For example, for Xmaxima (group Alg-2), the button XMAXIMA5.9 (Fig. 8.1) serves to launch Maxima in its graphic interface Xmaxima. For CLN (group Alg-2), which is a library for computer algebra and not a program, the button CLN (Fig. 8.8) doesn't launch anything, and the bubble of commentary of this button indicates CLN - Pas de version exécutable pour Windows (CLN - No executable version for Windows).

    When there is a version for Windows executable in a command window, there are also two other buttons, in general, one to launch Emacs ( EMACS/ast ), the other to launch the program in a shell of Emacs (for ex.   Epari to launch the program Pari, cf. Fig. 8.3). The name of the button is constituted of the name of the program in lower-case letters, preceded by the letter E (for Emacs), possibly complemented by the version number (for ex.  Emaxima5.5 and Emaxima5.9 for the versions 5.5 and 5.9.0 of Maxima, cf. sec. 7.9).

    There may also be one or several buttons corresponding to a configuration file (for ex.  userinit.coc for the CoCoA program, cf. Fig. 7.3). To have information about their exact significance, refer to the corresponding section in one of the chapters 7 to 9.

  3.  The buttons of the second group (documentation), that follow the button << Doc>> , are used for displaying the documentation of the CAS. There are always in principle two buttons, one pointing toward the web site ( Site web ) the other pointing toward a copy of the web site on the CD-ROM ( Loc web ). If you are connected to Internet, use the first button, otherwise use the second. In this case, the welcome page is always displayed but it can happen that some or all links are inactive.

    When an user's manual is available, the group Doc includes a button Manuel . When a tutoriel is available, the group includes a button Tutoriel .

  4.  The buttons of the third group (common tests), that follow the button << Tests com>> , are six of them. The first three ( 1+2 , 2*3 and 2^10 ) permit to verify that the elementary operations (addition, multiplication, exponentiation) work well. The fourth and fifth buttons ( 1/3+3/4 and 100! ) permit to verify that the software does more that a plain minicalculator (the fractions are manipulated as such and not as real numbers, and the calculations can be made with an arbitrary precision and not with a fixed number of digits). Expressed with the syntax of Maxima, the tests are the following:

    Operation ExampleMaxima command
    Addition 1 + 2 1+2;
    Multiplication 2 × 3 2*3;
    Exponentiation 210 2^10;
    Addition of fractions 13 + 34 1/3+3/4;
    Factorial 100! 100!;

    The sixth button, Quitter , permits to quit normally the program (once one entered into a program, it is important to know how to leave it normally, without having to kill the process).

    When moving the the cursor over a button, the message displayed on the strip (or in the bubble of info, if the toolbar is active) indicates the command to type. For example, when moving the cursor over the button 100 ! of the toolbar of Maxima, the message is << 100!; (calculer factorielle 100 dans Maxima)>> (calculate factorial 100 in Maxima). When moving it over the button 100 ! of the toolbar of CoCoA, the message is << Fact(100); ( calculer factorielle 100 dans CoCoA)>> (calculate factorial 100 in CoCoA).

    Most these buttons are usable in a shell of Emacs, under Windows 9x or Windows NTx. We saw it with Maxima in the section 4.1. A lot of these buttons are also usable in a command window of Windows NTx (but not of Windows 9x) after having selected Rosetta as title of the destination window, in the dialog box Options of the assistant (cf.  Manuel of assistant AsTeX). To check it, make the modification above (i.e. click on the assistant's button ../../../images/assist/heart01.gif , then on the element Rosetta in the pull down list Titre de la fenêtre (Title of the window) and finally on the button Confirmer), launch Macaulay in a command window with the help of the button MACAULAY , click then on the buttons 1+2 , 2*3 etc.

  5.  The buttons of the fourth group (special tests), that follow the button << Tests spec>> correspond to specific tests for the software of the toolbar. The first buttons (development and factorisation) permit to verify that the software can manipulate some symbols and not only numbers. They separate programs for numeric calculations from CAS. The following buttons (derivation, integration) permit to separate general purpose CAS from specialized CAS. For example, the toolbar of Maxima, general purpose CAS, contains a button integrate corresponding to the calculation of an indefinite integral. The toolbar of CoCoA on the other hand doesn't contain such a button because it is specialized in commutative algebra. Expressed with the syntax of Maxima, the tests are the following:

    Operation Example Maxima command
    Expansion of an algebraic expression (a + b)2 expand((a+b)^2);
    Factorisation Factorise 1 + 2x + x2factor(1+2*x+x^2);
    Derivation d-
dx sin(x) diff(sin(x),x);
    Integration  integral sin(x)dx integrate(sin(x),x);

    The document rosetta.tex (cf.  sec 4.10) can suggest some more common tests.

  6.  The buttons of the fifth group (buttons under test) follow the button << Tests btns>> . They regroup various buttons, under test. When a button of a toolbar is not correct or not checked, its title ends by a question mark. For example, Site web? indicates that the address used in the button is not correct, or is not maybe the best. You can add personal buttons in this group (cf. sec. 4.8 and Manuel of assistant AsTeX).

4.5 Manual launching of the CAS 

We saw in sec. 4.1 how running the computer algebra programs of the CD-ROM from assistant Rosetta. They can also be launched mannally by typing a name, in a command window from the icons Invite Rosetta Win9x or Invite Rosetta WinNTx of the folder Rosetta (Fig. 2.2), or in a shell of Emacs from the icon Invite Rosetta Emacs of the folder Rosetta. We give, in the table below, the name to type for every program, and we specify if the command works or not in a command window and in a shell of Emacs:

Program LaunchingEnd of Quit Works Works
name command Cmd W.Sh Emacs
CoCoA cocoa ;Enter Quit; Yes Yes
Gap gap ;Enter quit; Yes Yes
Jacal jacal ;Enter quit(); Yes Yes
Macaulay2 macaulay Enter quit Yes Yes
Maxima 5.9 maxima ;Enter quit(); Yes Yes
Maxima 5.5 maxima55;Enter quit(); Yes Yes
Pari pari Enter quit Yes Yes
Singular singular ;Enter quit; Yes Yes
Yacas yacas ;Enter quit; Yes Non
Giac giac Enter File / quitYes
Mupad mupad ;Enter File / exitYes
Xmaxima 5.9xmaxima ;Enter File / exitYes
Xmaxima 5.5xmaxim55;Enter File / exitYes
WinCoCoA wincocoa ;Ctrl-EnterFile / quitYes

It can be useful in the course of systematic comparisons. For example, the batch file compare.bat of content

 start cocoa
 start gap
will permit, by simply clicking on this file or by adding a button in assistant Rosetta, to launch CoCoA and Gap in two distinct windows with a view to comparing them.

Remarks: To launch MuPAD Studio by hand, it can be necessary to have launched it at least once from the buttons, as indicated in sec. 8.2 (useless under Win 2000).

To launch Xmaxima, it is necessary not to have launched Maxima first in the same window. Otherwise, one gets an error (one can launch Xmaxima, then Maxima, then again Xmaxima, but not Maxima then Xmaxima).

The prompts of Pari (a question mark) and of Singular (a sign superior to) don't appear in a shell of Emacs.

4.6 Modification of the command window under WinNTx 

When a CAS is launched in a command window of Windows NTx from assistant Rosetta, the text appears in blue on yellow background (cf. Fig. 3.1). Features of this window are determined by the program runprg.bat, under WinNTx.

To modify these colors:

  1.  Click on the button ../../../icones/rosetta/calfor01.gif of the assistant's strip to open the toolbar Alg\Calfor01, click then on the button Ed.  runprg to open the file runprg.bat in the Notepad.
  2.  Under the line color e1, add the line color fc and save the modification.
  3.  Open the toolbar Alg\Maxima and click on the button MAXIMA5.9 : Maxima should now appear in light red on white background.
  4.  Close the window of Maxima by typing quit();
In the command color ft, the first character f fixes the color of the background, the character t fixes the color of the text. The colors are given in the table below:

0 Black 1 Dark blue 2 Dark green 3 Dark cyan
4 Dark red 5 Dark violet 6 Dark yellow 7 Light grey
8 Dark grey9 Light blue A Light green B Light cyan
C Light redD Light violetE Light yellowF White

To modify the other features of the command window (numbers of lines and columns):

  1.  Take again the file runprg.bat. Under the line mode con cols=80 lines=200, add the line mode con cols=40 lines=20 and save the modification.
  2.  Restart Maxima by clicking on the button MAXIMA5.9 : Maxima should appear in a small window of 40 columns large and 20 lines height.
  3.  Close the window of Maxima by typing quit();
  4.  Take again the file runprg.bat, suppress the lines that you added there (or modify them as you please) then save the modification.

4.7 Modify a button of a toolbar 

You can modify a button of an any toolbar by refering to the documentation of assistant AsTeX (button Assist.  AsTeX of the ../../../icones/rosetta/calfor01.gif toolbar). As an exercise, let's change the button a+b^2 of Pari (Fig. 8.3) in a+b^12 :
  1.  Open the group of toolbars Alg-2 then the toolbar Alg\Pari.
  2.  Open the box of options of the assistant by clicking on ../../../images/assist/heart01.gif and select the tab Toolbar.
  3.  Select the button (a+b)^2 of the Pari toolbar by clicking on it.
  4.  Duplicate it by clicking on the button Dupliquer of the box of options, in order to keep a copy of the original.
  5.  Replace 2 by 12 in the fields Nom (Name) and Commande envoyée (Command sent) of the box of options of the assistant.
  6.  Click on the button Sauver (Save) of the box of options, then on its closing button .
  7.  Launch Pari in a shell of Emacs with EMACS/ast and Epari , then click on the modified button (a+b)^12 . The development of (a + b)12 appears in the window of Emacs.
  8.  To finish, destroy the modified button while clicking on Supprimer (Delete) in the box of options of the assistant, and close the box of options by clicking on its closing button .
  9.  Click on the button Quitter to leave Pari and close Emacs with the option File / Exit Emacs.

As long as you didn't modify a toolbar, its file of definitions is read on the CD-ROM, in the directory ROSETBAS\astex\assist\alg for the toolbars about computer algebra. When you click on the button Sauver, (Save) the file of definitions is saved on the hard disk, in the directory ASTEXDIR\assist\alg. From then on, it is this file that is used to read the definitions of the toolbar. If you wish to reset the toolbar, just destroy this file.

Remark  : if you want to modify a complete toolbar under editor, from the button Éditer boutons (Edit buttons) (tab Panneau (Toolbar) of the dialog box Options) of the assistant, you must click beforehand on the button Sauver (Save) of this same toolbar, the first time that you modify it (after that, it is no more necessary, of course).

4.8 Add a button to a toolbar 

You can add a button to any toolbar, with one of the methods indicated in the documentation of assistant AsTeX (button Assist.  AsTeX of the ../../../icones/rosetta/calfor01.gif toolbar). As an exercise, let's add a button (a+b)^2 to the Jacal toolbar just before the button factor (Fig. 7.7) by copying / pasting from the button of Pari then adapting the syntax  :
  1.  Open the group of toolbars Alg-2 then the toolbar Alg\Pari.
  2.  Open the box of options of the assistant by clicking on ../../../images/assist/heart01.gif and select the tab Toolbar.
  3.  Click on the button (a+b)^2 of the Pari toolbar, then on the button Copier of the box of options of the assistant, in order to copy the button (a+b)^2 into the assistant's clipboard.
  4.  Open the group of toolbars Alg-1 then the toolbar of Jacal.
  5.  Click on the button factor of this toolbar to select the place where to paste the button.
  6.  Click on the button Coller (Paste) of the box of options of the assistant, to paste the button (a+b)^2 to the selected place, over the button factor .
  7.  Click on the button 1+2 , and select with the mouse everything that follows the 2, in the field Commande envoyée (Command sent) (i.e. the chain ;{ENTER}^{ENTER} that is required to finish a command of Jacal), and copy it with the right button of the mouse in the clipboard of Windows.
  8.  Click on the button (a+b)^2 and select, in the field Commande envoyée of the box of options, everything that follows the 2 (i.e. the chain {ENTER}^c^c that is required to finish a command of Pari). Replace it with the end of command of Jacal, by clicking with the right button of the mouse on the selected chain and then by clicking on the option Coller (Paste) of the floating menu of edition.
  9.  Save the new button by clicking on the button Sauver of the box of options of the assistant.
  10.  Close the box of options, launch Jacal in a shell of Emacs and test the new button.
  11.  Quit Jacal by clicking on the button Quitter of the toolbar of Jacal, then close Emacs with its option File /  Exit Emacs.

4.9 Virtual desktop managers 

The virtual desktop managers are very convenient to study or to compare the computer algebra programs. This type of utility exists in standard in the Linux distributions. There is none in the standard Windows distributions. Some manufacturers of graphic cards provide one of it for some versions of Windows, but it is rare enough.

Several free programs of this type exist. VirtuaWin and JS Pager have been included in the distribution, as a trial measure. If one doesn't suit your needs or if it is incompatible with some programs that you use, you can replace it by the other and retry. VirtuaWin is of a cruder aspect than JS Pager, but it didn't present any incompatibility with the programs with which it has been tested. JS Pager on the other hand posed some problems: it inhibits, after some manipulations, the function of insertion of commands of assistant Rosetta, and it can block the launching of some programs (it is the case of Serif Photo Plus). No incompatibility has been noted however with the programs of the CD-ROM, except assistant Rosetta.

4.9.1 VirtuaWin 

VirtuaWin is the program virtuawin.exe of the directory ROSETTA\utils\Vdesktop\Virtuawin. It can be launched by clicking on the button Virtuawin of the toolbar ../../../icones/rosetta/calfor01.gif of the assistant (Fig. 7.1), or on the icon VirtuaWin of the Rosetta folder (Fig. 2.2).

Configuration 

The default configuration of VirtuaWin is not very well suited to the study and comparison of CAS. We propose here a configuration more adapted:

  1.  Click on the button Virtuawin of the assistant's toolbar ../../../icones/rosetta/calfor01.gif . The icon of Virtuawin ../../../icones/rosetta/virtuaw1.gif appears in the taskbar.
  2.  Click on this icon with the right button of the mouse, and select the option Setup. This opens a dialog box entitled Virtuawin - Properties, with five tabs (Keys, Mouse, Modules, Misc. and About).
  3.  Select the tab Mouse and tick the options No mouse move and Taskbar warp.
    ../../../images/rosetta/virtcfg1.gif
    With the option No mouse move, the change of desktop is done by <<bumping>> the cursor of the mouse against one of the sides of the screen. This option minimizes the amplitude of the movements of the mouse.

    The option Taskbar warp permits to displace windows of applications from one desktop to another by drag and drop (cf. example below).

  4.  Select the tab Misc., then select 2 by 1 in the frame Number of desktops. The option 2 by 1 limits the number of desktops to two (Note : With a bigger number of desktops, it is difficult to remember the open programs, and in what desktops they are, insofar as only the icons of the programs of the current desktop appear in the taskbar. This problem doesn't occur with JS Pager, since the icons of all open programs appear in the taskbar of all desktops.), arranged horizontally (Note : The horizontal disposition rather than vertical avoids inopportune changes of desktop when the cursor is moved toward the taskbar and that it is moved accidentally too low.) one next to the other. With this option, the icon of Virtuawin turns into a black rectangle containing the number of the desktop 1 or 2 in green ( ../../../icones/rosetta/virtico1.gif or ../../../icones/rosetta/virtico2.gif ).

Study of a CAS 

Let's examine, with the help of an example, how VirtuaWin can facilitate the study of a CAS:

  1.  Launch assistant Rosetta, then Virtuawin from the toolbar ../../../icones/rosetta/calfor01.gif (Alg\Calfor01).
  2.  Open the toolbar Alg\Cocoa, by clicking on the button ../../../icones/rosetta/cocoa.gif of the group of toolbars Alg-1 of the assistant.
  3.  Open the tutorial of CoCoA with the help of the button Tutoriel of the toolbar.
  4.  Click on the right part of the titlebar of the tutorial, close to the button of reduction, and move the window of the tutorial toward the right while maintaining the button of the mouse pressed, until the icon of VirtuaWin transforms from ../../../icones/rosetta/virtico1.gif to ../../../icones/rosetta/virtico2.gif . Bring back the tutorial toward the left to center it.
  5.  Come back to the desktop ../../../icones/rosetta/virtico1.gif by bumping the cursor of the mouse against the left side of the screen.
  6.  Launch CoCoA in a shell of Emacs by clicking on the buttons EMACS/ast then Ecocoa .

With this configuration, one has a first desktop containing the assistant, the toolbar Alg\Cocoa and CoCoA itself running in the window of Emacs, and a second desktop containing the tutorial. In this way, one passes from the program to the tutorial by bumping the cursor of the mouse against the right side of the screen, and vice versa from the tutorial to the program by bumping the cursor against the left side of the screen. Make some tests to become familiar with this behavior.

Comparing two CAS 

Let's continue with the previous example, to see how VirtuaWin can facilitate the comparison of two CASS (here, CoCoA and Macaulay (Note : CoCoA and Macaulays both permit to perform symbolic computations in commutative algebra.))  :

  1.  Go into desktop 2 and close the tutorial of CoCoA.
  2.  Click with the left button of the mouse on the icon of VirtuaWin ( ../../../icones/rosetta/virtico2.gif ) in the taskbar and select the option Assistant AsTeX: the assistant now appears in the desktop ../../../icones/rosetta/virtico2.gif .
  3.  Touch the left side of the screen with the mouse to go into desktop 1, and note that the assistant now appears in each of the desktops. Then touch the right side of the screen to come back into desktop 2. The assistant's window is said to be "sticky" for VirtuaWin.
  4.  While being still in desktop ../../../icones/rosetta/virtico2.gif , click on the button ../../../icones/rosetta/macaulay.gif to open the toolbar Alg\Macaulay, then click on the buttons EMACS/ast and Emacaulay to execute Macaulay in the window of Emacs.
  5.  Perform the common tests of Macaulay by clicking on the buttons 1+2 , 2*3 etc.
  6.  Go into the first desktop and perform the common tests of CoCoA.
With this configuration, you have a first desktop containing the assistant, the toolbar Alg\Cocoa and CoCoA running in the window of Emacs, and a second desktop containing the assistant, the toolbar Alg\Macaulay and Macaulay running in a second window of Emacs.

There remains two possibilities of VirtuaWin to present:

  1.  Double click on the icon of VirtuaWin in the taskbar: this transforms the icon of VirtuaWin (the number of the current desktop) in ../../../icones/rosetta/virtico0.gif and lock VirtuaWin in on the current desktop. To verify it, try to change desktop by moving the cursor toward the left side of the screen then toward the right side. Double click on ../../../icones/rosetta/virtico0.gif to unlock VirtuaWin.
  2.  Go into the second desktop (if you are not there already), click with the left button of the mouse on the icon of VirtuaWin in the taskbar. The list of all open programs appears. Select the option Assistant AsTeX. This transforms back the status of the window of the assistant from "sticky" to ordinary. To check it, come back to the first desktop: the assistant's strip is not present there any more. On that occasion, it can be noted that the notion of sticky window provides a second manner to move a window from one desktop to another.

When the study of this section is finished, leave the CoCoA and Macaulay programs by clicking on the buttons Quitter of their respective toolbars, close Emacs with the option File / Exit Emacs, close the toolbars of CoCoA and Macaulay and quit Virtuawin. If you work under Windows 9x, it is very important to leave the CAS launched in a shell of Emacs by using their normal quit commands before closing Emacs. Otherwise, you risk to block your machine completely. If you forgot to do it and that you left Emacs directly, refer to section 4.11.2 to kill the Winoldap processes remained open, before going further.

4.9.2 Jspager 

JS Pager permits to use a larger number of virtual desktops than Virtuawin, thanks to its system of miniature windows representing the open programs, and thanks to the display on the taskbar of all open programs, whatever the virtual desktop where they are. One can know thus at a glance which programs are open, on which desktops they are and which desktops are empty.

To launch JS Pager, you can click on the button Jspager of the toolbar ../../../icones/rosetta/calfor01.gif of the assistant, or on the icon Jspager of the Rosetta folder (Fig. 2.2).

The default configuration can be modified by clicking with the right button of the mouse on the icon of JS Pager in the taskbar, and by selecting the option Options. The configuration recommended for JS Pager is to define two or four virtual desktops by default instead of the nine by default (X=2 and Y=1, or X=2 and Y=2 in the frame Desktop size) and to untick the option Wrap cursor in the tab General options. This option is the equivalent of the option No mouse move of Virtuawin. If you want to have the same behavior more or less than with VirtuaWin, set the cursor of the scroll bar Mouse scroll delay time to the second graduation. This gives a delay of 200 ms before changing desktop, when one brings the cursor of the mouse against a side of the screen. A window can be declared sticky with the help of the option Set sticky windows of the menu of JS Pager.

To see how JS Pager can facilitate the study of a CAS, perform the same operations that you did for the example 1 of VirtuaWin (sec. 4.9.1), while launching JS Pager instead of VirtuaWin. More precisely, launch assistant Rosetta, then JS Pager, open the toolbar Alg\Cocoa and launch CoCoA in a window of Emacs, finally launch the tutorial of CoCoA. You should have then on your desktop, the assistant Rosetta, the toolbar Alg\Cocoa, a window of Emacs in which CoCoA is running, the window of the tutorial of CoCoA, the virtual desktop monitor (sec. 3.5.2) of JS Pager in the upper left corner of the screen and the ../../../icones/rosetta/jspager.gif icon of JS Pager in the lower right corner.

A miniature window representing the tutorial appears in the virtual desktop monitor. The tutorial can be changed of desktop by drag and drop, by clicking with the right button of the mouse on its miniature window in the virtual desktop monitor, and moving this miniature in the monitor to the second virtual desktop. One can then switch from the program to the tutorial by bumping the cursor of the mouse against a side of the screen, as with Virtuawin, by clicking on the miniature desktop that contains the element (program or tutorial) that one wants to use.

To see how JS Pager can facilitate the comparison of two CAS, perform the same operations you did for the example 2 of VirtuaWin (sec. 4.9.1), and install CoCoA and Macaulay in two distinct virtual desktops.

The test buttons of assistant Rosetta can become inoperative after some manipulations (Note : We didn't determine exactly which sequence of operations create some problems with the test buttons of the assistant and must be avoided.), when JS Pager is in use. If this happens (message of the type Le programme emacs@ n'est pas ouvert - The program emacs@ is not opened), try to regroup on one desktop the assistant, the toolbar and the target software (Emacs), and retry. If the problem persists, close JS Pager then restart it.

4.10 The Rosetta document 

The document Rosetta.tex, of Tim Daly et al., takes again and extends a comparative study of various CAS made by Michael Wester et al.

He/it is available under several forms on the Rosetta CD-ROM for Windows: dvi, pdf and html. The first two forms are provided in two versions, one adapted to the screen, the other adapted to printing. The version for screen can be displayed from the button Doc Ros écr. of the toolbar Alg\Calfor01 ( ../../../icones/rosetta/calfor01.gif ) of the group of toolbars Alg-1. The version adapted to printing can be displayed with the button Doc Ros A4 (cf. sec. 3.3.2). The form html is available in multi-files version.

Every CAS having its own syntax, it is very easy to make some mistakes and to mix instructions of various languages, as soon as one tries to compare them. The Rosetta document is a very substantial help, it is therefore important to be able to consult it conveniently.

A possibility is to go into a virgin virtual desktop (cf. sec. 4.9), to display the Rosetta document with Gsview in its version adapted to the screen (by opening the pull down list in the upper right corner of the navigator's window and by clicking on the element Gsview of the list, cf. sec.3.3.2), then to open entirely the index in the navigator by clicking on the ../../../images/navig/nvtblova.gif button. For example, to get the various ways to note the infinity, one has just to click on the line Infinity in the navigator  :
../../../images/rosetta/navros05.gif
A very useful complement is obtained by searching word in the complete document. The initialization of search with Gsview being slow, it is convenient to launch a search on any word when beginning a session, for example solve. Next searches are instantaneous:
../../../images/rosetta/navros04.gif

4.11 Other programs 

4.11.1 Netscape Navigator 

If you don't have any web browser installed on your machine (Note : The grass-roots version of Windows 95 doesn't include a web browser.), or if it is an old version (Note : The version of Internet Explorer included in Windows NT 4.0 cannot display animated gifs.), the CD-ROM contains Netscape Navigator, installed so that it can be used directly from the CD-ROM (Note : With Windows 95, Netscape Navigator needs the libraries mfc42.dll and msvcrt.dll. They appear in the later versions of Windows. A copy of these files has been placed in the directory astexdis\a_copier\netscape\program of the CD-ROM. The standard method is to transfer these files in the directory windows\system of Windows 95. You can do it, but it is not required: a second copy of these libraries has been installed in the same directory as netscape.exe, so that Netscape can be executed under grass-roots Windows 95 without previous transfer of the libraries in the directory system of Windows.). There is just a configuration file to create on your hard disk (and not on the CD-ROM, as Netscape recommends it  !) by filling in a few dialog boxes. To run the dialog, open the toolbar ../../../icones/rosetta/calfor01.gif of assistant Rosetta (if you installed it) and click on the button Netscape . If you didn't install it, you can launch Netscape from the icon Netscape of the folder Rosetta, or from Windows Explorer, by going in the directory ast\view\netscape\program of the CD-ROM and clicking on the file netscape.exe. In any case, the following information message is displayed:
../../../images/rosetta/nscins02.gif
Click on the button Suivant Next. The following dialog box is displayed:
../../../images/rosetta/nscins03.gif
Enter your name and your first name (or merely a if you don't want to use the mail system of Netscape) in the field Nom entier (whole Name), then your electronic address (or a@b) in the field Adresse électronique (Electronic Address), then click on Suivant. The following dialog box is displayed:
../../../images/rosetta/nscins04.gif
In this dialog box, be careful to write the name of an accessible directory in the field Directory, for example C:\ast\astex\config\a, instead of the directory recommended by the program (that lies on the CD-ROM):
../../../images/rosetta/nscins05.gif
You can accept all default choices by clicking on Suivant in every dialog box, if you want just to use the Navigator part of Netscape:
../../../images/rosetta/nscins06.gif
../../../images/rosetta/nscins07.gif
../../../images/rosetta/nscins08.gif
Click on Terminer (Finish) to finish the configuration. If a web browser is already installed on your machine, you will get moreover the message:
../../../images/rosetta/nscins01.gif
If you want to preserve your default navigator, tick the slot Ne pas effectuer cette vérification à l'avenir (Do not do this verification in the future) and click on No.

4.11.2 Sinfo 

Sinfo (System Info) is a program of management of processes and windows (visible or invisible) for Win9x, written by J. Aguirregabiria.

Sinfo is indispensable to kill a process that is not accessible by Ctrl-Alt-Del under Windows 9x, for example the processes Cmdproxy and Winoldap, if you quit a program in a shell of Emacs in a cavalier fashion by clicking on the button to close Emacs window, without first leaving with its own command and then quitting Emacs with its option File / Exit.  


../../../images/rosetta/sinfo02.gif
Figure 4.1The Sinfo utility, to manage processes, for Windows 9x.

To launch Sinfo, click on the button Sinfo of the toolbar ../../../icones/rosetta/calfor01.gif of the assistant, or on the icon Sinfo in the folder Rosetta, or on the file sinfo.exe in the directory ast\utils\system\sinfo of the CD-ROM. Note that this program doesn't work with Windows NTx (cf. documentation of Sinfo)  :
../../../images/rosetta/sinfo06.gif
but Windows NTx possesses integrated tools to manage processes.

Sinfo requires no installation nor configuration to be used.

 

Chapter 5 Tips and tricks 

This chapter gathers some tips and tricks that can facilitate the survey of the programs of the Rosetta CD-ROM for Windows.

5.1 Searching of a word in a document 

The manuals of the Rosetta CD-ROM have an index. When the latter proves to be insufficient to answer some questions, it is possible to make a complementary search of word in the complete text of the manual, whatever the version (html, pdf or dvi). Thus, for a research in the User's manual of the Rosetta CD-ROM for Windows (the present manual)  :

5.2 Modifying the features of Invite Rosetta WinNTx 

When a CAS is launched in a command window of Windows NTx from assistant Rosetta, the text appears in blue on yellow background, in a window of 200 lines and 80 columns. We saw in section 4.6 how to modify the features of this window. When a SCF is launched from the icon Invite Rosetta WinNTx by typing its name of launching (cf. sec. 4.5), the text appears in black on white background, in a window of 250 lines and 80 columns. We explain in this section how to modify the features of this window (the procedure described in section 4.6 doesn't permit to do it).

The command window Invite Rosetta WinNTx is configured by default to 250 lines with 80 columns, with black characters on white background. To change this configuration, click with the right button of the mouse on the icon Invite Rosetta WinNTx of the folder Rosetta and select the option Properties. A dialog box opens up, entitled Properties of Invite Rosetta WinNTx (Fig. 5.2).  


../../../images/rosetta/tstros02.gif
Figure 5.2Configuration panel of a command window, under Windows NTx.

In order to have for example a "spreadsheet" of 100 columns of large rather than 80, select the tab Disposition and type 100 in the field Width of the frame Taille de la mémoire tampon écran (?Size of the screen buffer memory?). On the contrary, to have a small spreadsheet of 40 columns and 20 lines, type 40 at the same place, and 20 in the field Width of the frame Taille de la fenêtre (size of the window). The colors of the text and the background of the command window can be modified from the tab Color.

5.3 Using two languages with the assistant (mod. 09/05/2003) 

The procedure to change language indicated in section 2.6 requires to rerun the installation. This procedure is fact but not immediate. If you wish to switch instantaneously from one language to another, you can save the configuration of the current language before running installation for another language. To this end :
  1.  Click with the right button of the mouse on the icon Assistant AsTeX of the desktop and select the option Properties.
  2.  In the field Cible (?Target?), change the name of the configuration file aaroset.ini to something else, for example aaroset_fr.ini if you are using the French version.
  3.  Click on OK to close the properties panel and give another name to the icon Assistant Rosetta of the desktop, for example Assistant Rosetta franais.
  4.  Open Windows Explorer and go into directory ASTEXDIR\assist.
  5.  Change the name of the file aaroset.ini according to the modification done previously in the panel Properties ((aaroset_fr.ini for the above example).
  6.  Change the language by following the procedure of section 2.6.

 

Chapter 6 Technical References 

This chapter gathers technical precisions on the Rosetta CD-ROM for Windows.

6.1 Structure of the CD 

6.1.1 Root 

The root of the CD contains the installation program install.exe and the entering point alire.htm of the documentation in html form.

6.1.2 Directory ast 

This directory contains the programs and files of the distribution that are used directly from the CD-ROM.

6.1.3 Directory astexdis 

This directory contains files used solely during the installation. The subdirectory a_copier contains the initialization and configuration files that are copied on the hard disk during the installation.

6.2 Environment variables 

The locations of the files of the distribution are defined by four main environment variables, ROSETBAS, ASTEXDIR, ASTEXBAS and HOME:
  1.  ROSETBAS contains the value of the main directory of the programs and files of the CD-ROM. For example, if the name of the CD-ROM drive is D:, the environment variable ROSETBAS will contain D:\ast.
  2.  ASTEXDIR contains the value of the main directory of the configuration files of the distribution. This directory must be accessible in writing, as well as all its subdirectories, so that the configuration files can be written there. If the variable ASTEXDIR was not defined before installation, it is taken equal to C:\ast\astex by the installation program of the Rosetta CD-ROM.
  3.  ASTEXBAS contains the value defined by the AsTeX distribution if the latter is installed. Otherwise, it contains the same value as ROSETBAS. For example, if the AsTeX distribution is installed in a drive of name T:, ASTEXBAS has the value T:\ast. If the distribution is not installed, ASTEXBAS has the value D:\ast.
  4.  HOME contains the location of the configuration files of Emacs. At installation time, its value is defined by adding \emacs to the value of ASTEXDIR. With the example above, the value of HOME is C:\ast\astex\- emacs.
The values of these variables are saved during the installation in the file autoexec.bat and in the file rosetini.bat of the directory contained in ASTEXDIR. Under Windows NTx, they are also registered in the registry database, but solely for the user who did the installation, in its zone Variables utilisateur (User's variables) of Windows' configuration panel. To know their values, one can consult these two files or type set in a command window. Under Windows NTx, one can also examine the registry database.

6.3 Names of directories 

In this manual, one often designates the name of a directory with the help of the environment variables defined above. With the example of the previous section, the name of the file of the assistant AsTeX that is on the Rosetta CD-ROM, that is D:\ast\astex\assist\aastex.exe can be rewritten ROSETBAS\astex\aastex.exe assist\.

6.4 Configuration of assistant AsTeX for the CD Rosetta 

The assistant Rosetta is the assistant AsTeX configured for the Rosetta CD-ROM. The configuration files of assistant Rosetta are the files aaroset.ini, rosetgrp.apd, rosetgrp.lst and rosetprg.lst of directory ASTEXDIR\assist, the environment variable ASTEXDIR being defined by the algorithm of sec. 6.2. At installation time, the last three files are copied from the directory astexdis\a_copier\astex\assist of the CD-ROM, in the directory ASTEXDIR\assist. The first file (aaroset.ini) is created from the file aaroset.fin of the CD-ROM and the installation configuration, with the help of the utility ROSETBAS\astex\config\roscfg.bat.

Assistant Rosetta can be launched in several ways:

  1.  By double-clicking on its icon on the Desktop,
  2.  By double clicking on its icon in the folder Rosetta,
  3.  With the option Start / Programs / Rosetta / Assistant Rosetta.
It can be closed in the two usual ways (cf. manual of assistant AsTeX):
  1.  While clicking on the button to close the window of the strip,
  2.  While clicking on the button ../../../images/assist/stop.gif of the strip.
In the first case, the assistant's configuration is not saved, in the second it is saved.

6.5 Modifications brought by the installation of the CD Rosetta 

The visible modifications brought to your machine by the installation of the Rosetta CD-ROM have been described in sec. 2.4. The complete list of the modifications (visible and invisible) is the following:
  1.  An option Rosetta with two sub-options Assistant Rosetta and Désinstallation Rosetta (Uninstalling Rosetta) est ajoutée au menu Start / Programs.
  2.  Two icons of title Rosetta and Assistant Rosetta are added on the desktop. The Rosetta icon is a folder that contains the icons for troubleshooting the installation, (Install Assistant AsTeX and Install Navigator AsTeX), for running manually CAS in command windows, (Invite Rosetta Emacs, Invite Rosetta WinNTx and Invite Rosetta Win9x), for launching virtual desktops (VirtuaWin and Jspager), for displaying files (Acrobat Reader and Netscape), and for running / killing programs (Assistant Rosetta and Sinfo).
  3.  Lines defining the value of the environment variables ROSETBAS, ASTEXDIR, ASTEXBAS and HOME are added to the file autoexec.bat (cf. sec. 6.2). This file is created if it doesn't exist. The values of these variables are added moreover in the registry database.
  4.  A directory ASTEXDIR is added to your hard disk, to contain the configuration files of the various programs, and the batch files that you could have to modify for your own needs (cf. sec. 6.6).
  5.  A file docsetup.bat is added to the Programmes / Démarrage (Programs / Start) menu of the user. It displays the chapter 3 (Installation tests) of the user's manual of the Rosetta CD-ROM, as long as the obligatory test TEST CAS has not been launched (more precisely, as long as the configuration file of Macaulay has not been created).

6.6 Modification of the installation directory 

The Rosetta distribution installs on the hard disk only a very small number of files, essentially configuration files and batch files that permit to customize the launching of some programs. In the remainder, one will call these files the kernel of Rosetta.

The kernel of Rosetta is installed in the directory contained in the environment variable ASTEXDIR if the latter is defined, in the directory C:\ast\astex otherwise. If the AsTeX distribution is installed already on your machine, ASTEXDIR is defined and the kernel of Rosetta is installed automatically in the same directory as the kernel of AsTeX. If the AsTeX distribution is not installed and that the default directory doesn't suit your needs, you can change it by giving as value to the variable ASTEXDIR the name of the directory where you want to install the kernel of Rosetta.

Under Windows 9x (95/98/ME), ASTEXDIR can be defined in the file autoexec.bat. Under Windows NTx (4.0/2000/XP), it can also be defined in the autoexec.bat (in which case it will be known of all users for which the procedure of initialization reads this file) or in the registry database (in this case, you must be logged in under a user's name belonging to the groups Administrators or User with power (?) to be allowed to access it). If she/it is defined in the two, the value in the registry database has pre-emption. So ASTEXDIR is defined in the autoexec.bat, it is necessary to start again the machine so that the value is taken into account. In any case and under all versions of Windows, it is advisable to open a command window and to type set to verify whether this variable is defined and has the correct value.

For example, if you want to put the kernel of Rosetta in the directory J:\Programs\Rosetta and that you choose to define ASTEXDIR in your file autoexec.bat, add the line

set ASTEXDIR=J:\Programs\Rosetta
in this file, restart your machine and proceed with the installation as indicated in the section 2.3.

If the name of the installation directory contains the white, it must be registered in ASTEXDIR with the MS-DOS notation. For example, if you want to put the kernel of Rosetta in the directory J:\Program Files\Rosetta, the line to add to the autoexec.bat will be written

set ASTEXDIR=J:\Progra~1\Rosetta
Under Windows NTx, if you want to define rather ASTEXDIR in the registry database, go in the tab Environment (NT 4.0) or Environment variables (NT 2000/XP) of the dialog box Properties of the system of the configuration panel. If you want that ASTEXDIR is known only to the present user, define it in the frame User variables. If you want it to be known to all users, log in under a user's name belonging to the group Administrators and define it in the frame System variables (or define it in the autoexec.bat , as indicated above).

There again, ensure that the short name of the installation directory is correct, by opening a command window and typing dir J:\pro* (under Win9x) or dir /X J:\pro* (under WinNTx). The number can be something else than 1 if you have several directories whose names have the same first eight characters.

Whatever is the way chosen to define ASTEXDIR, once its value is fixed, the installation of the CD-ROM can be done by restarting the machine and installing the CD-ROM as indicated in sec. 2.3.

6.7 Use in Plug & Play mode from a virtual CD-ROM drive (mod. 27/04/2003) 

If you intend to use the software of the Rosetta distribution only in an occasional way, the use in Plug & Play mode from the CD-ROM is very well adapted. Indeed, when you want to use one of the software, inserting the Rosetta CD-ROM in the CD drive is sufficient, and the software is immediately available from assistant Rosetta. Outside of these occasional periods, your PC is modified insignificantly: the CD-ROM drive is free, the files related to the Rosetta distribution occupy practically no room on your hard disk, and the system of menus is not modified significantly.

If on the other hand you plan to use the software of the CD-ROM in an intensive manner, this mode of use can be penalizing insofar as the CD-ROM drive is blocked during the whole time where you use the distribution. In this case, if you have a big hard disk (for example M:) with a lot of free space (at least 700 Mo free in FAT32), it is recommended to copy the totality of the files of the Rosetta CD-ROM in a directory of this hard disk (for example in the directory M:\Copies of CD-ROMs\Rosetta), to associate a drive's letter (for example R:) to this directory with the help of the Subst instruction:

subst R: "M:\Copies of CD-ROMs\Rosetta"
and to proceed with the installation of the Rosetta distribution from this virtual CD-ROM drive instead of the physical CD-ROM drive.

The instruction subst above can be written in a batch file (for example inidv.bat). In double-clicking on this batch file in the Windows Explorer, a virtual CD-ROM drive, is created, from which you can proceed with the installation of the Rosetta distribution.

Under Windows 9x and Windows NT 4.0, this virtual CD-ROM drive can be made permanently available, by copying the file inidv.bat in the directory WINDIR\Start Menu\Programs\Starting (?) (cf. also the installation manual of AsTeX, sec. 18.19, Use in Plug & Play mode from the hard disk). Under Windows NT 5.x (2000 and XP), it is necessary to copy the file inidv.bat in the directory ALLUSERSPROFILE\Start Menu\Programs\Starting to make permanently available the virtual CD-ROM drive to all users of the PC (Note : The environment variables WINDIR and ALLUSERSPROFILE are defined by Windows NTx. To know their exact value for your installation, open a command window and type set.).

6.8 Reinstallation in Plug & Play mode from a virtual CD-ROM drive (mod. 27/04/2003) 

If you installed the Rosetta distribution with the default mode of use (Plug & Play from the CD-ROM drive) and that you wish afterwards to use it from the hard disk, you have to:
  1.  Copy the contents of the CD-ROM in a directory of the hard disk and create a virtual CD-ROM drive as indicated in the preceding section (sec. 6.7).
  2.  Uninstall the distribution with the option Start\Programs\Rosetta\- Désinstallation Rosetta (Uninstall Rosetta) (sec. 2.5).
  3.  Redo installation from the virtual CD-ROM drive and restart your PC (sec. 2.3).

6.9 Installation of the CD Rosetta for all users of a PC 

As the goal of the Rosetta CD-ROM is to permit to test some CAS without installing them, the installation is made by default for the administrator who did the installation and for him only, in order to not perturb the installation of the other users (Note : The most usual case of a mono-user PC falls into this definition of course, whatever is the version of Windows.).

If you are administrator of a PC under Windows NTx and that you want to make the Rosetta distribution accessible to all users of the PC (or if you are the only user of your PC but that you want to use the distribution from a plain account, without privileges of administration, to avoid to damage the system files accidentally), the procedure to follow is very simple: install the CD-ROM normally, as indicated in sec. 2.3, then cut and paste the short cuts created during installation, from the installer's personal directory to the directory All Users. More precisely, the steps to follow are:

  1.  Open a session under the administrator's name with which you installed the Rosetta CD-ROM (for example Administrator).
  2.  Open the Windows Explorer and go into your personal directory (for ex. H:\Documents and settings\Administrator for the user Administrator).
    ../../../images/rosetta/allusr01.gif
  3.  Go into the subdirectory Desktop, cut the elements Rosetta and Assistant Rosetta and paste them in the directory H:\Documents and settings\All Users\Desktop.
  4.  Go into the subdirectory Start Menu\Programs, cut the element Rosetta and paste it in the directory H:\Documents and settings\All Users\Start Menu\Programs.
  5.  If the Rosetta distribution is used in Plug & Play mode from an unit that must be mounted before being usable (as a virtual CD-ROM drive or a network disk), install the mount utility in the directory H:\Documents and settings\All Users\Start Menu\Programs\Starting. In the example of the previous section (sec. 6.7), the mount utility is the file inidv.bat.
  6.  Copy the file gsview32.ini from your personal directory to the personal directories of all others users supposed to have access to Gsview.
  7.  Go into the directory ASTEXDIR\config\Virtuawin, copy the file vwconfig.user.cfg (where user designates the user's name under which you tested and configured Virtuawin, cf. sec. 4.9.1), paste this file in the directory ASTEXDIR\config\Virtuawin.
  8.  Close the session in progress and login again under another user's name.
  9.  Verify that the icon Assistant Rosetta actually exists on the desktop, that the assistant opens up correctly and that the button COCOA (for example) actually launches the program CoCoA. In case of problem, refer to chapter Troubleshooting.
  10.  Open the toolbar ../../../icones/rosetta/calfor01.gif and click on the button Ini Gsview NT , to configure Gsview for the Rosetta distribution.

6.10 Installation over the AsTeX distribution 

The Rosetta CD-ROM is compatible with the AsTeX 3.1x distribution. This means that it can be installed over this distribution and used with it, so that the user has all software of the two CD-ROMs available simultaneously. In particular, all buttons of assistant AsTeX that are related to TeX become operational (groups of toolbars Util1, SymTeX, AMSTeX etc.)

The installation can be done in a number of ways, according to the hardware configuration of your PC (number of available CD-ROM drives, free room on the hard disks, possibility or not to use a network disk if the PC is networked). There are too many various possibilities to enumerate them all, only some examples of configurations are described below:

  1.  A stand-alone PC with two CD-ROM drives (for example a DVD drive and a CD-recorder)  : you can install both CD-ROMs in Plug & Play mode, for a super-fast installation.
  2.  A stand-alone PC with a CD-ROM drive and a lot of room on the hard disk: copy one of the CD-ROMs on the hard disk in a directory, for example C:\astexcd, create a virtual CD-ROM drive by adding the line
     subst T: C:\astexcd
    
    in the file autoexec.bat (Windows 9x) or in a file inidv.bat (Windows NTx) placed in the Starting directory of the user or of All Users and perform the installation in Plug & Play mode from the two drives (physical and virtual).
  3.  A standalone PC with a lot of room on the hard disk: copy both CD-ROMs each in its directory, for example Copies of CD\AsTeX and Copies of CD\Rosetta, create two virtual CD-ROM drives by adding the lines
     subst T: "Copies of CD\AsTeX"
     subst V: "Copies of CD\Rosetta"
    
    in the file autoexec.bat or inidv.bat as above, and perform installations in Plug & Play mode from drives T: and V:.

    Remark : normally, it ought to be also possible to copy the two CD-ROMs in the same directory, in order to use only one drive name (DVD mode, to be tested).

  4.  If your PC is networked, you can use a network CD-ROM drive (that means a CD-ROM drive of another PC shared through the network to which you are connected).
  5.  If you have several hard disks and not enough room on only one hard disk but enough on two, the virtual CD-ROM drives can lie also on distinct hard disks: the location of the AsTeX CD-ROM is known of the AsTeX and Rosetta distributions through the environment variable ASTEXBAS, the one of the Rosetta CD-ROM through the variable ROSETBAS, the content of these two variables being possibly identical (DVD mode) or distinct (present case).

    On the other hand, the kernel of the two distributions must be put together, and its location is known of the two distributions through the environment variable ASTEXDIR. The kernel of Rosetta only adds 0.1 Mo to the kernel of AsTeX. If you install the Rosetta distribution on an existing AsTeX installation, there should not be any problem: the installation program of Rosetta should detect it and should install the kernel of Rosetta with the kernel of AsTeX.

    If you installed only the Rosetta distribution and that you want to install the AsTeX distribution also (for example to display the dvi versions of certain manuals, or to use other programs of AsTeX), it is necessary to install it so that it shares the same main directory with the Rosetta distribution on the hard disk (c:\ast if you used the directory by default for Rosetta, the main directory associated to ASTEXDIR if you defined this variable as indicated in the section 6.6).

 

Chapter 7 Toolbars of the Alg-1 group 

This chapter describes the buttons of the various toolbars of the group Alg-1 created for the Rosetta CD-ROM for Windows.

7.1 Generalities 

For every program or library of computer algebra and numeric calculation included in the CD-ROM, a toolbar was created in assistant Rosetta.

Every toolbar is represented by an icon, in the assistant's strip (cf. User's manual of AsTeX). When an official icon symbolizes a program, the official icon has been used. When we were not aware of any official icon, we used an icon composed of the name of the program on a standard background. If the program is not installed and that only documentation is available, the inverse video is used as an icon (cf. sec. 4.3).

When a filename begins with ROSETTA, this corresponds to the name of the CD-ROM drive that contains the Rosetta CD-ROM. For example, if your CD-ROM drive is called D:, ROSETTA\ast\edit\lisp\calculator.el represents the file D:\ast\edit\lisp\calculator.el. Note that ROSETBAS\edit\lisp\calculator.el represents the same file (cf. sec. 6.3).

7.2 Toolbar ../../../icones/rosetta/calfor01.gif (Alg\en\Calfor01) 

 
../../../images/rosetta/en/pcalfor1.gif
Figure 7.1 The toolbar Alg\en\Calfor01 (Generalities about computer algebra).

7.2.1 Description of the buttons 

  1.   TEST SCF  : launches the test of all CAS (Computer Algebra Systems) installed on the Rosetta CD-ROM, in a command window (cf. sec. 3.2).
  2.   EMACS/ast  : launches the Emacs program for Windows from the directory ASTEXDIR (necessary to use the button Etests ).
  3.   Etests  : launches the test of all CAS without GUI (Graphical User Interface) in a shell of Emacs (sec. 3.4). Emacs must be already open. The command sent to the shell is runprg.bat testcas nogui.
  4.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  5.   General help : displays the main html page of the Rosetta CD-ROM for Windows (file alire.htm at the root of the CD-ROM, Fig. 2.1).
  6.   Man Util Ros  : displays the User's manual of the CD Rosetta for Windows (the present manual) in html form. It exists in two versions, multi-files and mono file. The first version permits a fast display, the second permits to search for a word in the totality of the manual. It is accessible from the table of contents of the multi-files version (Fig. 5.1).
  7.   Man Util Ros A4  : displays the table of navigation of the User's guide of the CD Rosetta for Windows in a form adapted to printing. The display can be done as for the screen version. Printing can be done with the option Print of the software used (Ghostscript, Acrobat Reader, Dviwin or Dview, cf. sec. 3.3.3).
  8.   Man Util Ros scr.  : displays the table of navigation of the User's guide of the CD Rosetta for Windows (the present manual) in a form adapted to the screen. To display the manual, open the navigator's pull down list and click on the element GSview (the pdf form is used), cf. sec. 3.3.2.

    If the AsTeX distribution is installed, the dvi form of the manual can be displayed in B&W with Dviwin (Win9x and WinNTx) by clicking on the element DVI Driver of the list, or in color with Dview (Win9x only) by clicking on the element Dview. For more precisions, cf. the manuals of installation and use of AsTeX.

  9.   Doc Ros A4  : displays the table of navigation of the document Rosetta of Tim Daly et al. in a form adapted to printing.
  10.   Doc Ros scr.  : displays the table of navigation of the document Rosetta of Tim Daly et al. in a form adapted to the screen, cf. sec. 4.10.
  11.   Assist. AsteX  : displays the html version of the manual of assistant AsTeX.
  12.   Navig. AsteX  : displays the html version of the manual of the navigator AsTeX.
  13.   Site Ros4Win  : displays the web site of AsTeX association, to know the latest news about the Rosetta CD-ROM for Windows.
  14.   Site Ros4Lin  : displays the web site of Tim Daly, to know the latest news about the Rosetta CD-ROM for Linux.
  15.   << Utils>>  : marker of the group of buttons << Utility programs>>. This button doesn't execute any action.
  16.   Virtuawin  : launches the manager of virtual desktops Virtuawin (sec. 3.5.1 and 4.9.1).
  17.   Jspager  : launches the manager of virtual desktops JS Pager (sec. 3.5.2 and 4.9.2).
  18.   Sinfo  : launches Sinfo, the manager of processes for Windows 9x (sec. 4.11.2).
  19.   Netscape  : launches Netscape from the CD-ROM (sec. 4.11.1), for the case where there would be no web browser installed.
  20.   AcroReader  : launches Acrobat Reader. This version is used by all the other buttons of the assistant that display pdf files.
  21.   Gsview  : launches GSview, the previewer of PostScript and pdf files.
  22.   (Dviwin)  : launches Dviwin, the previewer of dvi files in B&W (requires the installation of the AsTeX distribution).
  23.   (Dview)  : launches Dview, the previewer of dvi files in color (requires the installation of the AsTeX distribution).
  24.   << Init>>  : marker of the group of buttons << Various initialisations>>. This button doesn't execute any action.
  25.   Ini Macaulay  : launches the configuration of the Macaulay computer algebra program (cf. sec. 7.9 and 3.2).
  26.   Ini Gsview NT  : copy the initialization file of GSview in the correct directory for Windows NT 2000 and XP (not necessary for Windows 95/98- /ME nor for NT 4.0).
  27.   Ini Virtuawin  : for Windows NTx only. Creates an initialization file for Virtuawin with the parameters recommended in the section 4.9.1: 2 virtual desktops, one next to the other (2 by 1 in the frame Number of desktops of the tab Misc), displacement of windows authorized from one desktop to the other, and virtual desktop change by "bumping" the cursor of the mouse against the left or right side of the screen (options Taskbar warp and No mouse move selected in the tab Mouse of the configuration dialog box of VirtuaWin).
  28.   Ini Navig  : launches the installation of libraries required to run navigator AsTeX with some former versions of Windows (Windows NT4 without service pack, and for Windows 95 (verify?)).
  29.   Ed. runprg  : opens in Notepad the program runprg.bat, that controls the appearance of the command windows (number of lines and columns, color of the background and characters).
  30.   << Shells>>  : marker of the group of << Fenêtres de commandes interactives>> (interactive window commands). This button doesn't execute any action.
  31.   Fen Cmd DD  : opens a command window in the directory ast\astex of the hard disk (Disque Dur, in French).
  32.   Fen Cmd CD  : opens a command window in the directory ast\astex of the CD-ROM (CD).
  33.   Emacs sh  : launches a shell in Emacs in the directory ast\astex of the hard disk.
  34.   Search>>  : marker of the group of buttons << Moteurs of recherche>> (search engines). This button doesn't execute any action.
  35.   Google  : displays the web site of Google.
  36.   << Tests btns>>  : marker of the group of buttons << Test buttons>>. This button doesn't execute any action.
  37.   Gen. help 2  : displays the main html page of the CD-ROM with the help of the default web browser by using start directly (i.e. without launching COMSPEC beforehand).
  38.   Gen. help 3  : displays the main html page of the CD-ROM with the help of Netscape or the default web browser, according to the case. The navigator to be used is selected by the environment variable ROSNETS. If its value is Y, Netscape is used. If it has another value, the default navigator is used.
  39.   Ed. rosetpar  : Permits to modify under editor the parameters (VDOCHTM and ROSNETS) that monitor the display of documentation.
  40.   cd C:\  : Fixes C:\ as default directory, to test the dependence of buttons with respect to the current directory (useful for the buttons launching a batch file in a shell of Emacs).
  41.   Doc Rosetta  : displays the Rosetta document (sec. 4.10) in Acrobat Reader.

7.3 Toolbar ../../../icones/rosetta/calc.gif (Alg\en\Calc) 

 
../../../images/rosetta/en/pcalc.gif
Figure 7.2 The toolbar Alg\en\Calc (infinite precision calculator for Emacs).

Emacs contains an on-line scientific minicalculator calculator.el, very simple to use but with limited possibilities, and a more powerful calculation program calc.el, that permits to do some calculations that are a matter for computer algebra.

We describe in this section how to launch these programs from the buttons of the toolbar Alg\en\Calc, and we give some advice to start using them.

7.3.1 Description of the buttons 

  1.   EMACS  : launches the Emacs program for Windows.
  2.   CALCulator  : launches the Calculator program for Emacs (file ROSETTA\ast\edit\lisp\calculator.el). Emacs must be already open.
  3.   CALC  : launches the Calc program for Emacs (file ROSETTA\ast\edit\- lisp\calc\calc.el). Emacs must be already open.
  4.   CALC-Kpd  : launches the Calc program for Emacs in minicalculator mode (file ROSETTA\ast\edit\lisp\calc\calc-keypad.el). Emacs must be already open.
  5.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  6.   Web site  : displays the site of Calc in the default web browser.
  7.   Loc web  : displays a local copy of the site of Calc in the default web browser.
  8.   Tutorial  : displays the pages of tutorial of the manual of Calc.
  9.   Manual  : displays the manual of Calc.
  10.   << Btns Emacs>>  : marker of the group of buttons << Boutons pour Emacs>> (Buttons for Emacs). This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  11.   Escape  : runs the command Cancel of Emacs (Ctrl-G).
  12.   Del window  : suppress the current window of Emacs (Ctrl-X 0).
  13.   Exit  : quit Emacs (Ctrl-X Ctrl-C).

7.3.2 Starter guide of Calculator (mod. 22/04/2003) 

The scientific minicalculator Calculator is launched in the same way, whatever the version of Windows.

  1.  Select the group of toolbars Alg-1 of assistant Rosetta.
  2.  Open the toolbar Alg\en\Calc by clicking on the button ../../../icones/rosetta/calc.gif  of the assistant's strip.
  3.  Launch Emacs by clicking on the button EMACS .
  4.  Launch Calculator by clicking on the button CALCulator .
  5.  Display the main commands of Calculator by typing ?

7.3.3 Starter guide of Calc (mod. 21/04/2003) 

Calc can be run in the same way, whatever the version of Windows.

  1.  Select the group of toolbars Alg-1 of assistant Rosetta.
  2.  Open the toolbar Alg\en\Calc by clicking on the button ../../../icones/rosetta/calc.gif  of the assistant's strip.
  3.  Launch Emacs by clicking on the button EMACS .
  4.  Launch Calc by clicking on the button CALC .
  5.  Display the User's Guide of Calc with the help of the button Manual .
  6.  Click on the button Tutorial to display the tutorial of Calc (section 3. Tutorial of the User's Guide) and to start learning some possibilities of Calc.

7.4 Toolbar ../../../icones/rosetta/cocoa.gif (Alg\en\Cocoa) 

 
../../../images/rosetta/en/pcocoa.gif
Figure 7.3 The toolbar Alg\en\CoCoA (computer algebra in commutative algebra).

7.4.1 Description of the buttons (mod. 22/04/2003) 

  1.   COCOA  : launches the CoCoA program in a command window. The command sent is:
          COMSPEC /cROSETBAS\astex\startprg.bat cocoa
         
    The window created is 50 lines high under Win9x, 200 lines high under WinNTx.
  2.   EMACS/ast  : launches the Emacs program for Windows from the directory ASTEXDIR (necessary to use the button Ecocoa ).
  3.   Ecocoa  : launches CoCoA in a shell of Emacs. Emacs must be already open. The command sent to the shell is runprg.bat cocoa.
  4.   userinit.coc  : edit, with Wordpad, the initialization file of the user, ASTEXDIR\userinit.coc.
  5.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  6.   Web site  : displays the site of CoCoA in the default web browser.
  7.   Loc web  : displays a local copy of the site of CoCoA in the default web browser.
  8.   Tutorial  : displays the part Tutorial of the user's manual of CoCoA.
  9.   Manual  : displays the whole set of on line help of CoCoA.
  10.   << Tests com>>  : marker of the group of buttons << Tests communs>> (common tests). This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  11.   1+2  : add 1 and 2 in CoCoA.
  12.   2*3  : multiply 2 by 3 in CoCoA.
  13.   2^10  : calculate 2 to the power 10 in CoCoA.
  14.   1/3+3/4  : add two fractions in CoCoA.
  15.   100 !  : calculate the factorial of 100 in CoCoA.
  16.   Quit  : quit the CoCoA program.
  17.   << Tests spec>>  : marker of the group of buttons << Tests spécifiques au programme>>. (tests specific to the program). This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  18.   1.5+2.3;  : illustrates the transformation of reals into fractions by CoCoA (cf. tutorial).
  19.   A:=3;  : example of definition of a variable (cf. tutorial).
  20.   2A;  : example of use of a variable (cf. tutorial).
  21.   B=7;A^2+B;  : example of use of variables (cf. tutorial).
  22.   << Tests btns>>  : marker of the group of buttons << Buttons under test>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  23.   COCOA ?  : launches the CoCoA program by start cocoa.bat.

7.4.2 Starter guide 

  1.  Select the group of toolbars Alg-1 of assistant Rosetta.
  2.  Open the toolbar Alg\en\Cocoa by clicking on the button ../../../icones/rosetta/cocoa.gif  of the assistant's strip.
  3.  Launch Emacs by clicking on the button EMACS/ast .
  4.  Launch CoCoA in a window of Emacs by clicking on the button Ecocoa  : a session of CoCoA opens up in the lower window. Select this window by clicking on it (Note : The upper window could contain for example a TeX file describing the calculations, and in which one could transfer, by cut and paste, some results obtained in the lower window.).
  5.  Select Emacs as target program in the assistant, and perform the common tests, by clicking on the buttons 1+2 etc. All buttons have been verified and work under Windows 98SE / 2000. After having clicked on Quit , the message runprg.bat cocoa:finished is displayed at the bottom of the Emacs window. One can close Emacs with its option File / Exit Emacs, or restart a session by clicking again on Ecocoa .
  6.  To become acquainted with CoCoA, display its tutorial, by clicking on the button Manual then on the elements CoCoA Manual, 1.2 Tutorial and 1.2.1 A Tutorial Introduction to CoCoA.
To test CoCoA in a command window, click on the button COCOA . To perform the common tests under Windows NTx, select Rosetta as target window of the assistant, then click on the buttons of common tests (the buttons 2^10 , 100 ! and Quit don't work). Under Windows 9x, the tests have to be done by hand. To remember the syntax of a test, move the cursor over the button of the test and read the corresponding command in the zone of messages of the assistant (for example, when moving the cursor over the button 100! , the message indicates that the command to type is Fact(100);).

7.5 Toolbar ../../../icones/rosetta/wincocoa.gif (Alg\en\Wincocoa) 

 
../../../images/rosetta/en/pwincoco.gif
Figure 7.4 The toolbar Alg\en\WinCoCoA (computer algebra in commutative algebra).

To enter a command, it is necessary to type Ctrl-Enter and not Enter.

7.5.1 Description of the buttons (mod. 22/04/2003) 

  1.   WINCOCOA  : launches the WinCoCoA program (graphic interface for CoCoA).
  2.   userinit.coc  : edit, with Wordpad, the initialization file of the user, ASTEXDIR\userinit.coc.
  3.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  4.   Web site  : displays the site of CoCoA in the default web browser.
  5.   Loc web  : displays a local copy of the site of CoCoA in the default web browser.
  6.   Tutorial  : displays the part Tutorial of the user's manual of CoCoA.
  7.   Manual  : displays the whole set of on line help of CoCoA.
  8.   << Tests com>>  : marker of the group of buttons << Tests communs>> (common tests). This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  9.   1+2  : add 1 and 2 in the window of WinCoCoA.
  10.   2*3  : multiply 2 by 3 in the window of WinCoCoA.
  11.   2^10  : calculate 2 to the power 10 in the window of WinCoCoA.
  12.   1/3+3/4  : add two fractions in the window of WinCoCoA.
  13.   100 !  : calculate the factorial of 100 in the window of WinCoCoA.
  14.   Quit  : quit the WinCoCoA program.
  15.   << Tests spec>>  : marker of the group of buttons << Tests specific to the program>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  16.   1.5+2.3;  : illustrates the transformation of reals into fractions by CoCoA (cf. tutorial).
  17.   A:=3;  : example of definition of a variable (cf. tutorial).
  18.   2A;  : example of use of a variable (cf. tutorial).
  19.   B=7;A^2+B;  : example of use of variables (cf. tutorial).
  20.   << Tests btns>>  : marker of the group of buttons << Buttons under test>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  21.   WINCOCOA ?  : launch the WinCoCoA program by start wincocoa.bat.

7.6 Toolbar ../../../icones/rosetta/gapico1.gif (Alg\en\Gap) 

 
../../../images/rosetta/en/pgap.gif
Figure 7.5 The toolbar Alg\en\Gap (computer algebra in group theory).

7.6.1 Description of the buttons (mod. 22/04/2003) 

  1.   GAP  : launches the GAP program in a command window.
  2.   EMACS/ast  : launches the Emacs program for Windows from the directory ASTEXDIR (necessary to use the button Egap ).
  3.   Egap  : launches Gap in a shell of Emacs. Emacs must be already open. The command sent to the shell is runprg.bat gap.
  4.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  5.   Web site  : displays the site of Gap in the default web browser.
  6.   Loc web  : displays a local copy of the site of Gap in the default web browser.
  7.   Tutorial  : displays the tutorial of Gap.
  8.   Manuals  : displays the basic manuals of Gap (?not the specialized package manuals - to be checked?).
  9.   << Tests com>>  : marker of the group of buttons << Tests communs>> (common tests). This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  10.   1+2  : add 1 and 2 in Gap.
  11.   2*3  : multiply 2 by 3 in Gap.
  12.   2^10  : calculate 2 to the power 10 in Gap.
  13.   1/3+3/4  : add two fractions in Gap.
  14.   100 !  : calculate the factorial of 100 in Gap.
  15.   Quit  : quit the Gap program.
  16.   << Tests spec>>  : marker of the group of buttons << Tests specific to the program>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  17.   << Tests btns>>  : marker of the group of buttons << Buttons under test>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  18.   Ini tests ?  : Inserts the necessary command to load the tests of Gap, with the characters " replaced by apostrophes. To obtain the correct command, replace all apostrophes by ".
  19.   Run tests ?  : launches the tests of Gap, once the correction above has been done.
  20.   GAP ?  : launches Gap without going through startprg.bat.

7.6.2 Test of the buttons 

7.6.3 Starter guide 

One can test the modules of Gap by typing the command:
 Read ("X:/ast/alg/gap/tst/testall.g")
and by replacing X with the name of the CD-ROM drive in which the Rosetta CD-ROM is.

7.7 Toolbar ../../../icones/rosetta/giac.gif (Alg\en\Giac) 

 
../../../images/rosetta/en/pgiac.gif
Figure 7.6 The toolbar Alg\en\Giac (C++ library for computer algebra).

7.7.1 Description of the buttons 

  1.   GIAC  : launches the GIAC program for Windows directly.
  2.   GIACb  : launches the GIAC program for Windows from a batch file.
  3.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  4.   Web site  : displays the site of Giac in the default web browser.
  5.   Loc web  : displays a local copy of the site of Giac in the default web browser.
  6.   Refcard  : displays the summary in 2 pages of the main commands necessary to start with Giac.
  7.   Tutorial  : displays the tutorial of Giac.
  8.   Comp.algebra  : displays the user's manual of Giac.
  9.   Programming  : displays the manual of programming with Giac.
  10.   << Tests com>>  : marker of the group of buttons << Tests communs>> (common tests). This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  11.   1+2  : add 1 and 2 in the window of Giac.
  12.   2*3  : multiply 2 by 3 in the window of Giac.
  13.   2^10  : calculate 2 to the power 10 in the window of Giac.
  14.   1/3+3/4  : add two fractions in the window of Giac.
  15.   100 !  : calculate the factorial of 100 in the window of Giac.
  16.   Quit  : quit the Giac program.
  17.   << Tests spec>>  : marker of the group of buttons << Tests specific to the program>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  18.   cos(x+y)  : develop cos(x + y).
  19.   series  : calculate the series development of a fraction of form 0/0 at the origin (sin x/(x - sin x))
  20.   << Tests btns>>  : marker of the group of buttons << Buttons under test>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.

7.7.2 Test of the buttons 

The common and special tests work under Windows 98SE, but not under Windows 2000.

7.8 Toolbar ../../../icones/rosetta/jacal.gif (Alg\en\Jacal) 

 
../../../images/rosetta/en/pjacal.gif
Figure 7.7 The toolbar Alg\en\Jacal (general purpose CAS).

In the present version, Jacal is launched in a command window.

7.8.1 Description of the buttons 

  1.   JACAL  : launches the JACAL program.
  2.   SCHEME  : launches the interpreter scm.exe of the Scheme language.
  3.   EMACS/ast  : launches the Emacs program for Windows from the directory ASTEXDIR (necessary to use the button Ejacal ).
  4.   Ejacal  : launches Jacal in a shell of Emacs. Emacs must be already open. The command sent to the shell is runprg.bat jacal.
  5.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  6.   Web site  : displays the site of Jacal in the default web browser.
  7.   Loc web  : displays a local copy of the site of Jacal in the default web browser.
  8.   Man Jacal  : displays the user's manual of Jacal.
  9.   Man Scheme  : displays the user's manual of Scheme.
  10.   << Tests com>>  : marker of the group of buttons << Tests communs>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  11.   1+2  : add 1 and 2 in Jacal.
  12.   2*3  : multiply 2 by 3 in Jacal.
  13.   2^10  : calculate 2 to the power 10 in Jacal.
  14.   1/3+3/4  : add two fractions in Jacal.
  15.   100 !  : calculate the factorial of 100 in Jacal.
  16.   Quit  : quit the Jacal program.
  17.   << Tests spec>>  : marker of the group of buttons << Tests specific to the program>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  18.   factor  : factorise a fraction into a quotient of prime numbers.
  19.   << Tests btns>>  : marker of the group of buttons << Buttons under test>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  20.   diff  : calculate a derivative.
  21.   1+2 ?  : calculate 1+2 with another end of command than in the button 1+2 of the common tests.

7.8.2 Test of the buttons 

Under Windows 2000:

Under Windows 98SE, the common and specific tests work in a shell of Emacs.

7.9 Toolbar ../../../icones/rosetta/macaulay.gif (Alg\en\Macaulay) 

 
../../../images/rosetta/en/pmacaula.gif
Figure 7.8 The toolbar Alg\en\Macaulay (computer algebra in algebraic geometry and commutative algebra).

7.9.1 Description of the buttons 

  1.   MACAULAY  : launches the MACAULAY program for Windows.
  2.   EMACS/ast  : launches the Emacs program for Windows from the directory ASTEXDIR (necessary to use the button Emacaulay ).
  3.   Emacaulay  : launches Macaulay in a shell of Emacs. Emacs must be already open. The command sent to the shell is runprg.bat macaulay.
  4.   Ini Macaulay  : launches the configuration of the Macaulay computer algebra program (cf. sec. 7.9 and 3.2).
  5.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  6.   Web site  : displays the web site of Macaulay in the default web browser.
  7.   Loc web  : displays a local copy of the web site of Macaulay in the default web browser.
  8.   Manual  : displays the whole set of manuals of Macaulay.
  9.   << Tests com>>  : marker of the group of buttons << Tests communs>> (common tests). This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  10.   1+2  : add 1 and 2 in Macaulay.
  11.   2*3  : multiply 2 by 3 in Macaulay.
  12.   2^10  : calculate 2 to the power 10 in Macaulay.
  13.   1/3+3/4  : add two fractions in Macaulay.
  14.   100 !  : calculate the factorial of 100 in Macaulay.
  15.   Quit  : quit the Macaulay program.
  16.   << Tests spec>>  : marker of the group of buttons << Tests specific to the program>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  17.   factor  : Factorise a fraction in a quotient of prime numbers.
  18.   << Tests btns>>  : marker of the group of buttons << Buttons under test>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.

7.9.2 Test of the buttons 

Under Windows 98SE, the common and specific tests work in a shell of Emacs.

7.9.3 Starter guide (mod. 22/04/2003) 

It is important to note that, when one works in a command window, the end of acommand of Macaulay is marked by typing one time on the Enter key, (cf. the test of sec. 3.2), whereas it is marked by typing two times on the Enter key, when one works in a shell of Emacs.

  1.  Select the group of toolbars Alg-1 of assistant Rosetta.
  2.  Open the toolbar Alg\en\Macaulay by clicking on the button ../../../icones/rosetta/macaulay.gif  of the assistant's strip.
  3.  Launch Emacs by clicking on the button EMACS/ast .
  4.  Launch Macaulay in a window of Emacs by clicking on the button Emacaulay  : a session of Macaulay opens up in the lower window. Select this window by clicking on it.
  5.  Select Emacs as target-program in the assistant, and perform the common tests by clicking on button 1+2 , etc.
  6.  Type 1+2 and check that you must type two times on the Enter key to run the computation (the only exception is the quit command).
To begin to familiarize with Macaulay, display its tutorial by clicking on the button Manual then on the elements User' Guide and Getting started.

To test Macaulay in a command window, click on the button MACAULAY . The tests must be made by hand under Windows 9x. Under Windows NTx, select Rosetta as target window, then perform the common tests (the 6 buttons work).

7.10 Toolbar ../../../icones/rosetta/max.gif (Alg\en\Maxima)  

 
../../../images/rosetta/en/pmaxima.gif
Figure 7.9 The toolbar Alg\en\Maxima (general purpose CAS).

For the time being, the on line help provided by the command describe(); is in French for version 5.9.0, and in English for version 5.5. To modify the language of the on line help, cf. sec. 11.1.

7.10.1 Description of the buttons (mod. 09/05/2003) 

  1.   MAXIMA5.9  : launches the version 5.9.0 of Maxima in a command window.
  2.   MAXIMA5.5  : launches the version 5.5 of Maxima in a command window.
  3.   EMACS/ast  : launches the Emacs program for Windows from the directory ASTEXDIR (necessary to use the buttons Emaxima5.9 and Emaxima5.5 ).
  4.   Emaxima5.9  : launches Maxima v5.9.0 in a shell of Emacs. Emacs must be already open. The command sent to the shell is runprg.bat maxima.
  5.   Emaxima5.5  : launches Maxima v5.5 in a shell of Emacs. Emacs must be already open. The command sent to the shell is runprg.bat maxima55.
  6.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  7.   Orig web site  : displays the original site of Maxima of W. Schelter in the default web browser.
  8.   New eb site  : displays the new site of Maxima in the default web browser.
  9.   Loc web orig  : displays a local copy of the original site of Maxima in the default web browser.
  10.   Loc web new  : displays a local copy of the new site of Maxima in the default web browser.
  11.   Tutorial  : displays the tutorial of R. Strand for Maxima.
  12.   Manual  : displays the multi-file html version of the Reference manual of Maxima.
  13.   Manual (1.htm)  : displays the mono-file html version of the Reference manual of Maxima. With this version, it is possible to search for all occurrences of a word in the whole manual (cf. sec. 5.1).
  14.   ManRef A4  : displays the English version of the Reference manual of Maxima in the navigator AsTeX. This version is adapted to printing (cf. sec. 3.3.3).
  15.   ManRef scr.  : displays the English version of the Reference manual of Maxima in the navigator AsTeX. This version is adapted to browsing on screen (cf. sec. 3.3.2).
  16.   << Tests com>>  : marker of the group of buttons << Tests communs>> (common tests). This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  17.   1+2  : add 1 and 2 in Maxima.
  18.   2*3  : multiply 2 by 3 in Maxima.
  19.   2^10  : calculate 2 to the power 10 in Maxima.
  20.   1/3+3/4  : add two fractions in Maxima.
  21.   100 !  : calculate the factorial of 100 in Maxima.
  22.   Quit  : quit the Maxima program.
  23.   << Tests spec>>  : marker of the group of buttons << Tests specific to the program>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  24.   diff  : calculate a derivative.
  25.   integrate  : calculate an indefinite integral.
  26.   describe  : displays help on a command of Maxima (provokes an error not found " dir ", with the present installation).
  27.   BROKEN Max.  : permits to come back to the prompt of Maxima after an error occurred (as above, with the command describe).
  28.   << Tests btns>>  : marker of the group of buttons << Buttons under test>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  29.   MAXIMA5.9?  : launches Maxima 5.9.0 without going through startprg (runs under Win 2000).
  30.   MAXIMA5.5?  : launches maxima 5.5 from the executable (runs under Win 2000).
  31.   MAXIMA5.5??  : launches Maxima 5.5 from a batch file (runs under Win 2000)

7.10.2 Test of the buttons 

Under Windows 2000:

Under Windows 98SE, all tests work, in a shell of Emacs.

7.10.3 Starter guide of Maxima 

For a first contact with Maxima, it is recommended to consult the interactive tutorial that is provided with the graphic interface Xmaxima (cf. sec. 8.1).

 

Chapter 8 Toolbars of the Alg-2 group 

This chapter describes the buttons of the various toolbars of the group Alg-2 created for the Rosetta CD-ROM for Windows.

8.1 Toolbar ../../../icones/rosetta/xmax.gif (Alg\en\Xmaxima) 

 
../../../images/rosetta/en/pxmaxima.gif
Figure 8.1 The toolbar Alg\en\Xmaxima (general purpose CAS with graphic interface).

8.1.1 Description of the buttons 

  1.   XMAXIMA5.9  : launches version 5.9.0 of Maxima in the specialized graphic interface Xmaxima.
  2.   XMAXIMA5.5  : launches version 5.5 of Maxima in the specialized graphic interface Xmaxima.
  3.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  4.   Orig web site  : displays the original site of Maxima of W. Schelter in the default web browser.
  5.   New web site  : displays the new site of Maxima in the default web browser.
  6.   Loc web orig  : displays a local copy of the original site of Maxima in the default web browser.
  7.   Loc web new  : displays a local copy of the new site of Maxima in the default web browser.
  8.   Tutorial  : displays the tutorial of R. Strand for Maxima.
  9.   Manual  : displays the multi-file html version of the Reference manual of Maxima.
  10.   Manual (1.htm)  : displays the mono-file html version of the Reference manual of Maxima. With this version, it is possible to search for all occurrences of a word in the whole manual (cf. sec. 5.1).
  11.   ManRef A4  : displays the English version of the Reference manual of Maxima in the navigator AsTeX. This version is adapted to printing (cf. sec. 3.3.3).
  12.   ManRef scr.  : displays the English version of the Reference manual of Maxima in the navigator AsTeX. This version is adapted to browsing on screen (cf. sec. 3.3.2).
  13.   << Tests com>>  : marker of the group of buttons << Tests communs>> (common tests). This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  14.   1+2  : add 1 and 2 in Xmaxima.
  15.   2*3  : multiply 2 by 3 in Xmaxima.
  16.   2^10  : calculate 2 to the power 10 in Xmaxima.
  17.   1/3+3/4  : add two fractions in Xmaxima.
  18.   100 !  : calculate the factorial of 100 in Xmaxima.
  19.   Quit 5.9  : quit the Xmaxima program.
  20.   Quit  : stop Maxima in Xmaxima.
  21.   << Tests spec>>  : marker of the group of buttons << Tests specific to the program>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  22.   diff  : calculate a derivative.
  23.   integrate  : calculate an indefinite integral.
  24.   describe  : displays help on all commands of Maxima that contain the chain of characters int (command describe(int);).
  25.   BROKEN Max.  : permits to come back to the prompt of Maxima when an error occurred.
  26.   << Tests btns>>  : marker of the group of buttons << Buttons under test>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.

8.1.2 Test of the buttons 

Under Windows 98SE, all tests work (including describe ).

8.1.3 Starter guide 

One can test the possibilities of Maxima from Xmaxima, by selecting the option Maxima / Run Tests (v5.9) or help / Run Tests (v5.5).

One can test commands of Maxima individually from the lower window of Xmaxima, by double-clicking on the commands displayed in blue. The calculation is executed in the upper window, and the result is displayed in the lower window, by replacing the rectangle RESULT , that follows immediately the command, with the actual result.

It is possible to modify the command and to restart the calculation.

With version 5.5 (Note : A bug in version 5.9 prevents this command from functioning.), it is also possible to add any Maxima command in the lower window and insert the result there. For example, one can insert 1+2 in the first line, between numerical computations and and graphics. The calculation can be run by selecting 1+2 with the mouse, clicking on the button edit then on the button maxima, and finally on mark for eval. 1+2 is then replaced by 1+2 evaluates to RESULT . The result can be calculated as previously, by double clicking on the command to launch (here 1+2), providing 1+2 evaluates to 3 in the lower window.

8.2 Toolbar ../../../icones/rosetta/mpdm02.gif (Alg\en\Mpdm02) 

 
../../../images/rosetta/en/pmupad.gif
Figure 8.2 The toolbar Alg\en\Mpdm02 (general purpose CAS).

8.2.1 Description of the buttons 

  1.   MUPAD Studio  : launches the program MuPAD Studio for Windows.
  2.   Ini Mupad St.  : launches the kernel of the program MuPAD Studio for Windows (it is necessary to run it at least once).
  3.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  4.   Web site  : displays the site of MuPAD in the default web browser.
  5.   Manual  : displays the reference manual of MuPAD in a specialized previewer of dvi files.
  6.   Manual A4  : displays the reference manual of MuPAD (without the figures) in Acrobat Reader. This version of the manual can be printed, contrary to the version displayed with the button Manual .
  7.   << Tests com>>  : marker of the group of buttons << Common tests>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  8.   1+2 : Add 1 and 2 in MuPAD Studio.
  9.   2*3 : Multiply 2 by 3 in MuPAD Studio.
  10.   2^10  : calculate 2 to the power 10 in MuPAD Studio.
  11.   1/3+3/4  : add two fractions in MuPAD Studio.
  12.   100 !  : calculate the factorial of 100 in MuPAD Studio.
  13.   Quit  : quit the program MuPAD Studio.
  14.   << Tests spec>>  : marker of the group of buttons << Tests specific to the program>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  15.   diff  : calculate a derivative in MuPAD Studio (id. Maxima).
  16.   integrate  : calculate an indefinite integral in MuPAD Studio (id. Maxima).
  17.   int sin(x) : Calculate the indefinite integral of sin(x) in MuPAD Studio.
  18.   int x^n : Calculate the indefinite integral of xn in MuPAD Studio.
  19.   New notepad : Create a new Notepad in MuPAD Studio.

8.3 Toolbar ../../../icones/rosetta/pari.gif (Alg\en\Pari) 

 
../../../images/rosetta/en/ppari.gif
Figure 8.3 The toolbar Alg\en\Pari (computer algebra in number theory).

8.3.1 Description of the buttons 

  1.   PARI  : launches the program PARI for Windows.
  2.   EMACS/ast  : launches the Emacs program for Windows from the directory ASTEXDIR (necessary to use the button Epari ).
  3.   Epari  : launches Pari in a shell of Emacs. Emacs must be already open. The command sent to the shell is runprg.bat pari.
  4.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  5.   Web site  : displays the site of Pari in the default web browser.
  6.   Loc web  : displays a local copy of the Pari site in the default web browser.
  7.   Tutorial  : displays the tutorial of Pari.
  8.   Manual  : displays the User's manual of Pari.
  9.   Refcard  : displays a summary of the main commands of Pari.
  10.   Manual html  : displays the html version of the Pari User's manual.
  11.   << Tests com>>  : marker of the group of buttons << Common tests>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  12.   1+2  : add 1 and 2 in Pari.
  13.   2*3  : multiply 2 by 3 in Pari.
  14.   2^10  : calculate 2 to the power 10 in Pari.
  15.   1/3+3/4  : add two fractions in Pari.
  16.   100 !  : calculate the factorial of 100 in Pari.
  17.   Quit  : quit the program Pari.
  18.   << Tests spec>>  : marker of the group of buttons << Tests specific to the program>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  19.   General help  : displays the list of chapters of Pari help (elementary and transcendental functions, functions for number theory, fields of numbers and elliptic curves, polynomials and series of powers, vectors, matrices, sums, products, integrals, graphics, programming).
  20.   ? Polynom.  : list of the functions of the class Polynomials in Pari.
  21.   (a+b)^2  : calculate the development of (a + b)2 in Pari.
  22.   factor poly  : factorise the polynomial 3x3 - 4x + 1 in Pari.
  23.   roots  : calculate the real and complex roots of the polynomial x3 + 1 in Pari.
  24.   taylor  : calculate the Taylor development of sin(x) in Pari.
  25.   integrate  : calculate the indefinite integral of u4-1
u-1 in Pari.
  26.   poly Tcheb.  : calculate the Tchebitchev polynomial of order 5.
  27.   ? Speical fns  : displays the list of special functions known to Pari.
  28.   ? besselk  : displays help on the K-Bessel function of index n.
  29.   besselk(n,x)  : calculate the value of the K-Bessel function of index 1 at point 2.
  30.   << Tests btns>>  : marker of the group of buttons << Buttons under test>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  31.   diff  : calculate the derivative of sin(x) in the form of a Taylor development.
  32.   integrate 2  : calculate the indefinite integral of sin(x) in the form of a Taylor development.
  33.   integrate 3  : calculate the indefinite integral of a rational fraction whose result can be expressed in terms of log and arc tangent (error a log/atan appears in the integration, PARI cannot handle that).
  34.   1+2 ?  : calculate 1+2 with an end of commands different from the one of the standard button 1+2 . Works in a command window of Win2000, but not in a shell of Emacs (requires to type on the Enter key after clicking on the button).
  35.   1+2 ??  : calculate 1+2 with an end of commands different from the one of the standard button 1+2 . Works in a command window of Win2000 (but by adding an empty line) and in a shell of Emacs.
  36.   Tutorial 2.0.5  : displays the tutorial of the former version 2.0.5 of Pari from a table of navigation.

8.3.2 Test of the buttons 

The end {ENTER}^c^c works correctly in a shell of Emacs. It also works in a command window of Win2000, but it produces a beep.

Under Windows 2000, all common and specific tests work.

8.3.3 Starter guide 

All test buttons work in a command window, under Windows 2000.

Remarques : One can scroll the previously typed commands (or the commands entered with the test buttons) with the help of the arrow keys Up-arrow and Down-arrow.

8.4 Toolbar ../../../icones/rosetta/singular.gif (Alg\en\Singular) 

 
../../../images/rosetta/en/psingula.gif
Figure 8.4 The toolbar Alg\en\Singular (computer algebra on polynomials).

8.4.1 Description of the buttons 

  1.   SINGULAR  : launches the SINGULAR program for Windows.
  2.   EMACS/ast  : launches the Emacs program for Windows from the directory ASTEXDIR (necessary to use the button Esingular ).
  3.   Esingular  : launches Singular in a shell of Emacs. Emacs must be already open. The command sent to the shell is runprg.bat singular.
  4.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  5.   Web site  : displays the site of Singular in the default web browser.
  6.   Loc web  : displays a local copy of the site of Singular in the default web browser.
  7.   Manual html  : displays the User's manual of Singular in html form.
  8.   Manual hlp  : displays the User's manual of Singular in the form of a Windows help.
  9.   << Tests com>>  : marker of the group of buttons << Common tests>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  10.   1+2  : add 1 and 2 in Singular.
  11.   2*3  : multiply 2 by 3 in Singular.
  12.   2^10  : calculate 2 to the power 10 in Singular.
  13.   1/3+3/4  : add two fractions in Singular.
  14.   100 !  : calculate the factorial of 100 in Singular.
  15.   Quit  : quit the Singular program.
  16.   << Tests spec>>  : marker of the group of buttons << Tests specific to the program>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  17.   << Tests btns>>  : marker of the group of buttons << Buttons under test>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  18.   XSINGULAR?  : launches Singular in Xemacs (installation not yet operational).

8.4.2 Test of the buttons 

The end {ENTER}^c^c works well in a shell of Emacs, but provokes an error in a command window of Win2000. On the other hand, the end {ENTER}^{ENTER} works in Emacs (while producing a beep however) and in a command window of Win2000.

8.5 Toolbar ../../../icones/rosetta/yacas.gif (Alg\en\Yacas) 

 
../../../images/rosetta/en/pyacas.gif
Figure 8.5 The toolbar Alg\en\Yacas (general purpose CAS).

8.5.1 Description of the buttons 

  1.   YACAS  : launches the YACAS program for Windows.
  2.   EMACS/ast  : launches the Emacs program for Windows from the directory ASTEXDIR (necessary to use the button boutonEyacas).
  3.   Eyacas  : attempts to launch Yacas in a shell of Emacs. Emacs must be already open. The command sent to the shell is runprg.bat yacas. Yacas cannot be launched in this way (error invalid Handle).
  4.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  5.   Web site  : displays the site of Yacas in the default web browser.
  6.   Loc web  : displays a local copy of the site of Yacas in the default web browser.
  7.   Tutorial  : displays the tutorial of Yacas.
  8.   Manuals  : displays the manuals of Yacas.
  9.   << Tests com>>  : marker of the group of buttons << Common tests>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  10.   1+2  : add 1 and 2 in Yacas.
  11.   2*3  : multiply 2 by 3 in Yacas.
  12.   2^10  : calculate 2 to the power 10 in Yacas.
  13.   1/3+3/4  : add two fractions in Yacas.
  14.   100 !  : calculate the factorial of 100 in Yacas.
  15.   Quit  : quit the Yacas program.
  16.   << Tests spec>>  : marker of the group of buttons << Tests specific to the program>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  17.   (a+b)^2  : expands the polynomial (a + b)2 in Yacas.
  18.   factor poly  : factorise the polynomial x2 - 1 in Yacas.
  19.   diff  : calculate the derivative of sin(x) in Yacas.
  20.   taylor  : calculate the Taylor development of cos(x) in Yacas.
  21.   Examples  : launches randomly the calculation of one of the examples of Yacas.
  22.   << Tests btns>>  : marker of the group of buttons << Buttons under test>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  23.   factor poly 2?  : other example of factorisation of polynomials.
  24.   YACAS d  : launches Yacas directly (without using a batch file).

8.5.2 Test of the buttons 

Under Windows 2000  :

  1.  All common and specific button tests work in a command window.
  2.  Yacas doesn't work in a shell of Emacs (error ?Invalid Describer?).

8.6 Toolbar ../../../icones/rosetta/aldor2.gif (Alg\en\Aldor) 

 
../../../images/rosetta/en/paldor.gif
Figure 8.6 The toolbar Alg\en\Aldor (development of libraries for Axiom).

8.6.1 Description of the buttons 

  1.   ALDOR  : no action done (the Aldor compiler is not yet available for Windows).
  2.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  3.   Web site  : displays the site of Aldor in the default web browser.
  4.   Loc web  : displays a local copy of the site of Aldor in the default web browser.

8.7 Toolbar ../../../icones/rosetta/axiom2.gif (Alg\en\Axiom) 

 
../../../images/rosetta/en/paxiom.gif
Figure 8.7 The toolbar Alg\en\Axiom (General purpose CAS strongly typed).

8.7.1 Description of the buttons 

  1.   AXIOM  : no action done (the Axiom program is not yet available in free version).
  2.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  3.   Web site orig  : displays the former site of T. Daly on Axiom in the default web browser.
  4.   Web site  : displays the site of Axiom in the default web browser.
  5.   Loc web  : displays a local copy of the site of Axiom in the default web browser.

8.8 Toolbar ../../../icones/rosetta/cln2.gif (Alg\en\CLN) 

 
../../../images/rosetta/en/pcln.gif
Figure 8.8 The toolbar Alg\en\Cln (C++ library for numbers).

8.8.1 Description of the buttons 

  1.   CLN  : no action (CLN is a library).
  2.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  3.   Web site  : displays the site of CLN in the default web browser.
  4.   Loc web  : displays a local copy of the site of CLN in the default web browser.

8.9 Toolbar ../../../icones/rosetta/docon2.gif (Alg\en\Docon) 

 
../../../images/rosetta/en/pdocon.gif
Figure 8.9 The toolbar Alg\en\DoCon (general purpose CAS based on Haskell).

8.9.1 Description of the buttons 

  1.   DOCON  : no action (the DoCon program for Windows is not yet installed).
  2.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  3.   Web site  : displays the site of DoCon in the default web browser.
  4.   Loc web  : displays a local copy of the site of DoCon in the default web browser.

 

Chapter 9 Toolbars of the Alg-3 group 

This chapter describes the buttons of the various toolbars of the group Alg-3 created for the Rosetta CD-ROM for Windows.

9.1 Toolbar ../../../icones/rosetta/foc2.gif (Alg\en\Foc) 

 
../../../images/rosetta/en/pfoc.gif
Figure 9.1 The toolbar Alg\en\Foc (environment for certified computer algebra calculations).

9.1.1 Description of the buttons 

  1.   FOC  : no action (the program Foc for Windows is not yet installed).
  2.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  3.   Web site  : displays the site of Foc in the default web browser.
  4.   Loc web  : displays a local copy of the Foc site in the default web browser.

9.2 Toolbar ../../../icones/rosetta/ginac2.gif (Alg\en\Ginac) 

 
../../../images/rosetta/en/pginac.gif
Figure 9.2 The toolbar Alg\en\GiNaC (C++ library for computer algebra).

9.2.1 Description of the buttons 

  1.   GINAC  : no action done (GINAC is a library).
  2.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  3.   Web site  : displays the site of Ginac in the default web browser.
  4.   Loc web  : displays a local copy of the site of Ginac in the default web browser.

9.3 Toolbar ../../../icones/rosetta/gmp2.gif (Alg\en\Gmp) 

 
../../../images/rosetta/en/pgmp.gif
Figure 9.3 The toolbar Alg\en\Gmp (multiprecision library).

9.3.1 Description of the buttons 

  1.   GMP  : no action done (GMP is a library).
  2.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  3.   Web site  : displays the site of Gmp in the default web browser.
  4.   Loc web  : displays a local copy of the site of Gmp in the default web browser.

9.4 Toolbar ../../../icones/rosetta/magnus2.gif (Alg\en\Magnus) 

 
../../../images/rosetta/en/pmagnus.gif
Figure 9.4 The toolbar Alg\en\Magnus (computer algebra in infinite groups).

9.4.1 Description of the buttons 

  1.   MAGNUS  : no action (MAGNUS has not been ported under Windows).
  2.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  3.   Web site  : displays the site of Magnus in the default web browser.
  4.   Loc web  : displays a local copy of the site of Magnus in the default web browser.

9.5 Toolbar ../../../icones/rosetta/mpfr2.gif (Alg\en\Mpfr) 

 
../../../images/rosetta/en/pmpfr.gif
Figure 9.5 The toolbar Alg\en\Mpfr (Library for computer algebra).

9.5.1 Description of the buttons 

  1.   MPFR  : no action done (MPFR is a library).
  2.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  3.   Web site  : displays the site of Mpfr in the default web browser.
  4.   Loc web  : displays a local copy of the site of Mpfr in the default web browser.

9.6 Toolbar ../../../icones/rosetta/ntl2.gif (Alg\en\Ntl) 

 
../../../images/rosetta/en/pntl.gif
Figure 9.6 The toolbar Alg\en\Ntl (C++ library for number theory).

9.6.1 Description of the buttons 

  1.   NTL  : no action done (NTL is a library, cf. also GiNaC).
  2.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  3.   Web site  : displays the site of Ntl in the default web browser.
  4.   Loc web  : displays a local copy of the site of Ntl in the default web browser.

9.7 Toolbar ../../../icones/rosetta/sumit2.gif (Alg\en\Sumit) 

 
../../../images/rosetta/en/psumit.gif
Figure 9.7 The toolbar Alg\en\Sumit (library for systems of linear differential equations).

9.7.1 Description of the buttons 

  1.   SUMIT  : no action done (the version of SUMIT for Windows is not yet included on the Rosetta CD-ROM for Windows ?check existence?).
  2.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  3.   Web site  : displays the site of Sumit in the default web browser.
  4.   Loc web  : displays a local copy of the site of Sumit in the default web browser.

9.8 Toolbar ../../../icones/rosetta/synaps2.gif (Alg\en\Synaps) 

 
../../../images/rosetta/en/psynaps.gif
Figure 9.8 The toolbar Alg\en\Synaps (Environment for numeric and symbolic computations).

9.8.1 Description of the buttons 

  1.   SYNAPS  : no action done (not available for Windows).
  2.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  3.   Web site  : displays the site of Synaps in the default web browser.
  4.   Loc web  : displays a local copy of the site of Synaps in the default web browser.

9.9 Toolbar ../../../icones/rosetta/zen2.gif (Alg\en\Zen) 

 
../../../images/rosetta/en/pzen.gif
Figure 9.9 The toolbar Alg\en\Zen (C library for computations on finite rings).

9.9.1 Description of the buttons 

  1.   ZEN  : no action done (ZEN is a library).
  2.   << Doc>>  : marker of the group of buttons << Documentation>>. This button doesn't execute any action, it serves just as visual separator between the groups of buttons.
  3.   Web site  : displays the site of Zen in the default web browser.
  4.   Loc web  : displays a local copy of the Zen site in the default web browser.

 

Chapter 10 Troubleshooting 

This chapter explains how to solve some problems that you could meet during the installation or the use of the Rosetta CD-ROM.

10.1 Environment variables not defined 

Q : When I click on some buttons of the assistant, I get an error message of the type Commande %%rosetbas%%\xxx inexécutable.

R : Verify that the environment variables used by Rosetta (ROSETBAS, ASTEXDIR, ASTEXBAS and HOME) are defined correctly and are read. They are defined in C:\autoexec.bat for all versions of Windows: check in this file that they are correctly registered, and that there is no instruction that prevents to read them, just before the place where they are defined (for example a transfer to another batch program).

For Windows NTx, the environment variables are moreover recorded in the registry database. Verify that they have the correct values, from the configuration panel of Windows.

10.2 The strip of assistant Rosetta is not displayed 

Q : When I click on the icon Assistant Rosetta, the assistant's strip doesn't appear, and I get an error message.

R : If you work under Windows 95, it can happen that, when launching assistant Rosetta, you get the message aastex.exe Un périphérique attaché au système ne fonctionne pas correctement (?A device attached to the system doesn't function correctly?),
../../../images/rosetta/w95err01.gif
then a second message Le fichier msvbvm50.dll est lié à une exportation manquante (The msvbvm50.dll file is bound to a missing export ??)
../../../images/rosetta/w95err02.gif
These messages indicate that some Windows libraries, necessary to the execution of assistant AsTeX, are too old or are not installed (they appear in Windows 98, ME, 2000 and XP, but not in grass-roots Windows 95). To install them or update them, launch the complete installation program of assistant AsTeX. To this end, open the folder Rosetta on the desktop and double click on the icon Install Assistant AsTeX (cf. Fig. 2.2).

Si vous obtenez le message L'installation ne peut continuer parce que certains de vos fichiers système sont périmés (?The installation cannot continue because some of your system files are obsolete?)
../../../images/rosetta/w95err03.gif
click on the button OK to launch the update of these files. A last message of information is displayed:
../../../images/rosetta/w95err04.gif
Click on the button Yes to restart Windows. After restarting the PC, try to restart the assistant by clicking on the button Assistant Rosetta. If you get the message Le composant anibtn32.ocx n'est pas enregistré correctement (The anibtn32.ocx component is not recorded correctly):
../../../images/rosetta/w95err05.gif
launch the assistant's installation program a second time, while proceeding as above. This will install the Windows libraries that are missing on your hard disk and will record them correctly in the registry database of Windows.

To verify that the installation is finished, click on the icon Assistant Rosetta of the desktop. Normally, the assistant's strip ought to appear. If it does not, refer to the part Troubleshooting of the installation manual of AsTeX.

The above procedure installs a complete copy of assistant AsTeX on the hard disk. The latter is fully functional only when the AsTeX distribution is installed, and it is not used with the Rosetta CD-ROM (only the Windows libraries are used). You can therfore uninstall this copy, if you don't use the AsTeX distribution and that you wish to free a little room on the hard disk. To this end, launch the standard uninstallation procedure of Windows (configuration panel of Windows, icon Addition / Suppression de programmes (?adding / deleting programs?)), select the element Aastex, click on the button Ajouter/Supprimer (?Add/Delte?) then, in the toolbar Composants partagés (?shared components?), click on the button Ne rien retirer (?nothing to withdraw?) to keep the libraries. Once the logical uninstallation is done, there remains to suppress the directory C:\ast on the hard disk, and to restart the installation of the Rosetta CD-ROM to reinstall the few files of this directory used by the Rosetta distribution.

Attention : If you use the AsTeX distribution, do not destroy the directory C:\ast.

10.3 Navigator AsTeX is not displayed 

Q : Under Windows NT 4.0, the Navigator AsTeX is not displayed.

R : With grass-roots Windows NT 4.0 (that is, without a recent copy of Service Pack installed), the assistant runs correctly, but the Navigator doesn't. .

To verify if it is your case, double click on the icon ../../../icones/rosetta/calfor01.gif (Generalities about computer algebra) in the assistant's strip (second icon from the left). This opens a toolbar entitled Alg\Calfor01 (cf. sec. 7.2). Click on the button Man Util Ros écr. of this toolbar.

If nothing happens, close all programs other than assistant AsTeX and click on the button Ini Navig of the toolbar ../../../icones/rosetta/calfor01.gif . This will install the more recent libraries required for the execution of navigator AsTeX. In the case where the button Ini Navig would not function, you can open the folder Rosetta on the desktop and double click on the icon Install Navigateur AsTeX (Fig. 2.2). Another possibility is to double click on the program setup.exe in the directory astexdis\navig of the CD-ROM, from Windows Explorer.

10.4 Erreur système under Windows NT 4.0 

Q : I clicked on the button Roset NavEcr of the toolbar ../../../icones/rosetta/calfor01.gif of the assistant to display the Rosetta document, but I get the message
../../../images/rosetta/tstros04.gif
R : First click on the button Init Navig of the toolbar ../../../icones/rosetta/calfor01.gif to install the libraries that are missing from grass-roots Windows NT 4.0 to launch Navigator AsTeX (cf. sec. 10.3).

10.5 Display with Gsview under Windows NTx 

Q : I work under Windows NT. I tried to display the Rosetta document in Gsview. To this end, I clicked on the button Roset NavEcr , then I selected the element Gsview of the navigator AsTeX pull down list. But I get the message
../../../images/rosetta/tstros05.gif
R : Close the toolbar and quit the cycle of questions asked by Gsview, by clicking on the buttons OK of the boxes of information, and Cancel of the configuration boxes. Then click on the button Ini Gsview NT of the toolbar ../../../icones/rosetta/calfor01.gif Généralités sur le calcul formel (Generalities about computer algebra), cf. sec. 2.4.

You can then restart the display of the Rosetta document from the GSview element of navigator AsTeX.

10.6 Incompatibility between JS Pager and assistant Rosetta 

Q : I installed the manager of virtual desktops JS Pager, and I don't succeed anymore to enter the tests of computer algebra from the buttons of assistant Rosetta.

R : Refer to section 4.9.2 to solve the problem. If the proposed solutions don't suit your needs use VirtuaWin instead, as it doesn't have this problem of compatibility.

10.7 Problem with navigator AsTeX and Acrobat Reader under Windows 98 and 2000 

Q : Under Windows 98 (resp.  Windows 2000), when I click on an element of the navigation table, the corresponding page is not selected in Acrobat Reader.

R : There are two possibilities to get round this problem:

  1.  Use GSview to display the pdf file, instead of Acroat Reader.
  2.  Click four times on the element (instead of two) in Navigator AsTeX then click on the button ../../../images/navig/nvhista.gif (History).

10.8 Message LireProgsExt: Je n'ai pas trouvé le fichier (I did'nt find the file) 

Q : During initialization time, I get the message  :
../../../images/rosetta/aaserr01.gif
then the assistant opens up, but I don't have the first three buttons Alg-1 , Alg-2 and Alg-3 .

R : One of the initialization files maybe has been damaged or destroyed. Copy the files *ros* of directory astexdis\a_copier\astex\assist of the CD-ROM into the directory C:\ast\astex\assist of your hard disk. If you are under Windows NTx, check that you have write access to this directory.

10.9 Message multiple versions of cygwin1.dll 

Q : I tried to launch Macaulay by typing macaulay in the window Invite Rosetta Win9x, but it refuses to run and I get the message:
 *** Shared region version mismatch.
 Version 1F != 27.
 Are you using multiple versions of cygwin1.dll?
 Run 'cygcheck -r -s -v' to find out.
R : Verify that you didn't launch, in another window, another program that also uses Cygwin, but in another version. Under Win9x, Gap and Macaulay cannot be launched at the same time in two various windows.

10.10 Inhibit the display of manuals 

Q : When I launch a program, the documentation is always displayed at the same time. How to prevent it?

R : Open the file ASTEXDIR\rosetpar.bat and set the value of the variable VDOCHTM to N (in fact, something else than Y).

10.11 The buttons of the toolbars are minuscule (mod. 21/04/2003) 

Q : The buttons of the assistant Rosetta toolbars are minuscule.

R : Install a more recent version of the common controls of Windows. They can be installed from the CD-ROM (auto - installable file 50ComUpd.exe, directory astexdis\win32) or downloaded from the site of Microsoft. It is also possible to install assistant AsTeX on your hard disk, from the icon Rosetta / Setups / Assistant AsTeX.

10.12 Some buttons Loc web don't work 

Q : Some buttons Loc web don't work.

R : Many html files on web sites have an extension .html. It is possible that only the files with extension .htm are associated to your web browser. If that is the case, select a file of extension .html in the Windows Explorer (for example calc.html in the directory ROSETTA\ast\websites\alg\calc\web of the CD-ROM) and double click on this file. This opens a dialog box with a list of programs to associate. Select your default web navigator or, if there is none, select Nestscape on the CD-ROM (file ROSETTA\ast\view\Netscape\Program\netscape.exe, cf. sec. 4.11.1).

If that does not solve the problem, verify the installation of your web browser; verify if the files with extension .htm and .html are associated to a browser which is always accessible.

10.13 Message Le programme Rosetta n'est pas ouvert (The Rosetta program is not opened) 

Q : I launched a computer algebra program in a shell of Emacs, but the test doesn't work, I get the message Le programme Rosetta n'est pas ouvert (The program Rosetta is not opened).

R : Open the options box of assistant Rosetta (button ../../../images/assist/heart01.gif ) of the strip, select emacs@ in the pull down list Titre de la fenêtre (Title of the window) and click on the button Confirmer (Confirmer).

10.14 Message Le programme emacs@ n'est pas ouvert (The program emacs@ is not opened) (mod. 21/04/2003) 

Q : I launched a computer algebra program in a command window of Windows NTx, but the test buttons don't work, I get the message Le programme emacs@ n'est pas ouvert.

R : Open the Options box of assistant Rosetta (button ../../../images/assist/heart01.gif of the strip), select Rosetta in the pull down list Titre de la fenêtre (Title of the window) and click on the button Confirmer (cf. sec. 4.4).

10.15 The Macaulay program cannot be launched 

Q :

The Macaulay program cannot be launched.

R : Click on the button Ini Macaulay of the toolbar Alg\Macaulay. Normally, this is done automatically when you test the installation of computer algebra programs from the button TEST SCF .

10.16 The computer algebra program doesn't appear in Emacs 

Q : I typed Ctrl-X 0 as indicated in section 3.4, but the computer algebra program disappeared instead of occupying the whole window.

R : You probably clicked on the bottom part of the window of Emacs before typing Ctrl-X 0: this command suppresses the part that is selected. For the buffer in which the program is executed to be displayed again, select the option Buffers /  Asynch Shell Command (cf. also the user's manual of Emacs).

10.17 The access to xxx .apd has been refused 

Q : I wanted to modify under editor the file *.apd of a toolbar by clicking on the button Éditer boutons (Edit buttons) of the Options box of the assistant. But when I wanted to save the modification, I got the message The access to xxx.apd has been refused:
../../../images/rosetta/panerr01.gif
R : It is necessary to copy first the file *.apd of the CD-ROM on the hard disk. To this end, open the dialog box Options of the assistant and select the tab Panneau (Toolbar). In the assistant's strip, click on the button of the toolbar that you want to modify. Then, in the box of options, click on the button Sauver (Save). This creates a copy of the file xxx.apd on your hard disk, that you can modify subsequently. Without this preliminary operation, the button Éditer boutons (Edit buttons) opens the original file in Wordpad, and the latter tried to save the modifications on the CD-ROM.

10.18 ASTEXDIR is defined incorrectly under Windows 2000 (mod. 07/05/2003) 

Q : The value of ASTEXDIR is taken systematically equal to c:\ast\astex.

R : This is a bug of version 1.0b, that was corrected in version 1.0c (cf. History). One can either delete the variable ASTEXDIR from the configuration panel of Windows (the value is defined correctly in autoexec.bat) or register the correct value in the configuration manel (i.e. the one defined in the autoexec.bat), then restart the machine so that the modification can be taken into account.

 

Chapter 11 History 

This chapter draws up the history of the modifications of the Rosetta CD-ROM for Windows.

11.1 Rosetta 1.0c (07/05/2003) 

Version 1.0c provides the following corrections or modifications to version 1.0b :

11.2 Rosetta 1.0b (24/04/2003) 

The version 1.0b provides the following corrections or modifications to version 1.0a :

11.3 Rosetta 1.0a (14/04/2003) 

The version 1.0a is the first version of the Rosetta CD-ROM for Windows distributed publicly.

11.4 Rosetta 0.9a (05/08/2002) 

The version 0.9a alpha is the first version of the Rosetta CD-ROM for Windows (distributed only internally).