ede_read.txt

tasking for MC683xx编译器使用的入门程序

	EDE GETTING STARTED NOTES

Welcome!

Thank you for your interest in the TASKING InterTools 68xxx development
tools.  This readme file contains some helpful hints to get you 
started using EDE, a brief description of the various InterTools 
Solution specific EDE tabs, a listing of the compiler switches
and where they may be found in EDE.

-------------------------------------------------------------------

HELPFUL GETTING STARTED HINTS

All of the menu items described below are found under the EDE menu 
unless otherwise noted.

EDE is an integrated environment that supports the entire 
edit-build-debug loop. You can create projects, define the 
files that make up the project and edit them in the EDE editor. 
With the button bar in the top of the screen you can compile a 
single file, build a project and start the CrossView debugger.
There is also a button to browse through a list of error messages
that may have been reported during the build process.

When you use the 'ERR' button the editor automatically positions the
cursor in the file where the error has been detected.  To the left
of the 'ERR' button are the build button and the button to compile
a single file. To the right to the 'ERR' button is the 'fly-swatter'
that starts the CrossView debugger. 

Note that messages generated by the tools are intercepted by EDE
and displayed in the 'Build tab' of the output screen in the bottom 
of the window.  You can enable the output window via the Output menu
item in the Window menu.

In EDE you do not need to create project makefiles yourself. 
EDE generates them automatically for you based on the files you have 
defined in your project and the tools options you have chosen from 
the EDE menu.

The EDE menu has menu items to set options for the compiler, assembler,
linker/locator and the debugger.  The compiler and assembler options 
menus respond to the active window. If the active window in EDE is a C
source file, the compiler options menu allows you to set options for 
that specific file or for all the C files in the project. The order in 
which you do so is not important. Individual file options always
prevail over project wide options.  Every time you close an option
selection dialog from within EDE a new build file (makefile) will be
generated. 

The toolset includes on-line manuals which are accessible via buttons
in the toolbar or via the Manuals... menu item under the EDE menu.

The Build Options menu item under the EDE menu allows you to override
the generated makefile. You can specify an alternate build file. Note
that this automatically excludes the option selection in the tool tabs.

As you can see, the option tabs explain the option behavior rather
than specifying the option strings themselves. If you are used to the 
command line options you may want to verify that the selections you
make in the tabs correspond to the command line options you have in
mind.  You can do this by checking the box 'Show command line option
at the bottom of a tool tab' in the EDE Build Options menu selection.
This will enable a box in the tool tabs that show the command line
equivalents of the options you select.

Within EDE all tools have an "Additional Options" edit field where
options can be specified.  The Additional Options field is always
accessible via a tab named "Misc" or "Miscellaneous", except in the 
case of the linker and formatter.  Linker additional options are 
specified under the "Linker" tab.  Formatter additional options are 
specified under the "Format" tab.

The Directories menu item produces a dialog that references the 
executable, library, and include files path.  This dialog should NOT 
be used in order to add additional include file or library paths.  Due 
to the way the InterTools directory structure is set up, any directory 
specified in the Include and Library fields will automatically have 
additional directory information appended.  User include directories
can be specified in an edit box under the Preprocessing tab found under
the C/C++ Compiler Options menu item.  If you wish to add additional
library and/or system include directories, you should use the 
Additional Options fields as described above.

Options under the Project Options menu affect all files of the project. 
In some cases these options can affect the command lines of multiple 
tools.  The CPU type option (Processor tab), for example, determines 
both the driver program (i.e. c68332.exe, asm68332.exe) used by the 
compiler and assembler, but also contributes to the library index 
filename used by the linker (i.e. lib332).  The Integer size option 
(Language tab) adds the -L compiler switch to the command line and a 
".l" extension to the library index filename (i.e. lib332.l), 
indicating the use of a "long integer" library.  The High Level 
Language Option specifies whether the project uses C++ or not and 
modifies the command line appropriately.  Note that compilation with 
-L (long integers) is required when using C++.

By default, EDE assumes the following options (these will be activated 
when first bringing up EDE):

