030-3621-A MPW3.2 Release Notes Erratum Due to an oversight, an erroneous comment symbol was used in lines 20 through 24 of the source file: {MPW}PExamples:TESampleGlue.a The character"#" was incorrectly written where the character";" should have been written. MPW3.2 Release Notes i Copyright Apple Computer, Inc. 1990-1991. All rights reserved. MPW3.2 Release Notes This release note summarizes the differences between MPW 3.2 and MPW 3.0, the last version for which a reference manual exists. Details beyond those given in this note are to be found in separate release notes entitled MPW 3.2 Shell, MPW 3.2 Object Pascal, MPW 3.2 C, MPW 3.2 Assembler, MPW 3.2 Libraries & Interfaces, MPW 3.2 "411" Help, MPW 3.2 Run-Time Architecture, MPW 3.2 SIOW, and MPW 3.2 Tools & Scripts. Three of the above: "411" Help, Run-Time Architecture, and SIOW describe completely new features. Principal Changes Shell • Projector has a number of enhancements. • The Editor provides split windows. • A marker browser has been provided. • There are additional commands for the faccess function. • The save command, when scripted, saves the resource fork of a file if any resource has changed. • MPW can now be run under A/UX. • New System 7 .0 error codes have been added to the file SysErrs.err. c • A variety of new object code optimizations have been implemented. • There are new compiler options to control optimization level. MPW3.2 Release Notes 1 Copyright Apple Computer, Inc. 1990-1991. All rights reserved. • Support is provided for the MacApp debugger and code profilers (generating a preamble and postamble for functions). • A new pragma is provided for passing parameters to functions via registers. • A new pragma is provided to force the generation of MC68020 code. • A new pragma is provided to prevent the multiple inclusion of header files. • There is a new option for invoking the "32-bit everything'' run-time architecture. • A new pragma is provided to prevent dead code stripping by the linker. • An option is provided for machines having the MC68020 and up that allows stand-alone code segments greater than 32K. Object Pascal • Further object code optimizations, including an optional two-pass code generation phase which allocates unused scratch registers for local data. • An option to control optimization level. • An option for invoking the "32-bit everything'' run-time architecture. • A new syntax for declaring forward and external objects • Enhancements to the Object Pascal declaration handling to support MacApp. • Support for USES clauses in the implementation section of a unit. • Support for external C functions with arbitrary numbers of arguments,. • The ability to omit static links for nested procedures that don't need them. • Increase in the number of nested include files, the maximum number of nested compiletime conditionals, and in the number of long identifiers. ASM • New optimizations. • Longer identifiers to support C++ name mangling. • MC68040 s…

® Macintosh®Programmer's Workshop Toolbox Interfaces and Libraries Version 7.0 M0615LUB 030-B0 16-A 030-3622-A MPW 3.2 Libraries/Interfaces Release Notes Libraries Changes to the libraries since MPW 3.0 include the elimination of CInterface.o and CRuntime.o, their functionality having been merged into Interface.o and Runtime.o. The libraries have been resegmented so as to reduce the number of modules in segment "main". The MPW 3.2 C libraries conform to the current ANSI C standard. A number of modifications and additions have been made to the set of library functions, including new C-like string functions for Pascal strings and a C function for setting the type and creator on any file. A new library provides for the creating of applications that use a simple text I/O window to display and read console I/O (SlOW). For details, see the MPW 3.2 Simple Input/Output Window Release Notes. Linking Requirements The library CLib881.0 has a new positioning requirement as a consequence of the elimination of CRuntime.o. CLib881.0 must now not only precede all members of {CLibraries} in the link sequence but must also precede the library Runtime.o. Note that XCMDs for Hypercard require linking into one segment. Because of the new segmentation of the library, this will no longer happen automatically. This requirement can be met by putting the option -sg main on the link: command line to force the library routines and your code into a single segment. MPW 3.2 LibrarieslInterfaces Release Notes 1 Copyright Apple Computer, Inc. 1990-1991. All rights reserved. Segmentation The libraries have been resegmented, moving many of the modules out of the segment "Main". The goal of changing the segmentation is to minimize the number of modules in the segment "Main". This way, if the user needs the space in "Main" for his application or tool, he has it. If he is more concerned about speed, the user can then manipulate his makefile to contain whatever he needs in his "Main" segment. • Segment layout LIBRARY Runtlme.o Se&ment Contents MAIN %A5Init INTENV Initialization and exit procedures, 32 bit math operations A5 initialization code, _DataInit, Module #000 1 Low level IOPort functions and I/O which directly calls those functions - done for pc relative offsets Device drivers <.S.tand Alone Devices) SADEV LIBRARY Pasllb.o SelWlent Contents MAIN INTENV Compiler initializations (the functions call Runtime.o) I/O which directly calls segment INTENV in Runtime.o (may change in the future) Pascal language I/O Heap, strings and math functions SIDIO PASLIB LIBRARY StdCLlb.o Contents SIDIO SIDCLm MPW 3.2 LibrarieslInterfaces Release Notes C language I/O All ANSI functions (except I/O) 2 Copyright Apple Computer, Inc. 1990-1991. All rights reserved. LIBRARY Stubs.o Sewent Contents SADEV Device drivers (stubs out the driver functions) LIBRARY DRVRRuntime.o Se&ment Contents MAIN Driver initialization and exit procedures Changes to C Library…

