Environment Variables - Revision history

Manus at 01:20, 9 July 2016

2016-07-09T01:20:31Z

← Older revision		Revision as of 01:20, 9 July 2016
Line 34:		Line 34:

	* '''ISE_C_COMPILER''': The noted and installed C compiler used by the Eiffel compiler to perform C/C++ compilation and to locate the compatible external libraries. Below is a list of compatible C compiler names:		* '''ISE_C_COMPILER''': The noted and installed C compiler used by the Eiffel compiler to perform C/C++ compilation and to locate the compatible external libraries. Below is a list of compatible C compiler names:
	** ''msc'': Any supported [[Installing Microsoft C compiler\|Microsoft Visual C/C++]] compiler.		** ''msc'': Any supported [[Installing Microsoft C compiler\|Microsoft Visual C/C++]] compiler prior to Visual Studio C++ 2015.
			** ''msc_vc140'': Visual Studio C++ 2015 or later.
	** ''mingw'': The open source [http://www.mingw.org MinGW] C/C++ compiler, which at the time of writing is only available as a stable release for x86.		** ''mingw'': The open source [http://www.mingw.org MinGW] C/C++ compiler, which at the time of writing is only available as a stable release for x86.
	** ''bcb'': The Free Borland 5.5 C++ compiler which is now deprecated and should not be used.		** ''bcb'': The Free Borland 5.5 C++ compiler which is now deprecated and should not be used.

Manus at 17:09, 2 May 2014

2014-05-02T17:09:00Z

← Older revision		Revision as of 17:09, 2 May 2014
Line 1:		Line 1:
	[[:Category:EiffelStudio\|EiffelStudio]]/Eiffel compiler utilizes a number of environment and other localized variables. This page is dedicated to those variables, how they are defined and what they mean.		[[:Category:EiffelStudio\|EiffelStudio]]/Eiffel compiler utilizes a number of environment and other localized variables. This page is dedicated to those variables, how they are defined and what they mean.

	{{Note\|There is a special notion called "[[LinuxUnixLayout\|Unix Layout]]" in regards to special builds of [[:Category:EiffelStudio\|EiffelStudio]]. When using a [[LinuxUnixLayout\|Unix layout]] '''no environment variables''' are ~~utilized~~ because of the fragmented distribution of installed files. For such layouts this page provides no contribution to understanding [[:Category:EiffelStudio\|EiffelStudio]].		{{Note\|There is a special notion called "[[LinuxUnixLayout\|Unix Layout]]" in regards to special builds of [[:Category:EiffelStudio\|EiffelStudio]]. When using a [[LinuxUnixLayout\|Unix layout]] '''no environment variables''' are used because of the fragmented distribution of installed files. For such layouts this page provides no contribution to understanding [[:Category:EiffelStudio\|EiffelStudio]].

	Unix layouts are ~~utilized~~ by package managers. See [[Linux Packages\|here]] for supported package managers.}}		Unix layouts are used by package managers. See [[Linux Packages\|here]] for supported package managers.}}

	Unless otherwise stated, all the following environment variables are known by the Eiffel environment at run time.		Unless otherwise stated, all the following environment variables are known by the Eiffel environment at run time.

Manus: /* Windows Variables */

2014-05-02T17:08:20Z

Windows Variables

← Older revision		Revision as of 17:08, 2 May 2014
Line 33:		Line 33:
	Under Microsoft's Windows an extra variable is required, dictating the external C compiler used by the Eiffel environment. Like the core variables, this variable must be defined in order for an Eiffel environment to run.		Under Microsoft's Windows an extra variable is required, dictating the external C compiler used by the Eiffel environment. Like the core variables, this variable must be defined in order for an Eiffel environment to run.

	'''ISE_C_COMPILER''': The noted and installed C compiler used by the Eiffel compiler to perform C/C++ compilation and to locate the compatible external libraries. Below is a list of compatible C compiler names:		* '''ISE_C_COMPILER''': The noted and installed C compiler used by the Eiffel compiler to perform C/C++ compilation and to locate the compatible external libraries. Below is a list of compatible C compiler names:
			** ''msc'': Any supported [[Installing Microsoft C compiler\|Microsoft Visual C/C++]] compiler.
	* ''msc'': Any supported [[Installing Microsoft C compiler\|Microsoft Visual C/C++]] compiler.		** ''mingw'': The open source [http://www.mingw.org MinGW] C/C++ compiler, which at the time of writing is only available as a stable release for x86.
	* ''mingw'': The open source [http://www.mingw.org MinGW] C/C++ compiler, which at the time of writing is only available as a stable release for x86.		** ''bcb'': The Free Borland 5.5 C++ compiler which is now deprecated and should not be used.
	* ''bcb'': The Free Borland 5.5 C++ compiler which is now deprecated and should not be used.

	== Optional Variables ==		== Optional Variables ==

Manus: /* Core Variables */

2014-05-02T17:08:05Z

Core Variables

← Older revision		Revision as of 17:08, 2 May 2014
Line 10:		Line 10:
	The core variables are the Eiffel compiler variables that absolutely must be defined for the [[:Category:EiffelStudio\|EiffelStudio]]/Eiffel compiler to function. Without them the Eiffel environment has no idea where it is or what platform binaries to load.		The core variables are the Eiffel compiler variables that absolutely must be defined for the [[:Category:EiffelStudio\|EiffelStudio]]/Eiffel compiler to function. Without them the Eiffel environment has no idea where it is or what platform binaries to load.

	'''ISE_EIFFEL''': The holy grail of everything Eiffel, the only difference being is that this variable can be found! The value should point to the root of the [[:Category:EiffelStudio\|EiffelStudio]]/Eiffel compiler installation.		* '''ISE_EIFFEL''': The holy grail of everything Eiffel, the only difference being is that this variable can be found! The value should point to the root of the [[:Category:EiffelStudio\|EiffelStudio]]/Eiffel compiler installation.
			* '''ISE_PLATFORM''': Represents the named platform on which the Eiffel environment is running. Below is a list of compatible platform names:
	'''ISE_PLATFORM''': Represents the named platform on which the Eiffel environment is running. Below is a list of compatible platform names:		** freebsd-x86-64
			** freebsd-x86
	* freebsd-x86-64		** irix-mips-64
			** irix-mips
	* freebsd-x86		** linux-ppc
			** linux-sparc
	* irix-mips-64		** linux-x86-64
			** linux-x86
	* irix-mips		** macosx-x86
			** macosx-x86-64
	* linux-ppc		** openbsd-x86
			** solaris-sparc-64
	* linux-sparc		** solaris-sparc
			** solaris-x86-64
	* linux-x86-64		** solaris-x86
			** win64
	* linux-x86		** windows

	* macosx-x86

	* macosx-x86-64

	* openbsd-x86

	* solaris-sparc-64

	* solaris-sparc

	* solaris-x86-64

	* solaris-x86

	* win64

	* windows

	=== Windows Variables ===		=== Windows Variables ===

Manus: Reordered env by importance. Recommend not using some variables.

2014-05-02T17:07:19Z

Reordered env by importance. Recommend not using some variables.

← Older revision		Revision as of 17:07, 2 May 2014
Line 61:		Line 61:
	In addition to the core variables, there are a number of optional variables that can be defined to replace predefined values set by the Eiffel environments.		In addition to the core variables, there are a number of optional variables that can be defined to replace predefined values set by the Eiffel environments.

	'''~~ISE_CFLAGS~~''': ~~C compilation flags that~~ are ~~passed to~~ the ~~C compiler~~.		* '''ISE_LIBRARY''': Points to an alternative location for library source files. By default this is automatically set by EiffelStudio to the same location as [[#Core Variables\|ISE_EIFFEL]]. This is usually set explicitly when you are checking out the source code directly.

	'''~~ISE_SHAREDLIBS~~''': ~~Some additional C/C++~~ libraries ~~that are passed~~ to the ~~C/C++ linker. It can also be used to pass linker flags~~.		* '''ISE_PRECOMP''': The location of the Eiffel environment precompiled libraries. By default, this is automatically set by EiffelStudio to a user specific location which vary depending on the platform.

	'''~~ISE_LIBRARY~~''': ~~Points~~ to ~~an alternative location for library source files~~. ~~By default this is automatically~~ set ~~by EiffelStudio to~~ the ~~same location~~ as ~~[[#Core Variables\|ISE_EIFFEL]]. This is usually set explicitly when you are checking out the source code directly~~.		* '''ISE_CFLAGS''': C compilation flags that are passed to the C compiler. We recommend not using it but instead set the C compilation flags as part of your Eiffel Configuration File.

	'''~~ISE_PRECOMP~~''': ~~The location~~ of ~~the~~ Eiffel ~~environment precompiled libraries [[ConfigurationFileFormat\|configuration files]]~~.		* '''ISE_SHAREDLIBS''': Some additional C/C++ libraries that are passed to the C/C++ linker. It can also be used to pass linker flags. Like '''ISE_CFLAGS''', we recommend not using it but instead set the C compilation flags as part of your Eiffel Configuration File.

	'''ISE_APP_DATA''': Location of the Eiffel environment configuration data, such as project settings data and session configuration data. This configuration data is hidden, managed by [[:Category:EiffelStudio\|EiffelStudio]] and should not be manipulated manually.		* '''ISE_APP_DATA''': Location of the Eiffel environment configuration data, such as project settings data and session configuration data. This configuration data is hidden, managed by [[:Category:EiffelStudio\|EiffelStudio]] and should not be manipulated manually.

	'''ISE_USER_FILES''': Points to the location of Eiffel environment user files like the default projects location, user [[Code Templates\|code templates]] and Eiffel environment [[Replaceable_User_Files\|Replaceable User Files]].		* '''ISE_USER_FILES''': Points to the location of Eiffel environment user files like the default projects location, user [[Code Templates\|code templates]] and Eiffel environment [[Replaceable_User_Files\|Replaceable User Files]].

	=== Auxiliary Variables ===		=== Auxiliary Variables ===
	The following environment variables are defined when working with Eiffel environment sources. There is no internal knowledge of the following environment variables; they are used for configuration and compilation only.		The following environment variables are defined when working with Eiffel environment sources. There is no internal knowledge of the following environment variables; they are used for configuration and compilation only.

	'''EIFFEL_SRC''': When working with the live Eiffel sources, EIFFEL_SRC points to the checked out /trunk/Src location.		* '''EIFFEL_SRC''': When working with the live Eiffel sources, EIFFEL_SRC points to the checked out /trunk/Src location.

	'''ISE_SRC''': This environment variable is used to point to the ISE internal repository containing non-GPL code. The variable points to /trunk/Src of the internal repository.		* '''ISE_SRC''': This environment variable is used to point to the ISE internal repository containing non-GPL code. The variable points to /trunk/Src of the internal repository.

	== Windows Localization ==		== Windows Localization ==

Manus: Updated to new revision scheme of EiffelStudio

2014-05-02T17:03:42Z

Updated to new revision scheme of EiffelStudio

← Older revision		Revision as of 17:03, 2 May 2014
Line 96:		Line 96:
	User variables, available only to the currently logged on user, are found under the key:		User variables, available only to the currently logged on user, are found under the key:

	HKCU\Software\ISE\~~Eiffel~~''XX''\''app_name''		HKCU\Software\ISE\Eiffel_''YY.MM''\''app_name''

	This is the very first place any Eiffel system will look for a local variable. For instance, [[:Category:EiffelStudio\|EiffelStudio]] and the Eiffel compiler are bundled in the executable ''ec.exe''. For release X.Y, built with a X.Y Eiffel compiler, ec.exe will first look for variables under:		This is the very first place any Eiffel system will look for a local variable. For instance, [[:Category:EiffelStudio\|EiffelStudio]] and the Eiffel compiler are bundled in the executable ''ec.exe''. For release YY.MM built with a YY.MM Eiffel compiler, ec.exe will first look for variables under:

	HKCU\Software\ISE\~~EiffelXY~~\ec		HKCU\Software\ISE\Eiffel_YY.MM\ec

	Failing to find any variable under this key, the system will default to looking at the compiled version key (the version of the Eiffel compiler the system was compiled with.) Using the same example, the following key will be examined:		Failing to find any variable under this key, the system will default to looking at the compiled version key (the version of the Eiffel compiler the system was compiled with.) Using the same example, the following key will be examined:

	HKCU\Software\ISE\~~EiffelXY~~		HKCU\Software\ISE\Eiffel_YY.MM

	Again failing to locate a matching variable name, the system will proceed to check the local machine hive, using the same rules as used by the current user hive.		Again failing to locate a matching variable name, the system will proceed to check the local machine hive, using the same rules as used by the current user hive.

	HKLM\Software\ISE\~~Eiffel~~''XX''\''app_name''		HKLM\Software\ISE\Eiffel_''YY.MM''\''app_name''

	Using the same example. the application specific key at will be searched next:		Using the same example. the application specific key at will be searched next:

	HKLM\Software\ISE\~~EiffelXY~~\ec		HKLM\Software\ISE\Eiffel_YY.MM\ec

	And failing to find any matching variable the compiled version key will be the last place looked under:		And failing to find any matching variable the compiled version key will be the last place looked under:

	HKLM\Software\ISE\~~EiffelXY~~		HKLM\Software\ISE\Eiffel_YY.MM

	To sum up, here is the list of searched locations. ordered by priority for retrieving, a variable; environment, local or otherwise:		To sum up, here is the list of searched locations. ordered by priority for retrieving, a variable; environment, local or otherwise:

Manus: Improvements on ISE_LIBRARY

2014-05-02T17:00:43Z

Improvements on ISE_LIBRARY

← Older revision		Revision as of 17:00, 2 May 2014
Line 65:		Line 65:
	'''ISE_SHAREDLIBS''': Some additional C/C++ libraries that are passed to the C/C++ linker. It can also be used to pass linker flags.		'''ISE_SHAREDLIBS''': Some additional C/C++ libraries that are passed to the C/C++ linker. It can also be used to pass linker flags.

	'''ISE_LIBRARY''': Points to an alternative location for library source files. By default this is set by ~~the Eiffel environment as~~ the same location as [[#Core Variables\|ISE_EIFFEL]]. This is ~~normally~~ set explicitly when ~~using the checked~~ out ~~sources, which point to~~ the ~~live library sources~~.		'''ISE_LIBRARY''': Points to an alternative location for library source files. By default this is automatically set by EiffelStudio to the same location as [[#Core Variables\|ISE_EIFFEL]]. This is usually set explicitly when you are checking out the source code directly.

	'''ISE_PRECOMP''': The location of the Eiffel environment ~~precompile~~ [[ConfigurationFileFormat\|configuration files]].		'''ISE_PRECOMP''': The location of the Eiffel environment precompiled libraries [[ConfigurationFileFormat\|configuration files]].

	'''ISE_APP_DATA''': Location of the Eiffel environment configuration data, such as project settings data and session configuration data. This configuration data is hidden, managed by [[:Category:EiffelStudio\|EiffelStudio]] and should not be manipulated manually.		'''ISE_APP_DATA''': Location of the Eiffel environment configuration data, such as project settings data and session configuration data. This configuration data is hidden, managed by [[:Category:EiffelStudio\|EiffelStudio]] and should not be manipulated manually.

Manus: Fixed link

2011-11-08T23:50:50Z

Fixed link

← Older revision		Revision as of 23:50, 8 November 2011
Line 71:		Line 71:
	'''ISE_APP_DATA''': Location of the Eiffel environment configuration data, such as project settings data and session configuration data. This configuration data is hidden, managed by [[:Category:EiffelStudio\|EiffelStudio]] and should not be manipulated manually.		'''ISE_APP_DATA''': Location of the Eiffel environment configuration data, such as project settings data and session configuration data. This configuration data is hidden, managed by [[:Category:EiffelStudio\|EiffelStudio]] and should not be manipulated manually.

	'''ISE_USER_FILES''': Points to the location of Eiffel environment user files like the default projects location, user [[Code Templates\|code templates]] and Eiffel environment [[~~Installation Replacement~~ Files~~\|installation replacement files~~]].		'''ISE_USER_FILES''': Points to the location of Eiffel environment user files like the default projects location, user [[Code Templates\|code templates]] and Eiffel environment [[Replaceable_User_Files\|Replaceable User Files]].

	=== Auxiliary Variables ===		=== Auxiliary Variables ===

Manus: /* Optional Variables */

2011-11-08T23:49:09Z

Optional Variables

← Older revision		Revision as of 23:49, 8 November 2011
Line 69:		Line 69:
	'''ISE_PRECOMP''': The location of the Eiffel environment precompile [[ConfigurationFileFormat\|configuration files]].		'''ISE_PRECOMP''': The location of the Eiffel environment precompile [[ConfigurationFileFormat\|configuration files]].

	'''ISE_APP_DATA''': Location of the Eiffel environment configuration data, such as project settings data and session configuration data. This configuration data is managed by [[:Category:EiffelStudio\|EiffelStudio]] and should not be manipulated manually.		'''ISE_APP_DATA''': Location of the Eiffel environment configuration data, such as project settings data and session configuration data. This configuration data is hidden, managed by [[:Category:EiffelStudio\|EiffelStudio]] and should not be manipulated manually.

	'''ISE_USER_FILES''': Points to the location of Eiffel environment user files like the default projects location, user [[Code Templates\|code templates]] and Eiffel environment [[Installation Replacement Files\|installation replacement files]].		'''ISE_USER_FILES''': Points to the location of Eiffel environment user files like the default projects location, user [[Code Templates\|code templates]] and Eiffel environment [[Installation Replacement Files\|installation replacement files]].

Manus: Removed version specific info

2010-02-05T16:27:50Z

Removed version specific info

← Older revision		Revision as of 16:27, 5 February 2010
Line 98:		Line 98:
	HKCU\Software\ISE\Eiffel''XX''\''app_name''		HKCU\Software\ISE\Eiffel''XX''\''app_name''

	This is the very first place any Eiffel system will look for a local variable. For instance, [[:Category:EiffelStudio\|EiffelStudio]] and the Eiffel compiler are bundled in the executable ''ec.exe''. For release 6.3, built with a 6.3 Eiffel compiler, ec.exe will first look for variables under:		This is the very first place any Eiffel system will look for a local variable. For instance, [[:Category:EiffelStudio\|EiffelStudio]] and the Eiffel compiler are bundled in the executable ''ec.exe''. For release X.Y, built with a X.Y Eiffel compiler, ec.exe will first look for variables under:

	HKCU\Software\ISE\~~Eiffel63~~\ec		HKCU\Software\ISE\EiffelXY\ec

	Failing to find any variable under this key, the system will default to looking at the compiled version key (the version of the Eiffel compiler the system was compiled with.) Using the same example, the following key will be examined:		Failing to find any variable under this key, the system will default to looking at the compiled version key (the version of the Eiffel compiler the system was compiled with.) Using the same example, the following key will be examined:

	HKCU\Software\ISE\~~Eiffel63~~		HKCU\Software\ISE\EiffelXY

	Again failing to locate a matching variable name, the system will proceed to check the local machine hive, using the same rules as used by the current user hive.		Again failing to locate a matching variable name, the system will proceed to check the local machine hive, using the same rules as used by the current user hive.
Line 112:		Line 112:
	Using the same example. the application specific key at will be searched next:		Using the same example. the application specific key at will be searched next:

	HKLM\Software\ISE\~~Eiffel63~~\ec		HKLM\Software\ISE\EiffelXY\ec

	And failing to find any matching variable the compiled version key will be the last place looked under:		And failing to find any matching variable the compiled version key will be the last place looked under:

	HKLM\Software\ISE\~~Eiffel63~~		HKLM\Software\ISE\EiffelXY

	To sum up, here is the list of searched locations. ordered by priority for retrieving, a variable; environment, local or otherwise:		To sum up, here is the list of searched locations. ordered by priority for retrieving, a variable; environment, local or otherwise:

← Older revision		Revision as of 23:49, 8 November 2011
Line 69:		Line 69:
	'''ISE_PRECOMP''': The location of the Eiffel environment precompile [[ConfigurationFileFormat\|configuration files]].		'''ISE_PRECOMP''': The location of the Eiffel environment precompile [[ConfigurationFileFormat\|configuration files]].

	'''ISE_APP_DATA''': Location of the Eiffel environment configuration data, such as project settings data and session configuration data. This configuration data is managed by [[:Category:EiffelStudio\|EiffelStudio]] and should not be manipulated manually.		'''ISE_APP_DATA''': Location of the Eiffel environment configuration data, such as project settings data and session configuration data. This configuration data is hidden, managed by [[:Category:EiffelStudio\|EiffelStudio]] and should not be manipulated manually.

	'''ISE_USER_FILES''': Points to the location of Eiffel environment user files like the default projects location, user [[Code Templates\|code templates]] and Eiffel environment [[Installation Replacement Files\|installation replacement files]].		'''ISE_USER_FILES''': Points to the location of Eiffel environment user files like the default projects location, user [[Code Templates\|code templates]] and Eiffel environment [[Installation Replacement Files\|installation replacement files]].