DevelC1p1'11e11t System OOCUMENTA TION ~· {ig~le computer inc . . . Develq:ment T«J/S Gn:xp . . . FIRST f::RAC"T~--Fetvtety J 984 Lisa Development Software Documentation: A Road Map Contents [Lisa Development Software Documentation: A Road Map) Pascal Compiler Directives Pascal Code-Cruncher's Handbook The Last w'hole Earth Test File Format Pascal's Packing Algorithm PASLIB Procedure Interface PPaslibC Unit: Privileged PASLIB Calls Execution Environment of the Pascal Compiler Intrinsic Units Mechanism (overview) IUManager (old and "spring release" versions) Obje-ct Fi-le for mats lnbterface to OBJIOLIB Format of .SYMBOLS File Shell-Writer's Guide lrtrocb:tion This reed mep wes designed lo help you to find your Wr:flf eround the ve:rious documents describirig program development for the Lisll.. Jt will help you decide which softwere you need to leern more ebout, which software you ce.n ignore for the moment, e.nd how you should proceed in stucfying the rest of the technical documentetior!. General Oleview d the En.rironmerts Available There e:r" e.c meny Wr:fl/S of writing progre.mi e.s there me creetive proQramm~rs. However, Apple supports only tt'U'ee generel styles or programs that you ce.r. write ro~ the Lhe.: those written for 1) the Workshop environment, 2) the Quicl-:.Port eroironment, e.nd 3) the ToolKit erwironment. Pro!JTems written ror eny or the!e environments cen use most of the same units end libraries. but there ere some importent differences of whict1 you should be e.were. The Workshop (Figure 1) ~ovides e. simple non-window, chmecter e.nd gre;:ihic environment within which e progrem mey run. Proc;irerm written to run in this eroironment mr:fl/ use Pesce.l's built-In 1/0 for both rues end textual displey to the console's terminal emuletor, m they mey directly utilize the Lise OS's file t;t'lern primitives. They may also use the QulckDre.w unit ror dre.wing b1tmep greph1cs erod displr:flfinQ text in e. veriety of fonts with verious attributes, end may utilize e. variety of other useful librery routines. These progrems me not eble to use the Lise Deskto~· libraries deeJinQ with windows. menus, e.nd dialOCJ boxes, nor do they heve ee.sy e.cce~~ to Use Office system documents. Jn e.ddltion to pro.rldln!J these run-time fecllltles, the Workshop e.lso includes e commend chell which mekes ave.Jlable to users en extensive set of feciht1es for: 1) Jntere.ctlve progrem development In PesceJ, Assembly, BASIC, end CDOOL; 2) File e.~: device manipulation; end 3) Interactive end belch prOQfem execution and control. 1.t"'luickFart (FiQLD"e 2) provides the simplest Desktop erwironmert, el least ftom the proQ!'ammer's viewpoint. Jn most respects, wrltlno a prOt;Jem for the QuickPort environment h identiceJ lo wrilino one for the Workshop e...,.,,ironment. Usin!J Pe.see!': built-in JIO recllittes. programs written for QulckPort may do textual dlspley to e variety of window-besed lerminel emulelor,, end mey e.ho displey r;ir eph1cs using…

’ 7 Vat om da tey vy PN oo aes Ros a Wat tO co wren enen @ orecram ¢ syst ‘é cecugc¢er, you ena uc in te ¢ “cee. scar. une cut eventually you 4 ¢ Q So ot tne cenugger., ycu need tO Kne m regh: of tne tnird line nas a ol says i L2, { demain, and if the comain is nonzero and 1 eS! aa resume you snculd tyra the CRELGG ramen mL YOLCal Found in ine office system, end using tne G cc@mmand forces tne orecess LO the tarminate exceoticn nendlsr, and things can ce cut ayay neatly. If you are in cemain 0, or ovarridden to z3r0, you snculd use tne ASQUIT corrmerd, i incut Tf you are stuck “2y you went ta or mouse Clicks, 5 $ lesp In aither cas in comain Q, YOu : are @ proceoly leests r Po tr you ara eitn: nit NMI. If the disol isn g. To Kill tne orocess, hae can tyo2 GQ, 9 0 folley Tnis sats the orcerem counter vo Q and tries ta access location 0 unin’ 3 illegal and causes a cus error. Typtr rg G a tnis ous error yill terminate the oroecess neatly. If you are and you are sitting o instru otion, tyre If the res td instruotica, wren yeu make sure non S pent tinue and y profile li tan in orcgress, for tna i/ 2 follows. fe ‘ on and ATS instruct yee OSQUIT to cleen up the os and fils tructuras t tren MMI ; instruction. You can cl as section. corain 0, Tyre % cu 2 gt 3 ass Uo Sh Fu vatatal SSbene nas sere <5 fines ay 23 2 Farst cage ug a sects Sus 2 Scutsa. $205ra seted and BoC28$ 2 Go anc maP me eataed ceed ar a= Tate 2 Dus srrer Unc uc on rege 2 8 a peoiets: SS Pag. fe20 TOOTS TOUT aT ‘a wage Ving cy w sy orm u worualsa3 o12e3 ioarions is eceuse MMI, fcara Y3 S90" The tnird secs of Oings cf inforration. Te First is a TIgist « OF@yl, =nen a cisassemoly of tne instructions surr mally a por chic of tha C disolayed ugien ore) ararnais SV Any sia. oa G 7 eer B eR] To find cut shat the orcees cojscting ta, 2 start oy at SUBEMCLS +34, the iscaties at tra too of tne radi Star aise ay, Lockin at the d disasseroly (ark ge 3) CUS-92 and at 796 Sut not an +94, it tu mas alreecy at a wot as aireedy acvenced cast) the iageretic A being acs sy 4, and the instruoticn ceing exscured i3 at ab. This is sarked 6 cn og2 3. Locking 2 cen $632 that 49 lecks Ck but AL is Q. caused tie bus error. Ther2 is also some other ner ormaticn cn nega 3. Register 36 coints t the stack frame (rarks cn 26g2 3). Matcning the acaress conteaired in AG with the steck disalay, 8, can find the garcretars to SUSFMCLS. The address is marked 2. ihe first 2 G3 at wet aceress Link ne calling stack frame anc the return pe for irs calling ov Tae FolLovirg ~ ar 002 caramecers in REVEESE orcar (warxsd 3). See ora “3g9tion cn 3 fOr Tora catails, Cne we Using mp2 FU end Pl canrencis. Thasa a G3 use a. . Par SLT I2ocEen2 OT Sigeetnant rescar ly. Tey ¢ not m2 CONN, id ca used Sacaiy fol oF 2 Cug so the ert ‘solay is oreserved. IF you co a Sta Ql is sretty dean, tha sta Kk Orayl can wice cut the error ats ON ang alienate screen less valueoia. Fir Ta322 Peg ine sama cus evroer. The first comm…

< FnerComm.text, 3-Ja.n..,a3, F.Ludolph l < Copyright 1·983, Apple Compubr lnc. > UN l T F i1 erCornra f INTRINSlC; INTERrAt:E USES {$U obj:$ysCall <-.u obj :.PSysCa:11 ) SysCall, ) PSy$Ca l 1 , (.$0 obj :Uni tStd ) Utt i t:Std, (:S\J obJ tUn it Hz > Un i tttz, ($U obj JStorage l Storage 1_ ($U obhrontMgr J FontMgr, ('$1J obj:Qu i ck Draw } Qui ckl)rw, {$UobJ:WM.Event• > Ev:enb, <SU C)bJ;WM.fo.lders l Folders; ($6£'TC fcDebug = +DbgOk j {$SETC f.cS)'mbOls == +$)'1110k l ( Th.is unit contains the record dtflni ti on used for Fiter-Appli~ation communications. It is uslKI in both receiving ev.ent• fram and s.ndtng ennh to the Filer. · An applicatio11 is t.h.rted by tbe Fiter- via the OS call 'Hak.tt...Procn'.s". The application should ex·ecuh· I ts i'nitl al i:atio11 code and then .. cal 1 GetEvent. The inJtiHalinHon code should Hrst call 'Open~' (to $It up the Filer-Appl icatfort cotlli'llunicatiotl channel> and then dwclare I: Sys~T•rminah uccttption handler. H thtt txeeption handhr cannot.bt declared or H initilltation c:annot be completed, the a9pl icaHon should 'Te HF Iler" that ifdni tF~JhcV and the ruson <se-e th• stet ion on unsoli c i te d message& in the tab le belO'W >. See the Sounc t nQ Balls 'In it i a Hu' procedure for an e-xainple. The f::ilu• sef!ds a FilerEvent to an application. The GHAddParams procedure is used to o.bhfn the additional parameters at;,$.Qciated with this •vent. TwO: parameters are pas.$td.f a fllerOp that dt'.fin&s the operation to be performed, and an optional patl;t11ame, fDocName, 1.1Jhicb Ls usitd to open, create, al\d destroy the .di skfl tes that make up the document. An application 1.1s:ts 'fDocName a-s a preiix for disk-file patbnames. It consist-s of ·a dis.k volume n·ame and the initial characters of a disl(file name. Thel'"e are currently 9 f'.i1er0ps., thou that .open a document, t,hose that 1nose or c:apy an open document, on• that tells an application tn tlo$e a di s.IH ile 1 arid one tha·t tel h tht prous5 to termina. te. Those ttiat Qpen= fc:None1. No doc: to open! The us.er pulled a tool .ra.thtr• than a doc. +cResume: Open the doc, or c:rute a new do.c if n<>.dhkfiles exist, and display conhnh. in window. H the ddt was ~u~:pended, restore its state·. Thou that close; 'fcCl Qse: Page 1 Update doc into new disKiiles and close. The source doc is unchar1ged and remains open. fcPu·t: Update and close doc to new location (fl)ocName). Destl"OY the old version. fcShredi Close the .doc as In fcSus.pend, if possible, or just close the diskfiles, if possible. Filer will delete them later. fcSuspend: Close doc, keep edits stpera.te, uve docu!"ent., state. fcCopy: fcDf.Close: Close the disl<file <not document> using the refnum provided else app will be terminatid. <User is removing a diskette.) Terminate; fcTerminate: Terminate the process and suspend any open docs (act.ua11y there shouldn't be art'Y open when this is received). An fcResume/fcNone is sent when: 1) the user pul 1s a docu…

To: Lisa 1.75-Meeting Attendee$ From: Paul Baker Date: May 26, 198~ Stbject: Minutes of ?15/l~3 rreet1ng cc: IJJ. Rosing The following issues were discussed at the Lisa 1.75 rreeting on May 5, 1~83: 1 - Next Meeting would. be• 5/26., sane time sane place . .• i . 2 - The ERS was discussed.. clari ficatiqn -on the: lack of battery backup was · suggested, it will be adde~d in the third draft. More discussion of the ERS fallows below. . 3 - The operating assurrpti.on for the design is that the current apps and bigh level OS parts will work oin both machines without changes. "' to discuss the Widget/l.75 interface was formed . . minutes of 4 - A working group the first meeting are attaiched.. · s - The location of the serial nunt>er is still .an open issue. 6 - The cornnent was made that due to the fact that the 68K 1s doing the rroto~ stepping, it is 1f1llortant to service the Timer 1 interrupt pro~~ly. 7~- A question was raised regarding parity checking on OMA. In addition some questions were asked about the use of the two new expansion slots. The new ERS addresses these issues. a·- Questions were asked aJoout the COPS/NMI/Reset ideas. The new ERS addresses this issue. · 9 - The twiggy use light 'is still an issue. 10 - Issues of corrpat1b111ty between Lisa 1 and Lisa l.75 I/O expansion cards were raised. Engineering conmitted to writ-e an application note so designers caulcl design cards that will work 1n both systems. 11 - Service indicated that they would like nDckups to evaluate servicability aspects of the system and that they would like to be involved in production philosophy discussions. S•~rvice indicated that ·they also need a PIP so they can scheaule their activ1t1es.· They indicated that they would need schematics by 7/28, 2 systems with socketed C°""30nents by 10/~8 and 3 final systems by 11/28. 12 - A remaining open issue~ is ~he relationship .between Lisa 1. 75 and the file server. · • I ii; •/I To: Ken Okin · From: Paul Baker Date: May 6, 1983 SUbject: First Widget t1eet1ng minutes cc: w. Dirks, R. Mohme G. Marten, B .' Lee, llL Henry, O. Offen, M. Urqhart, C. Twyman The first Widget/Lisa 1.75 meet1ng·was held May Sand the following issues were raised: 1 - Current status is: 30 drives on test using 16 sector controller, about 70 drives total have been ttuilt, build rate is now about 50/roonth, going to 100/roonth soon, 500/roonth in August and 3000/roonth (maybe) in October. The nineteen sector controller is working now, still waiting for ECC gate array, still waiting for seconcl pass main gate array. We can expect a working drive/controller with f].rmware on 7/1. 2 - The drive was desigrted with performance in mind, average access is 55 ms vs 180 ms on the Seagate,. track to track is 7 ms vs 20ms. Latency is higher at 19 ms max vs 16 ms. The delta rate is 5 'MHz. The 20 MB widget will have higher latency of about 25 ms max and a slightly higher data rate of about 6.5 MHz. The 40 MB widget will helVe still higher latenc…

1 fone] cor cer a) . A | — [p08] INITIAL RELEASE = B [40 ]8096] ADDED NOTES S.647 lela THE ASSY REV LEVEL MUST CORRESPOND WITH THE BILL ia OF. pre REV LEVEL . MANUFACTURING Aya STAMP a (ed ee Ee SS ii PCB AFTER ASSEMBLY OR REWORK TSO’ D|—[8t76|_BOM CHANGE ONLY | ~ [igi Re) INDICATED, COLORED. WIRES ARE THE SAME AS THOSE SHOUN €|—|e203| Bom CHANGE ONLY. [hl /p~% lB ON CRT SOCKET ASSEMBLY (ITEM 95) F | —|b230] REPLACED RSS WITH |,2\GU DOT TO MATCH DOT ON “L2”. a CRIZ; R24 WAS 150 N/A] @ UL AND QS BACK SURFACE TO BE COATED WITH HEATSINK H [4c |ea5q DELETED NOTE 7 Pal ca COMPOUND BEFORE FASTENING TO HEAT SINK (ITEM 91). ue ADDED NOTE 8; ITEM 6 |i] a VALUE WAS 0.03yF <@_ LI To BE mouNTED UPRIGHT (PERPENDICULAR To PCB 12. VALUE CHANGE, SURFACE) WITH INDUCTOR PACKAGE EXTENDED OVER OELETED L3 (ITEM 23) LI SILKSCREEN AREA. Jac |evoo] DELETED CRe-8 EcRI2; Ba <Q Ri, R24 4 R39 MUST BE MOUNTED 0.100" MIN ABOVE za] | LOSE Fae Be AND | = PCB SURFACE. TDAIITON WAS TDAIITO. A <4 = 8. NO COMPONENT 10 BE STUFFED, AT LOCATIONS: L3,CR6 THRU CRB, C2\,C22, R38, RU2 ¢ RY: J RED. c <Qjowe <QJencen le 8 eee Se ee \ co SEE DETAIL Soa aco SSS GREEN REFERENCE DOCUMENTATION? SCHEMATIC_050 - 4OI2 BILL OF MATERIAL 620 - O12! IL BROWN. [r= an PART NUMBER, DETAIL AN qeoeaeeiee [Rate 4 qlyappia computar me:| A Fixe Ge CRT_SOCKET_ASSY 7 onax Vb ir SENET PCB, etpacce ahsjee VIDEO_ BOARD on SA fhe Sie "DRAWING NUMBER COTY D| 620-Ol2i-J rex assy [rn N/A eae Fun [sr 1 ory 4

Lisa 2 Upgrade Kit Customer Instructions Installation and Data Transfer 029-OS05-A Lisa 2 Ungrade Kit Customer Instructions The following procedures describe the process of loading the Lisa 2 software on a Lisa 1 that has been upgraded to a Lisa 2. Before continuing, be sure you have completed the items on the following checklist. Have you: 1) Received your update to the Workshop? Language product (Workshop, Pascal, Basic, COBOL) versions that ran with orfice System 1.0 will NOT be compatible with this new release of the Office System. Those who have purchased the language products should order an update to them before installing this upgrade. 2) Loaded your documents to the ProFile? You should have loaded the documents you wish to save on ProFile before bringing your system to the dealer for installation of the retrofit hardware. If you are performing the retrofit yourself) the procedure for saving your documents is described in appendix 1 at the end of this docurrent. This process takes anywhere from ten minutes to tVJlO hours, depending on the arrount of data you wish to save. 3) Had the upgrade hardware installed? The dealer typically performs this part of the upgrade. If you have received this kit without access to a dealer t you can perform the upgrade following the procedures in appendix 2 at the end of this document. This process takes about one-half hour. 4) Purchased enough micro diskettes to contain the documents you wish to save? The procedure requires that the user purchase enough microdiskettes to carry all of the customer's data files saved on the ProFile. This would be a maximum of eight for each ProFile; two are included with the kit. Once you have completed these steps, continue with the software installation instructions on the following page. 029-0S0S-A Page 1·· Appendix 2: Lisa Z Hardware Installation The upgrade kit consists of five hardware parts) plus software: 1) micro diskette drive carrier assembly 2) Lisa 2 front panel 3) 28-pin CPU board boot ROM - high (part #341-0175) 4) 28-pin CPU board boot ROM - low (part #341-0176) 5) 24-pin I/O ROM (part 1341-0290) Software: 4 Office System micro diskettes, LisaGuide, and Applications micro diskettes Detailed descriptions of the Lisa 2 hardware upgrade procedure are given in the service procedures binder update for Lisa 2. Those procedures should be used to perform the upgrade. The process is also described below, referencing section H, "Service)" of the original Owners Guide that carne with the Lisa. The only tools required are a screwdriver for rerroval of socketed PROMs, and small wire cutters. Diagrams to supplement the Owners Guide material are given at the end of this document. 1) Remove the disk drive assembly by following the instructions on page Hi through H5 of the Lisa Owner's Guide. 2) See figure 1 at the end of this document. The disk drive cables coming from the Lisa are already fastened to the fioor or the drive compartment one on top of the oth…

