| 1 | For the most part, third-party software is easy to locate because it |
|---|
| 2 | is found in the third hierarchy. Nevertheless, it's a good idea to |
|---|
| 3 | keep track of what we get from outside, especially for things outside |
|---|
| 4 | of third. There are also some notes at the end of this file on how we |
|---|
| 5 | deal with building third-party software. |
|---|
| 6 | |
|---|
| 7 | Third-party stuff not under third |
|---|
| 8 | --------------------------------- |
|---|
| 9 | |
|---|
| 10 | * athena/etc/xlogin/bitmaps/menu16 |
|---|
| 11 | |
|---|
| 12 | This is from the X11 release; it probably never |
|---|
| 13 | changes. We have a copy of it here because xlogin |
|---|
| 14 | needs all its bitmaps locally in /etc/athena/login, |
|---|
| 15 | and fetching it out of the vendor X distribution at |
|---|
| 16 | build time is contrary to principles. |
|---|
| 17 | |
|---|
| 18 | * packs/build/autoconf/ |
|---|
| 19 | |
|---|
| 20 | The files in this directory are copied from |
|---|
| 21 | third/autoconf and used by do.sh. |
|---|
| 22 | |
|---|
| 23 | * packs/config/named.root |
|---|
| 24 | |
|---|
| 25 | This is a copy of the named.root file available at |
|---|
| 26 | rs.internic.net:/domain/named.root. |
|---|
| 27 | |
|---|
| 28 | * packs/config/Dash.fallback |
|---|
| 29 | |
|---|
| 30 | A fallback copy of |
|---|
| 31 | /afs/athena.mit.edu/system/config/dash/Dash.menus for |
|---|
| 32 | when the master copy is inaccessible. This should be |
|---|
| 33 | updated at release time. |
|---|
| 34 | |
|---|
| 35 | * packs/dotfiles/arch/sgi_*/cshrc |
|---|
| 36 | |
|---|
| 37 | A line to set XUSERFILESEARCHPATH in .cshrc is derived |
|---|
| 38 | from a piece of the IRIX file /var/X11/xdm/Xsession.dt. |
|---|
| 39 | |
|---|
| 40 | * packs/dotfiles/{README.mail,dot.cshrc,dot.login,dot.logout, |
|---|
| 41 | dot.mh_profile,welcome} |
|---|
| 42 | |
|---|
| 43 | These should be kept in sync with the copies on |
|---|
| 44 | moira's local disk (/moira/dotfiles/*), which are |
|---|
| 45 | what actually get copied into new home directories. |
|---|
| 46 | |
|---|
| 47 | * Modified operating system files |
|---|
| 48 | |
|---|
| 49 | We keep some modified configuration files from the |
|---|
| 50 | operating systems we use in the os and arch |
|---|
| 51 | subdirectories of packs/config and packs/maint. |
|---|
| 52 | The files and their origins are: |
|---|
| 53 | |
|---|
| 54 | Solaris files in packs/config: |
|---|
| 55 | |
|---|
| 56 | Athena4.kt /usr/openwin/share/etc/keytables/US4.kt.Z |
|---|
| 57 | Athena5.kt /usr/openwin/share/etc/keytables/US_UNIX5.kt.Z |
|---|
| 58 | devlink.tab /etc/devlink.tab |
|---|
| 59 | inetd.conf /etc/inet/inetd.conf |
|---|
| 60 | inittab /etc/inittab |
|---|
| 61 | logindevperm /etc/logindevperm |
|---|
| 62 | keytable.map /usr/openwin/share/etc/keytables/keytable.map |
|---|
| 63 | minor_perm /etc/minor_perm |
|---|
| 64 | name_to_sysnum /etc/name_to_sysnum |
|---|
| 65 | nsswitch.conf /etc/nsswitch.conf |
|---|
| 66 | services /etc/inet/services |
|---|
| 67 | su /etc/default/su |
|---|
| 68 | system /etc/system |
|---|
| 69 | |
|---|
| 70 | Solaris files in packs/maint: |
|---|
| 71 | |
|---|
| 72 | nfs.client /etc/init.d/nfs.client |
|---|
| 73 | rpc /etc/init.d/rpc |
|---|
| 74 | |
|---|
| 75 | IRIX files in packs/config: |
|---|
| 76 | |
|---|
| 77 | 4DWm /usr/lib/X11/app-defaults/4DWm |
|---|
| 78 | Mwm /usr/lib/X11/app-defaults/Mwm |
|---|
| 79 | Toolchest /usr/lib/X11/app-defaults/Toolchest |
|---|
| 80 | crontab.root /var/spool/cron/crontabs/root |
|---|
| 81 | fonts.alias /usr/lib/X11/fonts/100dpi/fonts.alias |
|---|
| 82 | fonts.dir /usr/lib/X11/fonts/100dpi/fonts.dir |
|---|
| 83 | inetd.conf /etc/inetd.conf |
|---|
| 84 | services /etc/services |
|---|
| 85 | system.chestrc /usr/lib/X11/system.chestrc |
|---|
| 86 | |
|---|
| 87 | IRIX files in packs/maint: |
|---|
| 88 | |
|---|
| 89 | network /etc/init.d/network |
|---|
| 90 | |
|---|
| 91 | Distribution sites for software under third |
|---|
| 92 | ------------------------------------------- |
|---|
| 93 | |
|---|
| 94 | acme ftp.gnome.org:pub/gnome/sources/acme |
|---|
| 95 | afs-krb5 ftp.cmf.nrl.navy.mil:pub/kerberos5 |
|---|
| 96 | afsbin See below. |
|---|
| 97 | ammonite ftp.gnome.org:pub/gnome/sources/ammonite |
|---|
| 98 | aspell ftp.gnu.org:pub/gnu/aspell |
|---|
| 99 | aspell-dict ftp.gnu.org:pub/gnu/aspell |
|---|
| 100 | at-spi ftp.gnome.org:pub/gnome/sources/at-spi |
|---|
| 101 | atk ftp.gnome.org:pub/gnome/sources/atk |
|---|
| 102 | audiofile ftp.gnome.org:pub/gnome/sources/audiofile |
|---|
| 103 | autoconf ftp.gnu.org:pub/gnu/autoconf |
|---|
| 104 | bash ftp.gnu.org:pub/gnu/bash |
|---|
| 105 | bind ftp.isc.org:isc/bind/src |
|---|
| 106 | binutils ftp.gnu.org:pub/gnu/binutils |
|---|
| 107 | bison ftp.gnu.org:pub/gnu/bison |
|---|
| 108 | bonobo ftp.gnome.org:pub/gnome/sources/bonobo |
|---|
| 109 | bonobo-activation ftp.gnome.org:pub/gnome/sources/bonobo-activation |
|---|
| 110 | bonobo-conf ftp.gnome.org:pub/gnome/sources/bonobo |
|---|
| 111 | bug-buddy ftp.gnome.org:pub/gnome/sources/bug-buddy |
|---|
| 112 | bzip2 sources.redhat.com:pub/bzip2 |
|---|
| 113 | control-center ftp.gnome.org:pub/gnome/sources/control-center |
|---|
| 114 | cyrus-imapd ftp.andrew.cmu.edu:pub/cyrus-mail |
|---|
| 115 | cyrus-sasl ftp.andrew.cmu.edu:pub/cyrus-mail |
|---|
| 116 | db http://www.sleepycat.com/download.html |
|---|
| 117 | diffutils ftp.gnu.org:pub/gnu/diffutils |
|---|
| 118 | eel ftp.gnome.org:pub/gnome/sources/eel |
|---|
| 119 | emacs ftp.gnu.org:pub/gnu/emacs; see below |
|---|
| 120 | enscript ftp.gnu.org:pub/gnu/enscript |
|---|
| 121 | eog ftp.gnome.org:pub/gnome/sources/eog |
|---|
| 122 | esound ftp.gnome.org:pub/gnome/sources/esound |
|---|
| 123 | evolution ftp.gnome.org:pub/gnome/sources/evolution |
|---|
| 124 | expat http://sourceforge.net/projects/expat/ |
|---|
| 125 | fcpackage http://fontconfig.org/ |
|---|
| 126 | file-roller ftp.gnome.org:pub/gnome/sources/file-roller |
|---|
| 127 | findutils ftp.gnu.org:pub/gnu/findutils |
|---|
| 128 | flex ftp.gnu.org:pub/gnu/non-gnu/flex |
|---|
| 129 | freetype ftp.freetype.org:pub/freetype2 |
|---|
| 130 | gail ftp.gnome.org:pub/gnome/sources/gail |
|---|
| 131 | gal ftp.gnome.org:pub/gnome/sources/gal |
|---|
| 132 | gal2 ftp.gnome.org:pub/gnome/sources/gal |
|---|
| 133 | gcc ftp.gnu.org:pub/gnu/gcc |
|---|
| 134 | GConf ftp.gnome.org:pub/gnome/sources/GConf |
|---|
| 135 | GConf2 ftp.gnome.org:pub/gnome/sources/GConf |
|---|
| 136 | gconf-editor ftp.gnome.org:pub/gnome/sources/gconf-editor |
|---|
| 137 | gdbm ftp.gnu.org:pub/gnu/gdbm |
|---|
| 138 | gdk-pixbuf ftp.gnome.org:pub/gnome/sources/gdk-pixbuf |
|---|
| 139 | gedit ftp.gnome.org:pub/gnome/sources/gedit |
|---|
| 140 | gettext ftp.gnu.org:pub/gnu/gettext |
|---|
| 141 | ggv ftp.gnome.org:pub/gnome/sources/ggv |
|---|
| 142 | glib ftp.gtk.org:pub/gtk |
|---|
| 143 | glib2 ftp.gtk.org:pub/gtk |
|---|
| 144 | gmake ftp.gnu.org:pub/gnu/make |
|---|
| 145 | gmp ftp.gnu.org:pub/gnu/gmp |
|---|
| 146 | gnome-applets ftp.gnome.org:pub/gnome/sources/gnome-applets |
|---|
| 147 | gnome-core ftp.gnome.org:pub/gnome/sources/gnome-core |
|---|
| 148 | gnome-desktop ftp.gnome.org:pub/gnome/sources/gnome-desktop |
|---|
| 149 | gnome-icon-theme ftp.gnome.org:pub/gnome/sources/gnome-icon-theme |
|---|
| 150 | gnome-libs ftp.gnome.org:pub/gnome/sources/gnome-libs |
|---|
| 151 | gnome-media ftp.gnome.org:pub/gnome/sources/gnome-media |
|---|
| 152 | gnome-mime-data ftp.gnome.org:pub/gnome/sources/gnome-mime-data |
|---|
| 153 | gnome-panel ftp.gnome.org:pub/gnome/sources/gnome-panel |
|---|
| 154 | gnome-print ftp.gnome.org:pub/gnome/sources/gnome-print |
|---|
| 155 | gnome-spell ftp.gnome.org:pub/gnome/sources/gnome-spell |
|---|
| 156 | gnome-system-monitor ftp.gnome.org:pub/gnome/sources/gnome-spell |
|---|
| 157 | gnome-terminal ftp.gnome.org:pub/gnome/sources/gnome-terminal |
|---|
| 158 | gnome-themes ftp.gnome.org:pub/gnome/sources/gnome-themes |
|---|
| 159 | gnome-utils ftp.gnome.org:pub/gnome/sources/gnome-utils |
|---|
| 160 | gnome-vfs ftp.gnome.org:pub/gnome/sources/gnome-vfs |
|---|
| 161 | gnome-vfs2 ftp.gnome.org:pub/gnome/sources/gnome-vfs |
|---|
| 162 | gnome2-user-docs ftp.gnome.org:pub/gnome/sources/gnome2-user-docs |
|---|
| 163 | gst-plugins ftp.gnome.org:pub/gnome/sources/gst-plugsin |
|---|
| 164 | gstreamer ftp.gnome.org:pub/gnome/sources/gstreamer |
|---|
| 165 | gtk ftp.gtk.org:pub/gtk |
|---|
| 166 | gtk-engines ftp.gtk.org:pub/gtk |
|---|
| 167 | gtk-thinice-engine ftp.gtk.org:pub/gtk |
|---|
| 168 | gtk2 ftp.gtk.org:pub/gtk |
|---|
| 169 | gtkhtml ftp.gnome.org:pub/gnome/sources/gtkhtml |
|---|
| 170 | gtkhtml3 ftp.gnome.org:pub/gnome/sources/gtkhtml |
|---|
| 171 | ifplugd http://0pointer.de/lennart/projects/ifplugd/ |
|---|
| 172 | imlib (Formerly www.rasterman.com; imlib 1 is dead now) |
|---|
| 173 | inetd From NetBSD (ftp.netbsd.org), usr.sbin/inetd |
|---|
| 174 | intlfonts ftp.gnu.org:pub/gnu/intlfonts |
|---|
| 175 | ispell ftp.cs.ucla.edu:pub/ispell-3.1 |
|---|
| 176 | jot From NetBSD (ftp.netbsd.org), usr.bin/jot |
|---|
| 177 | jpeg ftp://ftp.uu.net/graphics/jpeg/ |
|---|
| 178 | kermit http://www.columbia.edu/kermit |
|---|
| 179 | krb5* http://web.mit.edu/network/kerberos-form.html |
|---|
| 180 | lam From NetBSD (ftp.netbsd.org), usr.bin/lam |
|---|
| 181 | libart_lgpl ftp.gnome.org:pub/gnome/sources/libart_lgpl |
|---|
| 182 | libbonobo ftp.gnome.org:pub/gnome/sources/libbonobo |
|---|
| 183 | libbonoboui ftp.gnome.org:pub/gnome/sources/libbonoboui |
|---|
| 184 | libdaemon http://0pointer.de/lennart/projects/libdaemon/ |
|---|
| 185 | libgail-gnome ftp.gnome.org:pub/gnome/sources/libgail-gnome |
|---|
| 186 | libghttp ftp.gnome.org:pub/gnome/sources/libghttp |
|---|
| 187 | libglade ftp.gnome.org:pub/gnome/sources/libglade |
|---|
| 188 | libglade2 ftp.gnome.org:pub/gnome/sources/libglade |
|---|
| 189 | libgnome ftp.gnome.org:pub/gnome/sources/libgnome |
|---|
| 190 | libgnomecanvas ftp.gnome.org:pub/gnome/sources/libgnomecanvas |
|---|
| 191 | libgnomeprint ftp.gnome.org:pub/gnome/sources/libgnomeprint |
|---|
| 192 | libgnomeprintui ftp.gnome.org:pub/gnome/sources/libgnomeprintui |
|---|
| 193 | libgnomeui ftp.gnome.org:pub/gnome/sources/libgnomeui |
|---|
| 194 | libgtkhtml ftp.gnome.org:pub/gnome/sources/libgtkhtml |
|---|
| 195 | libgtop ftp.gnome.org:pub/gnome/sources/libgtop |
|---|
| 196 | libiconv ftp.gnu.org:pub/gnu/libiconv |
|---|
| 197 | libIDL ftp.gnome.org:pub/gnome/sources/libIDL |
|---|
| 198 | libole2 ftp.gnome.org:pub/gnome/sources/libole2 |
|---|
| 199 | libpng swrinde.nde.swri.edu:pub/png/src |
|---|
| 200 | librep librep.sourceforge.net:pub/librep |
|---|
| 201 | librsvg ftp.gnome.org:pub/gnome/sources/librsvg |
|---|
| 202 | libsoup ftp.gnome.org:pub/gnome/sources/libsoup |
|---|
| 203 | libungif prtr-13.ucsc.edu:pub/libungif |
|---|
| 204 | libwnck ftp.gnome.org:pub/gnome/sources/libwnck |
|---|
| 205 | libxml ftp.gnome.org:pub/gnome/sources/libxml |
|---|
| 206 | libxml2 ftp.gnome.org:pub/gnome/sources/libxml |
|---|
| 207 | libxslt ftp.gnome.org:pub/gnome/sources/libxslt |
|---|
| 208 | libzvt ftp.gnome.org:pub/gnome/sources/libzvt |
|---|
| 209 | linc ftp.gnome.org:pub/gnome/sources/linc |
|---|
| 210 | look From NetBSD (ftp.netbsd.org), usr.bin/look |
|---|
| 211 | lprng ftp.astart.com:pub/LPRng; see below |
|---|
| 212 | m4 ftp.gnu.org:pub/gnu/m4 |
|---|
| 213 | mdoc From NetBSD (ftp.netbsd.org), share/tmac |
|---|
| 214 | medusa ftp.gnome.org:pub/gnome/sources/medusa |
|---|
| 215 | metacity ftp.gnome.org:pub/gnome/sources/metacity |
|---|
| 216 | mingetty ftp.gnome.org:pub/gnome/sources/mingetty |
|---|
| 217 | mozilla ftp.mozilla.org:pub/mozilla.org/mozilla/releases |
|---|
| 218 | nautilus ftp.gnome.org:pub/gnome/sources/nautilus |
|---|
| 219 | nautilus-media ftp.gnome.org:pub/gnome/sources/nautilus-media |
|---|
| 220 | nmh ftp.math.gatech.edu:pub/nmh |
|---|
| 221 | nvi http://www.bostic.com/vi/ |
|---|
| 222 | oaf ftp.gnome.org:pub/gnome/sources/oaf |
|---|
| 223 | openafs http://www.openafs.org/release |
|---|
| 224 | openmotif http://www.opengroup.org/openmotif |
|---|
| 225 | openssh ftp.openbsd.org:pub/OpenBSD/OpenSSH |
|---|
| 226 | openssl ftp.openssl.org:source |
|---|
| 227 | ORBit ftp.gnome.org:pub/gnome/sources/ORBit |
|---|
| 228 | ORBit2 ftp.gnome.org:pub/gnome/sources/ORBit2 |
|---|
| 229 | pango ftp.gnome.org:pub/gnome/sources/pango |
|---|
| 230 | patch ftp.gnu.org:pub/gnu/patch |
|---|
| 231 | pcre ftp.sourceforge.net:pub/sourceforge/pcre |
|---|
| 232 | perl ftp.cpan.org:pub/CPAN/src |
|---|
| 233 | pine ftp.cac.washington.edu:pine |
|---|
| 234 | ftp.cac.washington.edu:mail/kerberos4-patches.tar.Z |
|---|
| 235 | pkgconfig http://www.freedesktop.org/software/pkgconfig.html |
|---|
| 236 | popt ftp.rpm.org:pub/rpm/dist/rpm-4.0.x |
|---|
| 237 | rcs ftp.gnu.org:pub/gnu/rcs |
|---|
| 238 | read-edid http://web.onetel.net.uk/~elephant/john/programs\ |
|---|
| 239 | /linux/read-edid/ |
|---|
| 240 | readline ftp.gnu.org:pub/gnu/readline |
|---|
| 241 | redhat-fonts See README file contained within |
|---|
| 242 | rep-gtk rep-gtk.sourceforge.net:pub/rep-gtk |
|---|
| 243 | rpm ftp.rpm.org:pub/rpm/dist |
|---|
| 244 | rs From NetBSD (ftp.netbsd.org), usr.bin/rs |
|---|
| 245 | sawfish sawmill.sourceforge.net:pub/sawmill |
|---|
| 246 | scrollkeeper ftp.gnome.org:pub/gnome/sources/scrollkeeper |
|---|
| 247 | sed ftp.gnu.org:pub/gnu/sed |
|---|
| 248 | sendmail* ftp.sendmail.org:pub/sendmail |
|---|
| 249 | soup ftp.gnome.org:pub/gnome/sources/soup |
|---|
| 250 | ssh* ftp.cs.hut.fi:pub/ssh |
|---|
| 251 | startup-notification ftp.gnome.org:pub/gnome/sources/startup-notification |
|---|
| 252 | sysinfo http://www.magnicomp.com/ |
|---|
| 253 | talk From NetBSD (ftp.netbsd.org) |
|---|
| 254 | usr.bin/talk goes in the talk subdirectory |
|---|
| 255 | libexec/talkd goes in the talkd subdirectory |
|---|
| 256 | protocols/talkd.h is from include/protocols, |
|---|
| 257 | with some modifications for portability. |
|---|
| 258 | tcp_wrappers* ftp.porcupine.org:/pub/security |
|---|
| 259 | tcsh ftp.astron.com:pub/tcsh |
|---|
| 260 | tetex ctan.tug.org:tex-archive/systems/unix/teTeX |
|---|
| 261 | texinfo ftp.gnu.org:pub/gnu/texinfo |
|---|
| 262 | tiff ftp.remotesensing.org:pub/libtiff |
|---|
| 263 | top ftp.groupsys.com:pub/top |
|---|
| 264 | traceroute ftp.ee.lbl.gov (top level) |
|---|
| 265 | transcript From Adobe |
|---|
| 266 | vte ftp.gnome.org:pub/gnome/sources/vte |
|---|
| 267 | wcl ftp.x.org:contrib/devel_tools |
|---|
| 268 | (seems to have disappeared; older versoins than |
|---|
| 269 | what we have are available in R5contrib) |
|---|
| 270 | whois From NetBSD (ftp.netbsd.org), usr.bin/whois |
|---|
| 271 | x11-ssh-askpass http://www.pobox.com/~jmknoble/software/x11-ssh-askpass |
|---|
| 272 | x3270 ftp.x.org:contrib/applications |
|---|
| 273 | xalf http://www.lysator.liu.se/~astrand/projects/xalf/ |
|---|
| 274 | xmh From X11R5 |
|---|
| 275 | xml-i18n-tools ftp.gnome.org:pub/gnome/sources/xml-18n-tools |
|---|
| 276 | xntp ftp.udel.edu:pub/ntp/ntp4 |
|---|
| 277 | xpm ftp.x.org:contrib/libraries |
|---|
| 278 | xscreensaver http://www.jwz.org/xscreensaver/ |
|---|
| 279 | yelp ftp.gnome.org:pub/gnome/sources/yelp |
|---|
| 280 | zlib ftp.info-zip.org:pub/infozip/zlib |
|---|
| 281 | |
|---|
| 282 | PGP Signatures |
|---|
| 283 | -------------- |
|---|
| 284 | |
|---|
| 285 | The (*)ed packages above come PGP-signed. Note that some packages have |
|---|
| 286 | signatures of the .tar.gz files, and others have signatures of the .tar |
|---|
| 287 | files themselves even though you can only download the .tar.gz files. |
|---|
| 288 | |
|---|
| 289 | Local copies of the PGP signing keys, are kept in doc/pgpkeys. You can |
|---|
| 290 | add them to your PGP keyring by doing: |
|---|
| 291 | |
|---|
| 292 | pgp -ka pgpkeys [PGP 2.6] |
|---|
| 293 | pgpk -a pgpkeys [PGP 5] |
|---|
| 294 | |
|---|
| 295 | And you can verify the signature of a package with |
|---|
| 296 | |
|---|
| 297 | pgp sigfile [PGP 2.6] |
|---|
| 298 | pgpv sigfile [PGP 5] |
|---|
| 299 | |
|---|
| 300 | (You will be prompted for the name of the file to compare the |
|---|
| 301 | signature against.) |
|---|
| 302 | |
|---|
| 303 | AFS Binaries |
|---|
| 304 | ------------ |
|---|
| 305 | |
|---|
| 306 | AFS binaries are placed under arch/<architecture name> for each |
|---|
| 307 | architecture. For each platform, you should do an import of the |
|---|
| 308 | "include" and "lib" directories of the dest tree, using the vendor tag |
|---|
| 309 | "transarc" and a release tag like "afs-3_4a_patches_2". For "lib", |
|---|
| 310 | you will have to use the options "-kb -I \!". At the top level, you |
|---|
| 311 | should have afsd, fs, tokens, unlog, and possibly afs.rc; we don't |
|---|
| 312 | bother with "cvs import" for these files. You will also need the |
|---|
| 313 | kernel module itself, which varies per platform. |
|---|
| 314 | |
|---|
| 315 | LPRng |
|---|
| 316 | ----- |
|---|
| 317 | |
|---|
| 318 | We import three packages: the LPRng sources themselves |
|---|
| 319 | (LPRng/LPRng-x.tgz) into third/lprng/lprng, the LPRng documentation |
|---|
| 320 | (LPRng/LPRng_DOC-x.tgz) into third/lprng/doc, and the ifhp filter |
|---|
| 321 | (FILTERS/ifhp-x.tgz) into third/lprng/ifhp. |
|---|
| 322 | |
|---|
| 323 | Emacs |
|---|
| 324 | ----- |
|---|
| 325 | |
|---|
| 326 | LEIM (Library of Emacs Input Methods) is built as part of Emacs, but |
|---|
| 327 | distributed separately. Untar both emacs and leim (leim will untar |
|---|
| 328 | into emacs-xx.yy/leim) and import them both with one command. |
|---|
| 329 | |
|---|
| 330 | Emacs is distributed with .elc files. When you import new versions of |
|---|
| 331 | emacs, do so with the "-I \!" option to prevent CVS from ignoring |
|---|
| 332 | these files. .elc files should be tagged as binary, using "cvs admin |
|---|
| 333 | -kb", although that's not terribly critical to Unix CVS clients |
|---|
| 334 | (except for the vc-mode files). |
|---|
| 335 | |
|---|
| 336 | Elisp source related to vc-mode needs to be set to "-ko" mode to |
|---|
| 337 | prevent expansion of those keywords. Use "cvs admin -ko" on these |
|---|
| 338 | files if they move or if new ones are added. |
|---|
| 339 | |
|---|
| 340 | Third-party build systems |
|---|
| 341 | ------------------------- |
|---|
| 342 | |
|---|
| 343 | There are two avenues one can take for building third-party software: |
|---|
| 344 | |
|---|
| 345 | * You can use the native build system. |
|---|
| 346 | |
|---|
| 347 | * You can declare the native build system a loss, and use one |
|---|
| 348 | of the two Athena build systems described in the file |
|---|
| 349 | "build-system" in this directory. This option is not |
|---|
| 350 | preferred, but is necessary in cases like afsbin (where we |
|---|
| 351 | are simply installing target files) or software imported |
|---|
| 352 | from NetBSD. |
|---|
| 353 | |
|---|
| 354 | In a some cases, the native build system may already conform to the |
|---|
| 355 | Athena build system (a configure script which needs no special options |
|---|
| 356 | for the Athena environment besides those given in our config.site |
|---|
| 357 | file), but generally you will have to write either a configure.athena |
|---|
| 358 | or a Makefile.athena file specifying how to build and install the |
|---|
| 359 | program. |
|---|
| 360 | |
|---|
| 361 | configure.athena is used when the package builds and installs |
|---|
| 362 | normally, but needs to have extra options passed to configure (or has |
|---|
| 363 | a configure script which isn't named "configure", or needs additional |
|---|
| 364 | steps performed before or after the configure script). |
|---|
| 365 | |
|---|
| 366 | Makefile.athena is needed if the package needs to do anything unusual |
|---|
| 367 | at any of the other steps. A Makefile.athena must have the following |
|---|
| 368 | targets: |
|---|
| 369 | |
|---|
| 370 | prepare Prepare to build the source tree |
|---|
| 371 | clean Remove files generated by the all target |
|---|
| 372 | all Generate all automatically build files |
|---|
| 373 | check Perform automatic tests, if any |
|---|
| 374 | install Install the software in $SRVD. |
|---|
| 375 | |
|---|
| 376 | A Makefile.athena file may rely on the following environment variables |
|---|
| 377 | (it is most robust to use `"$$VARNAME"' instead of `"${VARNAME}"' in |
|---|
| 378 | rules to get the value of such variables): |
|---|
| 379 | |
|---|
| 380 | ATHENA_SYS Architecture name for this system |
|---|
| 381 | HOSTTYPE Platform name for this system |
|---|
| 382 | SRVD Install destination directory (e.g. /srvd) |
|---|
| 383 | SOURCE Source tree (e.g. /mit/source) |
|---|
| 384 | COMPILER Appropriate compiler/linker for this system |
|---|
| 385 | CONFIGDIR Location of Athena Imake templates |
|---|
| 386 | XCONFIGDIR Location of X-style Imake templates |
|---|
| 387 | ATHTOOLROOT Root of installed Athena tree |
|---|
| 388 | |
|---|
| 389 | Following is a sample Makefile.athena file, used to build a package |
|---|
| 390 | which uses an X-style Imakefile: |
|---|
| 391 | |
|---|
| 392 | # $Id: $ |
|---|
| 393 | |
|---|
| 394 | SHELL=/bin/sh |
|---|
| 395 | |
|---|
| 396 | prepare: |
|---|
| 397 | imake "-I$$XCONFIGDIR" -DUseInstalled "-DSRCDIR=$$SOURCE" |
|---|
| 398 | ${MAKE} Makefiles |
|---|
| 399 | |
|---|
| 400 | clean: |
|---|
| 401 | ${MAKE} clean |
|---|
| 402 | |
|---|
| 403 | all: |
|---|
| 404 | ${MAKE} includes depend all |
|---|
| 405 | |
|---|
| 406 | check: |
|---|
| 407 | |
|---|
| 408 | install: |
|---|
| 409 | ${MAKE} install DESTDIR="$$SRVD" |
|---|
