<HTML><HEAD>
<META http-equiv=Content-Type content="text/html; charset=iso-8859-15">
<META content="MSHTML 6.00.6000.16850" name=GENERATOR></HEAD>
<BODY style="MARGIN: 4px 4px 1px">
<DIV>I thought it might be helpful to highlight some of what I've always understood as the design for the CM3 package system. So, I pulled out my old documentation from Critical Mass as reference. </DIV>
<DIV> </DIV>
<DIV>I offer the following information to see if this discussion thread concurs and/or wants to make any changes going forward, esp. as we prepare for a new CM3 release.</DIV>
<DIV> </DIV>
<DIV>1. CM3 takes care to separate source and derived files because doing so (a) isolates source files for backup, revision control, and searching; and (b) enables sharing the same source tree across operating systems and architectures, without confusing object files from different platforms.</DIV>
<DIV> </DIV>
<DIV>2. Each package resides in a directory, with sources in a source subdirectory ("src"), and generated files in a derived subdirectory named to denote the platform on which the sources were built, e.g., "ALPHA_OSF", "HPPA", "NT386", "SPARC", etc.</DIV>
<DIV> </DIV>
<DIV>3. Each developer can have multiple private packages, each stored wherever desired in the filesystem. A private package named "foo" would have the following filesystem structure:</DIV>
<DIV>
<DIV><FONT face="Courier New"> +---foo</FONT></DIV>
<DIV><FONT face="Courier New"> | +---src</FONT></DIV>
<DIV>
<DIV><FONT face="Courier New"> | +---NT386</FONT>
<DIV><FONT face="Courier New"> | +---HPPA</FONT>
<DIV><FONT face="Courier New"> | \---(...)</FONT></DIV></DIV></DIV></DIV></DIV>
<DIV> </DIV>
<DIV>4. For each CM3 installation, there is one public package repository that is available to all developers. When you ship a [private] package, you make that package available to other packages (and developers) via this public package repository. The idea is that as a developer you would test your package in your private repository before shipping it to the public repository. (Sometimes m3overrides were needed when testing several related private packages before shipping them.) </DIV>
<DIV> </DIV>
<DIV>5. A typical CM3 installation is rooted at a given point in the file system and contains the following folder structure:</DIV>
<DIV><FONT face="Courier New"> CM3</FONT></DIV>
<DIV><FONT face="Courier New"> +---bin</FONT></DIV>
<DIV><FONT face="Courier New"> +---doc</FONT></DIV>
<DIV><FONT face="Courier New"> | +---help</FONT></DIV>
<DIV><FONT face="Courier New"> | +---pics</FONT></DIV>
<DIV><FONT face="Courier New"> | +---reference</FONT></DIV>
<DIV><FONT face="Courier New"> | +---src_reports</FONT></DIV>
<DIV><FONT face="Courier New"> | \---tutorial</FONT></DIV>
<DIV><FONT face="Courier New"> +---examples</FONT></DIV>
<DIV><FONT face="Courier New"> +---lib</FONT></DIV>
<DIV><FONT face="Courier New"> +---pkg</FONT></DIV>
<DIV><FONT face="Courier New"> | +---bitvector</FONT></DIV>
<DIV><FONT face="Courier New"> | | +---src</FONT></DIV>
<DIV>
<DIV><FONT face="Courier New"> | | +---NT386</FONT>
<DIV><FONT face="Courier New"> | | +---HPPA</FONT>
<DIV><FONT face="Courier New"> | | \---(...)</FONT></DIV></DIV></DIV></DIV>
<DIV>
<DIV><FONT face="Courier New"> | +---cm3ide</FONT></DIV>
<DIV><FONT face="Courier New"> | | +---src</FONT></DIV>
<DIV>
<DIV><FONT face="Courier New"> | | +---NT386 </FONT>
<DIV><FONT face="Courier New"> | | +---HPPA </FONT>
<DIV><FONT face="Courier New"> | | \---(...)</FONT></DIV></DIV></DIV></DIV></DIV>
<DIV>
<DIV>
<DIV><FONT face="Courier New"> | +---(...)</FONT></DIV>
<DIV><FONT face="Courier New"> | | +---src</FONT></DIV>
<DIV>
<DIV><FONT face="Courier New"> | | +---NT386 </FONT>
<DIV><FONT face="Courier New"> | | +---HPPA </FONT>
<DIV><FONT face="Courier New"> | | \---(...)</FONT></DIV>
<DIV> </DIV></DIV></DIV></DIV></DIV>6. In the past, the environment variable INSTALL_ROOT pointed to the root of the CM3 tree in the file system. I think this variable is ambiguously named and that we should change it to CM3_INSTALL_ROOT. Using this approach, if one had multiple CM3 installations (perhaps for different releases), one would simply need to change the CM3_INSTALL_ROOT variable to point to the desired installation for use at any particular point in time. For this to work, all other variables cue off of CM3_INSTALL_ROOT. I know that for the old cm3.cfg file, this was indeed the behavior. Then, if someone had a special situation, they could override the "cueing" behavior for any particular variable simply by changing its definition on the fly.</DIV>
<DIV> </DIV>
<DIV>7. Now, I also understand some (but not all) of what Jay is saying about the library paths. Back in the old cm3 v4.1 days, I had both HPPA and NT386 derived files for the same set of sources. For Windows, the shipped exe and dll files went into the public repository and you needed to have the CM3/bin folder on your path. For private exe and dlls, you typically just ran them out of the private package's derived NT386 folder. On HPPA, there were some places in the file system that contained static libraries and shared libraries, plus then you had the libraries built using CM3. Again, the CM3 libraries went to the public repository and there were environment variables to facilitate finding the rest, including LD_LIBRARY_PATH. Now, from what Jay is saying, the variety of operating environments seems to cloud up all this. I know I'm a bit rusty wrt all the various unix variants out there, but I recall that v4.1 worked out-of-the-box for both NT386 and HPPA with respect to all this library path stuff and I didn't have to make any symbolic links nor any hard links to make it work. IMO, links are bad and too easily broken.</DIV>
<DIV> </DIV>
<DIV>8. As for "build_standalone", I know there are various build/bootstrap reasons why some parts of CM3 had to be built this way. But, for me, I've often used this feature for utility-type programs to make it easier to distribute them. I can simply distribute the one executable file without having to worry that the target system might not have the right DLLs or the right shared libraries in the right locations. For production code, I've always built an installation program or an installation script that installed all my executables and shared libraries in a folder structure rooted at a particular point chosen by the end user. Then, my programs always launched and used relative paths from the install location to find everything they needed.</DIV>
<DIV> </DIV>
<DIV>Hope this info is helpful.</DIV>
<DIV> </DIV>
<DIV>Regards,</DIV>
<DIV>Randy Coleburn</DIV>
<DIV> </DIV></BODY></HTML>