mirror of
https://github.com/EiffelSoftware/eiffel-org.git
synced 2025-12-08 15:52:26 +01:00
038a567573
Author:halw Date:2011-02-22T17:37:17.000000Z git-svn-id: https://svn.eiffel.com/eiffel-org/trunk@775 abb3cda0-5349-4a8f-a601-0c33ac3a8c38
198 lines
5.4 KiB
Plaintext
198 lines
5.4 KiB
Plaintext
[[Property:title|EiffelStudio: Command line options]]
|
|
[[Property:link_title|Using command line options]]
|
|
[[Property:weight|1]]
|
|
[[Property:uuid|a6b6a676-8660-ce2d-6f37-03de7f23a78e]]
|
|
==Compiling and viewing==
|
|
|
|
You may start ec through a command in one of the following forms:
|
|
:'''ec''' ''option'' ... [''class_name''][''feature_name'']
|
|
:'''ec''' ''option'' ... [''class_file_name'' [-library ''library_name'']]
|
|
|
|
In the first form:
|
|
|
|
''class_name'', if present, must be the name of a class of the system to which '''ec''' is applied. This system is identified by its configuration file; by default this is the file called Ace.ecf in the working directory, but you can select any other one through the -config ''file_name'' option. Similarly, the default project directory is the working directory, but you can select another through the -project_path ''directory_name'' option.
|
|
|
|
''feature_name'', if present, must be the final name of a feature of the class called ''class_name''. <br/>
|
|
|
|
In the second form:
|
|
|
|
''class_file_name'', is the name of a file in the working directory which is assumed to contain the root class of a system to be compiled. The presence of a configuration file is not assumed, so this form can be used to compile a system from a root class and no configuration file. A configuration file will be built with default system and root cluster names based on the name of the root class. Other class files in the working directory will be used if necessary, as will EiffelBase, plus any library specified with the ''-library'' option.
|
|
|
|
The table below lists the available ''options'', the arguments they require, and their effect:
|
|
|
|
|
|
{| border="1"
|
|
|-
|
|
| width="175pt" | '''OPTION'''
|
|
| '''ARGUMENTS'''
|
|
| '''EFFECT'''
|
|
|-
|
|
| ''Compiling options''
|
|
|-
|
|
| -melt
|
|
|
|
|
| Normal compilation, except on an incremental recompilation where added/removed classes (of classes not in system) will be detected. This is the default option, if no other compiling or viewing option is specified.
|
|
|-
|
|
| -freeze
|
|
|
|
|
| Freeze system.
|
|
|-
|
|
| -finalize
|
|
|
|
|
| Produce a finalized system. See below.
|
|
|-
|
|
| -precompile
|
|
|
|
|
| Precompile a system, treating it as a library.
|
|
|-
|
|
| ''Viewing options''
|
|
|-
|
|
| -ancestors
|
|
| class_name
|
|
| Print the ancestors of the class.
|
|
|-
|
|
| -aversions
|
|
| class_name, feature_name
|
|
| Print the ancestor versions of the feature.
|
|
|-
|
|
| -callers
|
|
| class_name, feature_name
|
|
| Print all the routines that call the feature.
|
|
|-
|
|
| -clients
|
|
| class_name
|
|
| Print the clients of the class
|
|
|-
|
|
| -descendants
|
|
| class_name
|
|
| Print the descendants of the class.
|
|
|-
|
|
| -dversions
|
|
| class_name, feature_name
|
|
| Print all the versions of the feature in the descendant versions of the class.
|
|
|-
|
|
| -flat
|
|
| class_name
|
|
| Print the flat view of the class.
|
|
|-
|
|
| -flatshort
|
|
| class_name
|
|
| Print the Flat Contract view (previously called flat-short form) of the class.
|
|
|-
|
|
| -implementers
|
|
| class_name, feature_name
|
|
| Print all the classes that declare or redeclare the feature.
|
|
|-
|
|
| -short
|
|
| class_name
|
|
| Print the Contract view (previously called short form) of the class.
|
|
|-
|
|
| -suppliers
|
|
| class_name, feature_name
|
|
| Print all the suppliers of the class.
|
|
|-
|
|
| ''Other options''
|
|
|-
|
|
| -batch
|
|
|
|
|
| Launch the compilation without user request.
|
|
|-
|
|
| -clean
|
|
|
|
|
| Delete project if already compiled and compile project as if it was the first time.
|
|
|-
|
|
| -config
|
|
| file_name
|
|
| Use the file as configuration.
|
|
|-
|
|
| -c_compile
|
|
|
|
|
| Launch C compilation, if needed, after Eiffel compilation.
|
|
|-
|
|
| -file
|
|
| file_name
|
|
| Save the output to the file.
|
|
|-
|
|
| -filter
|
|
| filter_file_name
|
|
| Print text as processed by the filter.
|
|
|-
|
|
| -help
|
|
|
|
|
| Print the help.
|
|
|-
|
|
| -keep
|
|
|
|
|
| Keep assertions in final mode. Useful with -finalize only.
|
|
|-
|
|
| -library
|
|
| library_name
|
|
| Library is included in the compile when a ''class_file_name'' is given.
|
|
|-
|
|
| -loop
|
|
|
|
|
| Enter interactive mode. See: [[Command line interactive mode]].
|
|
|-
|
|
| -metadata_cache_path
|
|
| directory_name
|
|
| Specify location of Metadata Cache used for .NET compilation. This overrides any settings from your configuration file.
|
|
|-
|
|
| -no_library
|
|
|
|
|
| When converting an old configuration file format, do not convert clusters into libraries.
|
|
|-
|
|
| -project_path
|
|
| directory_name
|
|
| Use this directory as compilation directory. (Default: current directory.)
|
|
|-
|
|
| -stop
|
|
|
|
|
| Stop on errors. (Default: no.)
|
|
|-
|
|
| -use_settings
|
|
|
|
|
| Use the project global settings to retrieve the project location for the last compilation of this project.
|
|
|-
|
|
| -version
|
|
|
|
|
| Print compiler version number.
|
|
|}
|
|
|
|
|
|
{{note|In the third column, to print means to produce the requested information on the default output of the '''ec''' command.}}
|
|
|
|
|
|
{{note|When using '''-finalize''', assertions will be discarded (unlike in EiffelStudio which asks first.) The assertion disposition specified in the project configuration file can be retained in finalization by combining the '''-keep''' option with '''-finalize'''.}}
|
|
|
|
|
|
Some options can have modifiers that can affect their results. The modifiers are listed in the table below:
|
|
{| border="1"
|
|
|-
|
|
| <center>'''Option'''</center>
|
|
| <center>'''Modifier'''</center>
|
|
| <center>'''Effect'''</center>
|
|
|-
|
|
| -callers
|
|
! colspan="2" |
|
|
|-
|
|
|
|
|
| -show_all
|
|
| Include all callers rather than only those in the specified class.
|
|
|-
|
|
|
|
|
| -assigners
|
|
| Restrict callers to those that use given feature only as a target of an assignment instruction.
|
|
|-
|
|
|
|
|
| -creators
|
|
| Restrict callers to those that use given feature only as a target of a creation instruction.
|
|
|}
|
|
|
|
|
|
{{seealso|<br/>
|
|
[[Batch compilation|Batch compilation]] }}
|
|
|
|
|
|
|
|
|