EiffelStudio: an EiffelSoftware project - User contributions [en]

User:Pvrohr

2006-06-21T04:36:17Z

Pvrohr: /* M2 June 16, 2006 */

== Compiling EiffelStudio on WinXP: ==
This section summarizes the so far rather painful process of compiling EiffelStudio. The platform for which the following description applies is MS Windows XP SP2 using the [http://download.microsoft.com/download/a/5/f/a5f0d781-e201-4ab6-8c6a-9bb4efed1e1a/PSDK-x86.exe MSDN PSDK-x86.exe] and the free MS C-compiler. The system was set up according to the description which can be found at: [[http://eiffelsoftware.origo.ethz.ch/index.php/Windows_32-bit_C_compiler]].

The compilation process follows the basic steps described at:
[[http://eiffelsoftware.origo.ethz.ch/index.php/Compiling_EiffelStudio]].

=== Milestones ===
==== M1 June 12, 2006 ====
Installed the new release 5.7.59395 announced at [[http://origo.ethz.ch/pipermail/es-devel/2006-June/000305.html]]

Modified the automatic build scripts[[http://eiffelsoftware.origo.ethz.ch/index.php/Automatic_Build_Scripts]].

This led to a version of EiffelStudio that was able to create new basic projects. For some mysterious reasons the debugger worked also for simple projects, but nobody else could replicate this. Hence, it is not clear whether this debugger version was running correctly.

==== M2 June 16, 2006 ====
'''Step -1''': Installed new release 5.7.59623 because it was recommended on es-devel and the previous version began to choke on current checkouts.

'''Step 0''': Setting the environment variables:

<pre>
rem ******
rem Cygwin
rem ======
set PATH=%PATH%;C:\cygwin\bin

rem ************
rem EiffelStudio
rem ============
rem General Eiffel path
set EIFFEL_PATH=%CD%
rem Eiffel source directory
set EIFFEL_SRC=%EIFFEL_PATH%\57dev
rem Eiffel delivery directory
set EIFFEL_DELIVERY=%EIFFEL_PATH%\57comp

rem *********
rem ISE Paths
rem =========
set ISE_EIFFEL=C:\Programme\Eiffel57\59623
set ISE_PLATFORM=windows
set ISE_C_COMPILER=msc
set ISE_LIBRARY=%EIFFEL_SRC%

rem **********
rem Subversion
rem ==========
rem SVN checkout URL
set SVNURL=https://eiffelsoftware.origo.ethz.ch/svn/es
</pre>

'''Step 1''': svn checkout
<pre>
svn co %SVNURL%/branches/soft-arch/Src 57dev
svn co %SVNURL%/branches/soft-arch/Delivery 57dev/Delivery
svn co %SVNURL%/branches/soft-arch/free_add_ons 57dev/free_add_ons

rem the following update is also extended by revision number
cd 57dev
svn up
svn up free_add_ons
svn up Delivery
</pre>

'''Step 2''': gobo extraction
<pre>
cd %EIFFEL_SRC%\library

set file_cygwin=/cygdrive/%EIFFEL_SRC::=%/free_add_ons/gobo/gobo_34_win.tgz
set file_cygwin=%file_cygwin:\=/%

bash -c "tar -xvzf %file_cygwin%"
</pre>

'''Step 3''': Compile Run-Time
<pre>
cd %EIFFEL_SRC%/C
call configure win32 m
</pre>

'''Step 4''': Compile Libraries
<pre>
cd %EIFFEL_SRC%/library/net/Clib
svn up %REVNRSTR%
call make_msc.bat

cd %EIFFEL_SRC%/library/vision2/Clib
svn up %REVNRSTR%
call make_msc.bat

cd %EIFFEL_SRC%/library/wel/Clib
svn up %REVNRSTR%
call make_msc.bat
</pre>

'''Step 5''': Compile C-Libraries
<pre>
cd %EIFFEL_SRC%/C_library/zlib
call make_msc.bat

cd %EIFFEL_SRC%/C_library/libpng
call make_msc.bat
</pre>

'''Step 6''': Compile Compiler
<pre>
cd %EIFFEL_SRC%/Eiffel/library/cli_writer/Clib
nmake
</pre>

'''Step 7''': Compile EiffelStudio
<pre>
cd %EIFFEL_SRC%\Eiffel\Ace
"%ISE_EIFFEL%\studio\spec\windows\bin\ec.exe" -config ec.ecf -target bench -c_compile

echo Running finish_freezing.exe...
cd "%EIFFEL_SRC%\Eiffel\Ace\EIFGENs\bench\W_code"
"%ISE_EIFFEL%\studio\spec\windows\bin\finish_freezing.exe"
</pre>

'''Conclusion''': Unfortunately doing the above on Revision 59860 produces a version that cannot create new base projects.

==== M3 June 21, 2006 ====
Recompiling Revision 59930 did not solve the above problem, but this version should be sufficient for the whole project.

I uploaded all the compile scripts that I used somewhere on my [[http://n.ethz.ch/student/pvrohr/Courses/S4/SA/project/scripts/ website]]. As Volkan correctly mentioned, they are not tested. All I can say is that they worked for me, and I am not giving any warranty for whatsoever. If you still want to try them, unzip them into a new directory. Then all you have to do is change the path to ISE_EIFFEL in 0_set_env_vars.bat. And the rest will all happen in the current directory. If you have problems, please let me know.

I also added a feature switch button to the new class wizzard in eb_create_class_dialog.e. The button is not yet connected to the feature wizzard. The changed class file is available [[http://n.ethz.ch/student/pvrohr/Courses/S4/SA/project/classes/eb_create_class_dialog.e here]]. I also put up the svn [[http://n.ethz.ch/student/pvrohr/Courses/S4/SA/project/classes/eb_create_class_dialog.diff diff]] output compared to the original version.

User:Pvrohr

2006-06-16T12:37:27Z

Pvrohr: /* M2 June 16, 2006 */

User:Pvrohr

2006-06-16T11:15:58Z

Pvrohr: /* Compiling EiffelStudio on WinXP: */

Advanced Class and Feature Wizard

2006-06-05T11:29:48Z

Pvrohr: /* Team */

[[Category:Projects]]
=Overview=

As a summary we could say that we improve the usability of the most important wizards, e.g. classwizard and featurewizard, by adding new features, extending the user interface and simplifying the handling.

Following the priority list of our project, beginning with the most important aspect of our work

* editor based wizard execution
* combobox for post- and precondition
* pick & drop
* undo/redo functionality within the wizard
* docking the wizard in a fixed window - not a pop-up anymore
* update permanently the editor while using the wizard
* tooltips which provides help
* beginner-tour

=Work=

Right now, we are occupied with:

* compiling ES on Linux systems
* supplying work to every member of the team

==Problems==

* cannot open projects in ES (waiting for new release/build)

==TO-DO==

* ...

=Milestones=

==M1: April 30, 2006 ==

* editing wikipage
* ES compiled on windows/linux-x86

=Project Details=

==Editor Based Wizard Execution==

===Motivation===

Wizards are usually only accessible through a GUI Window. This is convenient for beginners, but will slow down advanced programmers.
So there should be a possibility to access the wizard through the editor directly with an interface similar to a command line interface.

===Idea===

To execute the wizard within the editor you have to do the following:

* Write the command (possibly over some lines)
* Press a hotkey to execute the command

Which hotkey we use is to be determined.

The goal of the language to express the commands is to be as short and fast typeable as possible. Therefore it refrains from using charactes for which multiple keys must be pressed. As reference, the US-English and Swiss-German keyboard layout is used.
The slash '/' is not a one key character on the Swiss-German keyboard, so it can be substituted by '$'

Since the command is only an intermediate format, structure and readability are not considered first priority here.
===Example===

To create class TEST which is deferred you have to do the following:

* Write "/c test,d ."
* Press the hotkey

Create a class COMPLEX with features real, imag, add and mult, arguments of add and mult are not void by precondition:
* Write
/c complex 
d read 
d imag 
1d add complex toadd,n 
1d mult complex tomult,n 
.
* press the Hotkey

===Lexical Analysis===

Token seperators:
* Whitespaces (' ','\n','\r','\t')
* ','
* '/'
* '$' (for Swiss-German keyboards)
The last three are tokens themselves, whitespaces are discarded

Note: '.' does '''not''' seperate tokens.

===Syntax===

As the project is still in a starting phase, the information here is incomplete and could be changed.

The syntax is made easy to parse, since we have not much experience with parsers.

'##' means that the two symbols have no whitespace bewteen

These symbols represent a stream of tokens:

* wizardExecBlock ::= blockStartChar classCreate {featureCreate}* blockEndChar
* classCreate ::= [num_of_parents] ## 'c' className [inheritance-list] [','attribute_list]
* inheritance-list ::= {inheritance_clause}*
* inhertitance_clause ::= {identifier [',' attribute_list]}+
* className ::= identifier
* featureCreate ::= [num_of_arguments] ## return_type name {argument_type argument_name}* [','attribute_list]
* return_type, argument_type ::= type
* name, argument_name ::= identifier

These symbols represent one token:

* blockStartChar ::= '/' | '$'
* blockEndChar ::= '.'
* type ::= {'.' attribute}* identifier [',' attribute_list]
* identifier ::= {letter}*
* attribute_list ::= {attribute}+
* attribute ::= letter
* letter ::= 'a'..'z'
* number ::= digit+
* digit ::= '0'..'9'

===Explanation===

*Feature creation:
** If num_of_arguments if not given, the feature is a attribute, otherwise it's a method.
** If return type is 'v'='void' then it's a procedure.
** Some mappings/abbreviations from heavily used types are intended. For example 'i'='integer', 's'='string', 'd'='double', 'f'='real'
* Class names are automatically converted to uppercase (it's easier to write all in lowercase)

===Working on===

* Specify how to do lexical analysis.

=Team=

* [[User:Volkan|Volkan Arslan]] (Advisor)
* [[User:Chr1s| Christoph Lins]] (project leader)
* [[User:Haan| Andreas Hasler]] (working on updating permanently the editor while using the wizard)
* [[User:Thertli| Timon Hertli]] (working on editor based wizard execution)
* [[User:Pvrohr| Peter von Rohr]] (working on beginner-tour / tooltips)
* [[User:DavidFlatz| David Flatz]]
* Damien Müllhaupt (docking the wizard)
* Patricio Ronc

if you have questions or constructive criticism concerning our project and this wiki-page then write an Email to the project leader or just join our mailinglist:

es-wiz 'at' origo '.' ethz '.' ch

User:Pvrohr

2006-06-05T11:28:12Z

Pvrohr:

== Compiling EiffelStudio on WinXP: ==
The compilation process follows the basic steps described at:
[[http://eiffelsoftware.origo.ethz.ch/index.php/Compiling_EiffelStudio]].

Installed the new release 5.7.59395 announced at [[http://origo.ethz.ch/pipermail/es-devel/2006-June/000305.html]]

Modified the automatic build scripts[[http://eiffelsoftware.origo.ethz.ch/index.php/Automatic_Build_Scripts]].