More on Debugging Lisa Stack Frame Information Register US8g~ DO - D2 and An - Al DO - D3 and AD - A2 04 - 07 and A3 - A4 AS A5 A7 Can be used as user temporaries by your procedure Used for c~iler t~rarie$ Compiler uses for locals and pointers Pointer to global stack frame (for main proor.-) Pointer to current local stack frame (current procedure) Pointer to the top of stack (Supervisor if domain • 0 otherwise user) 4 bYte pointers ::::::::::::::::::::::::::::;:::::::::::::::::::::::::::::::::::;:::::::::::::::::::::: one entry for each intrinsic ...ut, each entry : address of start of intrinsic glOO4l variables for that intrinsic ...i t. Global~ Stack Frame: I :::.~~~..~.J~.~.~~:.:: i!ill~it;I,~Z;illi!1 ::::::::::::Size of table depends on ::::::::::::: :::::::~I"of";""""""'in""""""""'r":':':~j{ ·...·..............J~ .....~.P..~..... : : : : : :; : ;: : ;: : : : : : : : : : : : : : : : : : : : ....................................................................................... ~aCk grows down from high address to low address Hij\ Address . . fixed Size <loader info abOUt .-re ~s are) Data Pu • e (512 bytes" up to 128 inuins1c "'its) Shared nain (GlObal) ParMS, 256 bYtes, WlteA use fmDOO--~~~~----~~~~----~~--~------~ AS _---t..1-__Pl'...;..,;;..iv...;,.au_tlain....;.;;,..·_(~G.;;;.;loba..;;..;;..;;.;l;..). ;. PIt.; . ; .,.,; ; aRS..; ;.;,.-".;;;.;2S6;...;....;;;bytes~;.;.,,_sys~teR~.;;;.;use~---f, nain progrM GlODalS Link A5#'" .. ~----------------~----------~------~. Regular lMi t Q1Gbals COMon Size ~------~----~~~--------~~----~ ~ ____--.__t--I_ntr __ inS1_·c_tm __"t_Gl_obal __S_.....---'I. . .~_-t>: SuR of Areas Referenced > > L.jtu:um ofT orO(Jl'lS ffffffff flOll A5 InclUdes regular wU t MthOd slice tables ~ncludes intrinsic Wlit Rethod slice tables 32K ... for Nib CORbined Local Stack Frame (usual case}: Hi. Address fWlCtion Result (0. 2 or ~ bytes) Par_ters (I bytes CleDendina on DIl_ter list) oor ~ I.lSt 7it...., is VIIiIYS SEI.F i' tJu~ SUtic Link (For local Drocs only.. Fra. proc defined inl Return Address 00 procedure that called this procedure) Old AI (fl_ Of proceGlre that called this proceGlre) Local variables of this procedure CoRpiler T~ries for this procedUre .. • AI (StICk rr inStlCk cr.l) is , &l1SC1J Mt/I()(/. ~ 4 Link Ai••... >~e$ • AT first Par_ter list Para.tU' Low ACldress Parameter Information: sed for PllaMtric Procedures Met Fen:tions: Address of procedUre body • Static Link. valCJe = 0 if this is not a local, procedure ~ Stack Frame of TSamVie.,MousePreSSj A7 ~ Defore cal1 to Hi" Address Address Of IIOUSeLPT IIoUSePress SElf Return Addless (To procedure that called JIOUSePress) Old AI (fr. . of procedure that called this procedure) COpied local Yenion Of - ~ AI5 (StICk f r. . in Stack Cr.l) A7- __LPT ,.tlMtar Nne1 pidcSelecUcrt ,ictce&lJox stcetchSelection 1heKind 4 • •• I ~~e • During JIOUSePras Local VlIilbln Stack Area loll Address Local Vari…