CPU type 68332
C++ project
-d -do -L -ot -S (path to default system include dir) command line

Note that if you have not purchased C++ support, the C++ options will
be inaccessible.

-------------------------------------------------------------------

DESCRIPTION OF EDE TABS

The following describes some of the EDE tabs available
via the EDE menu and their purpose:

From the Project Options menu:

The "Processor" tab is used to select the processor being used 
(thereby controlling the compiler driver) and also contains 
project-wide floating point options.

The "Language" tab is used to select the compiler being used
(C++ or C) and the integer size (controlling whether the -L
flag is set or not, as well as the library extension).

The "Boards" tab specifies whether any special board support
package is being used (such as for the 68302ADS).

From the C/C++ Compiler Options menu:

The "Code" tab controls the inclusion of compiler options specific 
to code generation (i.e., -j, -n5, -n6, etc.).

The "Position-Independence" tab controls the inclusion of compiler 
options specific to generating position-independent code and data
(i.e., -ps, -pd, -si, -ps, etc.).

The "Alignment" tab controls the inclusion of compiler options 
specific to code or data alignment (i.e., -ab, -ac, -pack, etc.).

The "Data" tab controls the inclusion of compiler options specific 
to separate data (i.e., -sd, -ss, -sc, -cs, etc.).

The "Listing" tab controls the inclusion of compiler options specific 
to generating compiler (not assembly) listings (i.e., -s, -a, -x).

The "Output" tab controls the inclusion of compiler options specific 
to generating assembly output, including listings and in-line assembly
(i.e., -nf, -ia, -ao, etc.).

The "Optimization" tab controls the inclusion of compiler options specific 
to optimization (i.e., -do, -no, -nh, -nr, etc.).

The "Preprocessing" tab controls the inclusion of compiler options specific 
to include files and preprocessing (i.e., -I, -E, -P, etc.).

The "Misc" tab controls the inclusion of compiler options that don't
reasonably fall under other headings (i.e., -d, -C, -bb, -pw, etc.).

The "Optimization" tab controls the inclusion of compiler options specific 
to optimization (i.e., -do, -no, -nh, -nr, etc.).

The "C++ Lang", "C++ Lang2", and "C++ Misc" tabs control the inclusion 
of compiler options specific to InterTools C++.

From the Assembler Options menu:

The "Listing" tab controls the inclusion of assembler options specific 
to listings (i.e., -s, -x, etc.).

The "Code Generation" tab controls the inclusion of assembler options 
specific to code generation (i.e., -A, -po, -fs, -bw, etc.).

The "Debug" tab controls the inclusion of assembler options specific 
to generating debug information (i.e., -d, etc.).

The "Misc" tab controls the inclusion of miscellaneous assembler 
options (i.e., -a4, -F, -ex, etc.).

From the Linker/Formatter Options menu:

The "Format" tab controls the selection of output format for the
formatter and linker.  By default IEEE-695 is assumed.

The "Hex" tab is active when selecting "HEX file" from the Format
tab.  It controls output formats for the formatter when using form.

The "Linker" tab controls the inclusion of library index files as 
well as other linker options.

The "Locator" tab controls the generation of a project-specific 
locator command file.

The "Specials" tab controls the inclusion of special locator command
file directives (START, etc.).

The "ROM" tab controls ROM-processing specific options (-b, -rs, -rc,
etc.).

The "Symbols" tab controls options specific to the suppression or]
inclusion of symbols (-k, -s, etc.).

From the "CrossView Pro Options" menu:

The "Debugger" tab controls which execution environment is being used
(BDM, ROM, SIM), and communications-specific parameters (ROM monitor 
only).

The "Logging" tab controls CrossView Pro logging options.

The "Miscellaneous" tab controls the limits on internal features
(breakpoints, assertions, special variables, etc.).

-------------------------------------------------------------------

EDE COMPILER SWITCH LISTING

