ToCSLDateAugust9,1984FromMikeKupferLocationPARCSubjectHowtocompileAlpineOrganizationCSLXEROXCamefrom/Indigo/Alpine/Release52/Doc/HowToCompileAlpine.tiogaLasteditedbyMBrownonFebruary12,198410:31:23pmPSTLasteditedbyKupferonAugust9,19844:45:03pmPDTAbstractThismemotellshowtorebuildAlpine'sbcdsfromtheirCedarsources.Itisimplementordocumentation;consulttheadministratordocumentationforinstructiononhowtostartupaserver,usingthenewbcds.CedarreleasedirectoryThedffilesmentionedbelowallcontainimportsfromtheCedar5.1andCedar5.2directories.BecausethisdirectorynowchangeswitheachCedarrelease,thesedffileswillhavetobehand-editedwitheachCedarrelease.Weuse"c"todenote"thecurrentreleasedirectoryfortheDFfileinquestion."TheAlpineserverimplementationsToestablishcontext,%CD///AlpineRelease/--thenameisuptoyou%Bringover/Indigo/Alpine/Release52/Top/AlpUmbrella.Alpinehasfivepublicinterfaces,i.e.interfacesforremoteaccessfromworkstations:AlpineTransaction,AlpineFile,AlpineVolume,AlpineOwner,AlpineDebug.AlpineEnvironmentisatypes-and-constants-onlymoduleusedbyeverybody.Thepublicinterfacesmustoccasionallyberecompiled,generallyduetoCedarchanges.Mostoftentherecompilationwillnotaffecttheformatofcallsonthewire,hencewillnotrequiretheclientimplementationsoutintheworldtochange.Veryoccasionallythepublicinterfaceswillchangeinanincompatibleway,ashappenedrecentlywhenthesizeofFileIDschanged.Thenyoumustnotonlyrecompile,butchangetheversionstampontheinterfaceanddistributenewclientsoftwaretotheworld.YouchangetheversionstampbyeditingAlpineRemoteExportImpl.YouincrementeachhalfofAlpineRemoteExportImpl.versionbyone,thensavethefile.Ifyouarerecompilingthepublicinterfaces,youmustbesurethatthebcdsofthesamenames(AlpineEnvironment.bcd,AlpineFile.bcd,etc)donotexistintherootdirectory;otherwiseLupinewillbecomeconfused.Thenpï_/îâqï_/ï_/î8pï_/î-äqï_/î89î<÷î>„pï[Sîâqï[Sî8îÖpï[Sî-äqï[Sî89pïWwîâqïWwî8î•îCî#zpïWwî-ä qïWwî89rïOçîqsïIPîâîBtïIPî¢ð5sïG©îâîwtïG©î¢îžîcî jî&gî(¤î+êî1„î3ùsïFîâîwtïFî¢îžîtîzî$8î%Åî) î-ôî0isïB³îâtïB³î¢î«îÓî ¥î#˜î%6î)îî/?î2`î5¶î8ëî<óïA îâî½î� î î%Zî*|î-@ î6 î?áï?dîâ î½îÃîÈîvî†î!˜î"Âî'&î*Ðî-0î0uï<îâîäî€qï8Æî¤îRîîî²îcî#Gî% î)Ãî.¥î1âî4î9¿î·ï$îâ î¢î%Ê î.U î9> ï"sîâ î§î%)î&Åî(î7†î<¶î@"ï Ëîâ ïPî¤î…îÉ îýî"o î*î, î3œî9Œîï©îâî5îäî�î" î'üî*Íî-hî1Yî3Þî8î:^î=’î?¾ïîâîPîNîî{î Jî"±î&wî0áî3]î5î7wî;iî=ïZîâîŽ î~î.î!¸ î(2î+.î0&î2$î4d î<ðî@pï³îâîmî×îÀî!Sî$2î&î+Qî2î5Õî8Àî<\î?ï îâ î¦î3îæîQî$$î(=î*Oî,ºî2kî5. î;dî>^ïdîâî[î îiïéî¤îîî¸î!Ôî&6î(†î-wî?ïBîâîYîŠîWîî1¾î3ºî6¾î9äî<èî?Gï Çî¤î'îàî6 îÍî"/î&k î,ïî/¨î3î5î8î:Ðî=2î@eï îâîeîîlî)3î3î5Øî8î:šî=íî?¾ï xîâîÐ îîEî#î%¹î*Ïî1}ûTVm$áCSLNotebookTopic2%Bringover-p/Indigo/c/Top/Lupine%AddDebugSearchRule///AlpineRelease/--tohelpLupine%AlpExportsCompileExports.Torebuildtheserverimplementations,whetherornotyouhaverecompiledthepublicinterfaces,%MakeAlpineInternals.ItispossiblethatMakeDo,invokedinsideMakeAlpineInternals,willcomplainaboutasyntaxerrorineitherLogMapImpls.ConfigorFilePageMgrImpls.Config.Thisisacceptable,aslongasAlpineCommonImpls.bcdandAlpineServerImpls.bcdactuallygetrebuilt.Whenyouaredone,%SModelAlpUmbrella%VerifyAlpine--"VerifyDFAlpUmbrella"doesnotworkverywell%Delete*!*--cleanupthescratchdirectorySeethecommentsinAlpUmbrella.df;theyexplainhowtorebuildasingleAlpineconfigurationwithoutrebuildingeverythingelse.TheAlpineclientimplementationsIfyouhavejustrecompiledtheserverimplementations,besuretoSModelthembeforebuildingtheclientimplementations.Toestablishcontext,%CD///AlpineClientRelease/--thenameisuptoyou%Bringover/Indigo/Alpine/ClientRelease50/Top/AlpUser.Torebuildtheclientimplementations,%AlpUserCompileExports;AlpUserCompileInternals.Whenyouaredone,%SModelAlpUser%VerifyDFAlpUser%Delete*!*--cleanupthescratchdirectoryAlpineandtheCedarreleaseTheproceduresaboveonlywritefileson/Indigo/Alpine/.Wereleaseonlytheclientsoftwareto/Indigo/Cedar*.*/.Unfortunately,notallclientsoftwareiscontrolledbyAlpUser.df:thepublicinterfacesbelongtoAlpUmbrella.Thismeansthataseparatedffile,AlpineUser.df,isrequiredfortherelease.Asafewaytoproceedisasfollows:%CD///AlpineCedarRelease/--thenameisuptoyou%Bringover/Indigo/Alpine/Release52/Top/AlpUmbrella%Bringover/Indigo/Alpine/ClientRelease50/Top/AlpUser%Open/Indigo/c/Top/AlpineUser.df%--noweditittopointtothenextreleasedirectory,sayCedar5.2,andsave%SModelAlpineUser%VerifyDFAlpineUserxïfåî"Žî&oî.yïfåîEÉqï_&îî‘îñîµvî!÷ï_&qï_&î#Y ï]îî‘î"wî.Ñï]ï]î/Jî0Hî1íî4Üqï[×îî‘î%€ïY\î¤î»îuîÅîÃî)nî.­î0aî2Çî5oî8¦ î?¾ïWµîâî ïU:îî‘î!ªïR¿î¤îîŒîÐî¡î"¶î'úî+ÿî9rî< ïQîâîóîLîÀîaî?î"Zî/äî1×ïOpîâîî€ î•îOîuî!0î1-î3ðïMÉîâîøîAïKMî¤î¼îsîÆïHÒîî‘î½ ïG+îî‘ wîPïG+ïG+îÉîÇî% î.5î19î3�î7î9èqïEƒîî‘î÷wîÚïEƒïEƒîSîQî Ýî"Îî%î)ºqïCî¤îrî îÎîµî*Yî-¡î2­î5éî7Ïî<Ñî>3ïAaîâîh îÚî æ î'Š î.Nuï>îâî»î îÓqï:Ãî¤îZîFîÂî˜ î#õî&‰î*Ëî5»î7àî;î<òï9îâîkîºî4î“î"Tï6¡î¤îËîeï4%îî‘î2wî'#ï4%ï4%î'œî(šî*æî.Šî/öî1çî3Œqï2~îî‘îñð*î7¸ï0î¤îËî”îóî´ï-ˆîî‘î$5î4ï+ î¤î¼îsîÆï(‘îî‘î½ï&êîî‘îÐï%Bîî‘î÷wîÚï%Bï%BîSîQî Ýî"Îî%î)ºuï!óîâî0îÐî/î1qï¥î¤îj î`îQî"Yî%Æî(¢î*—î5Èî8Aî<¶î?¾ïýîâîùîÊîÏî( î1·î4ƒî6Ëî:âî@²ïVîâ î[îN îÙî!/î%a î+‚î/ÿî1¤ î:Éî=Úï¯îâî°îÚî2î÷î¹ î%ûî'gî,÷î/4î1”ï3î¤î0îýîÕîƒî»î!&î"Ôï¸îî‘î2wî'ï¸ï¸î'‘î(�î*Ûî.î/ëî1Üî3�qïîî‘îñð(ïiîî‘îñð*ïÂîî‘î\vîžïÂqïÂîÿïîwî‘ïïî îîãî†îÝî‚î!ùî#žî%êî(ÿî-p î3dî5Ãî;Öî>yqï sîî‘î½ ï Ìîî‘îÐ §TVm$±CSLNotebookTopic3%Del*!*--cleanupthescratchdirectoryCaveatHavingnotworkedwiththeclient-sidesoftware,Iamnot100%convincedthatwhatisdescribedabovewillwork.Inparticular,Idon'tknowwhethermyrecentchangestotheserversoftwarewillaffectmakingnewclientBCD's.Also,Ibelievethatifyouchangeanyofthepubliclyexportedinterfaces(AlpineTransaction,etc.),thenyoumustfixAlpUser.dfbeforeyouBringitOver(otherwiseitbringsovertheoldversion,right?).xïfåî"Žî&oî.yïfåîEÉqï_'îî‘î=wî ï_'ï_'î™î—î#î!î#aî(uï[ØîâqïX‰î¤îqîßîÂî Öî#/ î)µî/€î0�î2Îî5<î8Ôî?PïVâîâîLîÅîýî î Åî%8î' î-°î.Åî2gî63î;Žî=úïU;îâî îºîî#î!šî$Dî(î,õî/âî3¡î8ßîÁïQìîâîî¯îî î!,î%sî("î+åî-3î0� î78î8†î<¬î?¾ïPEîâîLîl¦TVm$Í ÿ HELVETICAþŸÿ TIMESROMANþYÿ TIMESROMANþŸÿMATHþŸÿ TIMESROMANþŸÿLAURELþŸÿ HELVETICAþæÿLOGOü´ÿ TIMESROMANþŸÿ TIMESROMANþæ ú_j/�Bºÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿ3[]<>users>kupfer.pa>Alpine>HowToCompileAlpine.tioga$Thursday, August 9, 1984 4:45 pm PDT