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[Sq[S8p[S-q[S89pWwqWw8C#zpWw- qWw89rOqsIPBtIP5sGwtGc j&g(+13sFwtFtz$8%) -0isBtB #%6)/?2`58<A   %Z*|-@ 6 ??d v!"'&*-00u<q8Rc#G% ).149$ % .U 9> "s %)&(7<@"  P "o *, 395" '*-h1Y38:^=?PN{ J"&w03]57w;i=Z ~.! (2+.0&2$4d <@pm!S$2&+Q258<\?  3Q$$(=*O,2k5. ;d>^d[ i!&6(-w?BYW1369<?G '6 "/&k ,/358:=2@e el)3358:=? 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%VerifyDFAlpineUserxf"&o.yfEq_&v!_&q_&#Y ]"w.]]/J0H14q[%Y\u)n.0a25o8 ?W U:!R"'+9r< QLa?"Z/1Op Ou!01-3MAKMsH G+ wPG+G+% .519379qEwEESQ "%)qCr *Y-257<>3Aah  ' .Nu> q:ZF #&*57;<9k4"T6e4%2w'#4%4%'(*./13q2~*70-$54+ s(&%Bw%B%BSQ "%)u!0/1qj `Q"Y%(*58A<?( 146:@V [N !/%a +/1 :=2 %'g,/4130!&"2w''(*./13q(i*\vqw !#%(-p 3d5;>yq s  TVm$CSLNotebookTopic3%Del*!*--cleanupthescratchdirectoryCaveatHavingnotworkedwiththeclient-sidesoftware,Iamnot100%convincedthatwhatisdescribedabovewillwork.Inparticular,Idon'tknowwhethermyrecentchangestotheserversoftwarewillaffectmakingnewclientBCD's.Also,Ibelievethatifyouchangeanyofthepubliclyexportedinterfaces(AlpineTransaction,etc.),thenyoumustfixAlpUser.dfbeforeyouBringitOver(otherwiseitbringsovertheoldversion,right?).xf"&o.yfEq_'=w _'_'#!#a(u[qXq #/ )/025<8?PVL  %8' -.2g63;=U; #!$D(,/38Q !,%s("+-30 788<?PELlTVm$ HELVETICA TIMESROMANY TIMESROMANMATH TIMESROMANLAUREL HELVETICALOGO TIMESROMAN TIMESROMAN_j/B3[]<>users>kupfer.pa>Alpine>HowToCompileAlpine.tioga$Thursday, August 9, 1984 4:45 pm PDT