The following list details the compiler switches available
via the TASKING EDE.  Any switches not explicitly mentioned 
in the list may still be added via the "Additional Options"
edit field found in the "Misc" tab.  Tabs specified in the 
list can be accessed via the C/C++ Compiler Options menu unless
otherwise specified.  In some cases multiple items must be
selected in order to generate a specific switch.  In this case
the appropriate descriptions will be ANDed (&&).  Likewise, some
items may need to be deselected in order to generate a specific
switch.  In these cases the description will be negated (!descr).

SWITCH	TAB			DESCRIPTION	
-68	Project Options/	Softare floating point compatibility mode
	Processor

-a	Listing			Generate a list file (.LIS) &&
				Include secondary include files in the listing

-aa	Alignment		Align each function on 16 byte boundary

-ab	Alignment		Word align structures that have bitfields

-ac	Alignment		Align module's first function on 16 byte boundary

-ai	Optimization		Perform automatic inline procedure expansion

-ao	Output			Additional options for assembler

-ar	Code			Use alternate register usage conventions

-b5	Code			Use 32-bit A5-relative offsets

-bb	Misc			Maintain backwards compatible bitfield storage layout

-C	Misc			Old (pre 7.0) run-time model compatibility mode

-ca	Preprocessing		Run to completion when generating preprocessor or make output

-cc	Code			Set the classname of generated code segment

-cs	Data			Put all const data in separate segment cdata and class constant

-d	Misc			Generate symbolic debug information

-d -do	Code			Generate debug info; disable optimizations which interfere with debug

-dd	Preprocessing		Allow ANSI-style duplicate declarations

-do	Optimization		Disable optimizations which interfere with debugging

-E	Preprocessing		Generate preprocessor output file

-e	Misc			Issue warnings for language extensions

-h	Project Options/	Hardware floating point (MC68881 coprocessor)
	Processor

-I	Preprocessing		User include directories (e.g. inc1,dir2)

-ia	Output			Assemble the real-assembly file after it is generated

-id	Position-Independence	Use PC-relative addressing for data

-ih	Code			Assume interrupt handlers do not use floating point arithmetic

-j	Code			Use short branch instructions where possible

-L	Project Options/	Long integer data type (int is 32 bits, required for C++)
	Language

-l	Listing			Select output file for listings

-M	Preprocessing		Generate make dependency output file

-m	Project Options/	Use MC68881/68882 instruction for transcendental functions
	Processor

-n5/-sd	Code			Allow the compiler to use A5 for other purposes; use separate data

-n6	Code			Allow the compiler to use A6 for other purposes

-n7	Code			Limit stack-fixup deferral to N bytes

-nal	Optimization		Assume source contains no aliasing

-nd	Optimization		!Detect and remove assignments to dead variables

-nf	Output			Use narrow format (80 columns) instead of wide (132 columns)

-nh	Optimization		!Perform code hoisting

-nl	Optimization		!Remove LINK and UNLK instructions

-no	Optimization		Skip the optimizer phase of the compiler

-np	Optimization		!Attempt to put more than one variables in a register

-nr	Optimization		!Perform strength reduction
	
-os	Optimization		Optimize for space over time

-ot	Optimization		Optimize for time over space

-P	Preprocessing		Define user macros (e.g. VALUE=100,SERIAL)

-pack   Alignment		1/2/4 byte alignment of data

-pc	Position-Independence	Use Position independent forms for code

-pd	Position-Independence	Use Position independent forms for data

-ps	Position-Independence	Use Short Position Independent form for code and data

-pw	Misc			Emit warnings for calls to undeclared functions

-q	Output			Generate a real-assembly file (.S) &&
        			!Interleave C text in real-assembly file

-s	Listing			Generate a list file (.LIS) &&
        			!Include secondary include files in the listing

-sc	Data			Define default class(es) for separate data segments

-sd/-n5	Code			Allow the compiler to use A5 for other purposes; use separate data

-sd	Data			Treat all global data as separate

-si	Position-Independence	Allocate string literals in idata

-sp	Code			Enforce strict ANSI C precision constraints

-ss	Data			Define default segment(s) for separate data

-x	Listing			Create a cross-reference file (.XRF)

-------------------------------------------------------------------

@(#)m/ede/ede_read.txt	1.2 97/12/01