030-3626-A MPW 3.2 Assembler Release Notes The following features have been added to the Assembler for version 3.2. • New optimizations. • Longer identifiers. • New parameter and syntax for module directives. • MC68040 support. • "32-Bit Everything" support. • Improved SADE support. • A new macro function : &SYSINMOD New Optimizations The 3.2 Assembler supports optimization of instructions which were previously not optimized. The following additional optimizations are available: ADD ADDA ADDI #<Data>,An #<Data>,An #<Data>,An [-8 <= data <= -1) [-8 <= data <= -1] [-8 <= data <= -1) =====> =====> =====> SUBQ SUBQ SUBQ #-<Data>,An #-<Data>,An #-<Data>,An SUB SUBA SUBI #<Data>,An #<Data>,An #<Data>,An [-8 <= data <= -1] [-8 <= data <= -1] [-8 <= data <= -1] =====> =====> =====> ADDQ ADDQ ADDQ #-<Data>,An #-<Data>,An #-<Data>,An The above optimizations only occur when the Assembler understands the operand to be a negative number. Since the Assembler operates on 32-bit arithmetic, the value of the operand must be written as a negative number in order to activate the optimization. Tiris is necessary regardless of the size (B, W, L) of the instruction. Thus, in a byte operation, the operand must specify "-1" instead of "$FF". even though, un-optimized, they would both compile to the same instruction. MPW 3.2 Assembler Release Notes 1 Copyright Apple Computer, Inc. 1990-1991. All rights reserved. ADDI #<Data>,<EA3> SUBI #<Data>,<EA3> ADD.I #<data>,An =====> =====> [+l <= data <= +8] [-32767 <= data <= +32767] =====> [+l <= data <= +8] ADDQ SUBQ #<Data>,<EA3> #<Data>,<EA3> LEA <Data>(An),An Longer Identifiers The Assembler now suppons identifiers of lengths up to 251 characters (this was done primarily to support C++ name mangling). On detecting a name that exceeds this maximum, the Assembler issues the warning: ID longer than maximum length ... truncating to maximum length. New Parameter and Syntax for Module Directives A new parameter, ForceActi ve, exists for the ccxie module and data mcxiule directives. A new syntax has been provided and error checking for conflicting parameters is in effect. ForceActive ForceActive causes a ccxie or data module to be included in the final linked output even if the Linker would otherwise strip that code or data module because there were no references to it. Syntax For code module directives: Line ::= [label] CodeDir [KeywordList] CodeDir ::= PROC I FUNC I MAIN KeywordList ::=Keyword I KeywordList, Keyword Keyword::= ENTRY I EXPORT I FORCEACTIVE For data module directives: Line ::= [label] RECORD [KeywordList] KeywordList Keyword I KeywordList, Keyword MPW 3.2 Assembler Release Notes 2 Copyright Apple Computer, Inc. 1990-1991. All rights reserved. Keyword::= ENTRY I EXPORT I INCR[EMENT] MAIN I FORCEACTIVE I DECR[EMENT] + Note: The MPW 3.0 Assembler Manual describes MAIN as a parameter for the RECORD directive, but appears to have inadvertently omitted MAIN from the syntax. 6 Import…